讲师中心 微信公众号
AI工具推荐 视频效率加速

详解 ssl_verify_depth 指令:如何限制证书链的递归校验深度

秋丽姑娘_7631

秋丽姑娘_7631

发布时间:2026-05-15 09:55:28

|

253人浏览过

|

来源于php中文网

原创

ssl_verify_depth 控制Nginx验证客户端证书时允许的最大中间CA层数,必须配合ssl_verify_client on和ssl_client_certificate使用;默认值1仅支持根CA直签,含中间CA的链需设为2或3。

详解 ssl_verify_depth 指令:如何限制证书链的递归校验深度

ssl_verify_depth 控制的是 Nginx 在验证客户端证书(即 TLS 双向认证中对方提交的证书)时,允许向上追溯签发者证书的最大层数。它不作用于后端服务证书校验(那是 proxy_ssl_verify_depth 的职责),而是专用于 ssl_client_certificate + ssl_verify_client 场景。

它到底在验证什么

当客户端发起 mTLS 连接并提供证书时,Nginx 需确认该证书可信。可信意味着:它必须能通过一条完整、可信的签名链,最终回溯到你配置的根 CA 证书。这条链可能是:

  • 客户端证书 → 根 CA(1 层,depth = 1 即可)
  • 客户端证书 → 中间 CA → 根 CA(2 层,depth 至少为 2)
  • 客户端证书 → 中间 CA₁ → 中间 CA₂ → 根 CA(3 层,depth 至少为 3)

ssl_verify_depth 就是限制这个“→”最多能出现几次。值为 2,表示最多允许 2 级中间签发者,即整条链最多含 3 张证书(终端 + 2 中间 + 根)。

默认值为什么容易出错

默认值是 1,含义很关键:

  • depth = 0:只接受自签名证书(客户端自己当 CA)
  • depth = 1:客户端证书必须由你指定的 CA(ssl_client_certificate 所指文件中的证书)直接签发;不允许任何中间 CA

现实中,企业私有 PKI 或云厂商颁发的客户端证书,几乎都经由中间 CA 签发。若仍用默认 1,即使 CA 文件里放了根和中间证书,Nginx 也会拒绝——因为它只查一级,找不到“中间 CA 直签客户端证书”的记录,就报 certificate verify failed。

SSL Certificate Monitor
SSL Certificate Monitor

检查一个或多个域名的 SSL/TLS 证书到期时间、颁发者、协议及 SAN 信息,用于应要求检查证书、监控到期或验证 HTTPS 等场景。

下载

如何正确设置值

取值应等于证书链中中间 CA 的数量(不含根 CA):

  • 客户端证书由根 CA 直签 → 设为 1
  • 客户端证书由 1 级中间 CA 签发(该中间 CA 由根 CA 签)→ 设为 2
  • 客户端证书由 2 级中间 CA 签发(中间→中间→根)→ 设为 3

注意:ssl_client_certificate 指定的 PEM 文件中,必须包含整条信任链所需的所有中间 CA 和根 CA 证书(顺序不限,但不能缺失)。只放根 CA 是不够的。

必须配合的关键指令

单独设 ssl_verify_depth 不起作用,以下四项需同时存在且位置正确(通常在 server 块内):

  • ssl_verify_client on; —— 明确开启客户端证书强制校验
  • ssl_client_certificate /path/to/ca-chain.pem; —— 提供完整可信证书链(PEM 格式,多个证书可拼在一起)
  • ssl_verify_depth 2; —— 匹配实际链长
  • ssl_certificate /path/to/server.crt; 和 ssl_certificate_key /path/to/server.key; —— Nginx 自身的服务端证书,用于建立 TLS 连接

若漏掉 ssl_verify_client on,或 ssl_client_certificate 路径错误/不可读/内容不全,无论 depth 设多大,都会静默失败或返回 400 错误。

热门AI工具

更多
Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

小橡皮AI

一款AI工具,主要用于小橡皮一键去AI味,将机器味重的内容改得更有活人感,防止因为 AI 内容被平台打上 AI 标签,以及限流,适合需要提升相关任务效率的用户。

相关专题

更多
Uvicorn 报错与问题解决教程
Uvicorn 报错与问题解决教程

本专题汇总了Uvicorn服务器常见问题与报错解决的教程合集,涵盖启动失败、端口占用、模块导入错误、事件循环冲突及热重载失效等典型故障的排查思路。同时整理了多进程与Worker配置、SSL/HTTPS证书报错、跨域与代理配置等实战解决方案,助你快速定位并解决Uvicorn运行中的各类问题。

0

2026.11.02

Uvicorn使用教程
Uvicorn使用教程

本专题汇总了Uvicorn使用教程与启动运行指南,涵盖其作为Python ASGI服务器的定位与特点,以及命令行启动(uvicorn main:app --reload)、参数配置(host/port/workers)、程序内嵌运行与Gunicorn结合部署等核心用法。同时整理了热重载调试、日志配置与生产环境部署优化等技巧,助你快速掌握Uvicorn的运行与配置。

0

2026.11.02

Uvicorn安装配置教程
Uvicorn安装配置教程

本专题汇总了Uvicorn的安装配置教程与部署指南,涵盖通过pip安装Uvicorn、启动FastAPI/Starlette应用、开发模式热重载(--reload)及多进程工作模式配置等核心操作。同时整理了结合Gunicorn的生产部署方案、HTTPS与反向代理配置及性能调优技巧,助你快速完成Uvicorn服务的安装与上线部署。

0

2026.11.02

Vite 项目如何打包和部署
Vite 项目如何打包和部署

Vite项目打包部署专题汇集生产构建、产物预览、输出目录、资源路径、Nginx与GitHub Pages部署及常见白屏和路由404问题的已审核文章,帮助读者完成上线流程。

120

2026.10.28

Vite 如何搭配 Vue.js
Vite 如何搭配 Vue.js

Vite搭配Vue.js专题汇集创建Vue 3项目、配置开发环境、路径别名、Vue插件、代理、多环境构建与调试的已审核文章,帮助读者完成从初始化到日常开发的配置。

80

2026.10.28

Vite 项目目录怎么看
Vite 项目目录怎么看

Vite项目目录专题汇集入口文件、src源码、public静态资源、路径别名、项目根目录和构建输出目录相关的已审核文章,帮助读者理解各文件夹的用途与引用方式。

280

2026.10.28

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

160

2026.10.22

Gradle Wrapper配置教程
Gradle Wrapper配置教程

本专题介绍Gradle Wrapper的基本作用,涵盖文件组成、生成方法、版本配置和任务调用,帮助你理解项目如何使用指定的Gradle版本,减少不同开发环境带来的构建差异。

140

2026.10.22

Golangci-lint检查器使用教程
Golangci-lint检查器使用教程

本专题整理Golangci-lint常用Linters的用途与配置方法,覆盖错误处理、无效代码、安全、复杂度、命名和依赖检查,帮助项目合理选规则。

100

2026.10.22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
简单聊聊mysql8与网络通信
简单聊聊mysql8与网络通信

共1课时 | 0.1万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn