服务器上的Nginx HTTPS上游验证失败怎么办?如何检查证书链与主机名

发布人:A5数据发布时间:2026-10-29 14:50阅读量:112

如果 Nginx 能正常接收客户端 HTTPS 请求,却在转发到后端 HTTPS 服务时返回 502 Bad Gateway,同时错误日志出现证书校验、证书名称或 TLS 握手相关信息,问题通常发生在 Nginx 到上游服务器这一段。它不一定与浏览器访问 Nginx 时使用的证书有关:客户端证书和上游证书属于两条独立的 TLS 连接,需要分别检查。

排查时先确认是否启用了上游证书校验,再分别检查证书链、主机名、SNI 和网络可达性。只看到“证书错误”就更换证书,容易漏掉实际原因:例如 Nginx 使用了错误的校验名称,或后端没有发送完整的中间证书链。

先确认故障范围

Nginx 作为反向代理时,TLS 通常分成两段:

  1. 客户端与 Nginx 建立连接,校验的是 Nginx 对外提供的证书。
  2. Nginx 与上游建立连接,校验的是上游服务返回的证书。

本文讨论第二段。常见表现是部分或全部上游请求失败,客户端看到 502,Nginx 错误日志中出现 upstream SSL certificate verify error、certificate does not match、SSL_do_handshake() failed 等信息。具体日志措辞会因 Nginx、OpenSSL 版本和失败阶段而不同。

先检查当前生效配置,而不是只看某个配置文件。Nginx 可能包含多个配置文件,也可能有多个 server、location 或上游组,实际处理请求的配置未必是刚编辑的那一份。

sudo nginx -T

在输出中定位对应域名的 server、处理请求的 location,以及该位置使用的 proxy_pass。同时确认这些指令是否生效:

proxy_ssl_verify
proxy_ssl_trusted_certificate
proxy_ssl_verify_depth
proxy_ssl_server_name
proxy_ssl_name

需要特别注意:proxy_ssl_verify 默认是 off。如果配置没有显式启用校验,Nginx 通常不会因为上游证书链或主机名不受信任而拒绝连接;但仍可能因协议、密码套件、连接中断等原因握手失败。排查证书校验问题前,先核实当前是否确实开启了验证。

建立原因树:证书校验失败可能在哪里

可将问题按从外到内的顺序分为几层:

层级主要检查点典型观察结果
网络与解析上游地址、端口、DNS、路由和连接状态超时、拒绝连接,或连接到非预期地址
操作系统与权限CA 证书文件是否存在、可读、内容是否正确文件不存在、权限错误,或加载不到可信 CA
TLS 服务端后端是否提供证书、完整中间证书链及正确 SNI 响应握手失败、证书链缺失、返回了另一张证书
Nginx 配置校验开关、信任文件、校验深度、名称和 SNI 是否匹配外部测试成功,Nginx 请求仍失败
应用层路由HTTP Host、虚拟主机和后端路由是否正确TLS 成功但返回 404、403,或命中错误站点

这个顺序不是说网络故障都属于证书问题,而是避免把连接超时、后端路由错误和证书验证失败混为一谈。先用错误日志判断失败发生在哪一层,再进入对应分支。

第一步:分清网络连接失败还是证书验证失败

查看相关时段的 Nginx 错误日志。常见路径包括 /var/log/nginx/error.log,但也可能由发行版、容器配置或自定义日志设置决定。可以先从 nginx -T 中查找 error_log 配置,再结合请求时间、上游地址和请求路径筛选日志。

sudo tail -n 100 /var/log/nginx/error.log

日志含义要结合上下文判断:

  • connect() failed (111: Connection refused) 通常表示目标地址可达,但目标端口没有接受连接,优先检查上游服务监听端口和防火墙策略。
  • upstream timed out 可能是网络路径、后端响应时间或连接处理能力问题,不足以单独证明证书有误。
  • upstream SSL certificate verify error 表示 TLS 证书验证阶段失败,应继续判断是信任链还是名称校验。
  • SSL_do_handshake() failed 是较宽泛的握手错误。可能涉及 SNI、协议版本、密码套件、对端配置或连接中断,需要结合后续的 OpenSSL 错误编号和后端日志。
  • 如果 TLS 握手已经成功,但返回 404、403 或其他业务状态码,应转向检查 HTTP Host、路径和后端虚拟主机,不要继续更换 CA 文件。

在 Nginx 所在服务器上,先检查目标是否可连接。将地址和端口替换为实际上游地址:

nc -vz 203.0.113.20 443

如果系统没有 nc,可使用可用的网络诊断工具检查 TCP 连接。连接失败时,先核对 Nginx 实际连接的 IP 和端口、DNS 解析结果、路由以及两端防火墙规则。不要因为 443 端口可连接,就认为 TLS 和证书一定正确;TCP 连通只说明连接建立到了某个端口。

核对 Nginx 实际连接的目标

如果 proxy_pass 使用域名,检查该域名在 Nginx 所在环境中的解析结果;如果使用 upstream 组,则查看组内的服务器地址。容器部署场景要在 Nginx 容器内检查,宿主机上的 DNS 结果不一定与容器内一致。

配置示例:

upstream app_backend {
    server 203.0.113.20:443;
}

location / {
    proxy_pass https://app_backend;
}

这里 Nginx 实际连接的是 203.0.113.20:443,但后续证书名称校验和 SNI 的默认名称可能是上游组名 app_backend,不一定是证书上的域名。这个情况需要在后面的名称与 SNI 检查中重点核对。

第二步:检查证书链是否完整、可信

证书链验证要回答两个问题:上游是否发送了建立信任链所需的证书,中间证书和根 CA 是否能与 Nginx 配置的信任文件衔接。

先从 Nginx 所在环境直接查看上游返回的证书链。-servername 用于发送 SNI;应替换为上游需要识别的域名,而不是机械填写上游组名。

openssl s_client \
  -connect 203.0.113.20:443 \
  -servername api.example.net \
  -showcerts \
  -verify_return_error </dev/null

重点查看末尾的验证结果和返回证书信息。常见的参考结果包括:

  • Verify return code: 0 (ok):在当前 OpenSSL 信任库和 SNI 条件下,证书链校验通过。它不能单独证明 Nginx 使用了相同的 CA 文件或名称配置。
  • unable to get local issuer certificate:通常表示本地无法构建到受信任 CA 的证书链。可能是上游没有发送必要的中间证书,也可能是本地信任库缺少对应 CA。
  • self-signed certificate:可能是上游使用了自签证书,也可能是链中的自签根证书不在当前信任范围内。
  • 如果拿到的证书与预期服务无关,应先检查 SNI 是否正确、目标 IP 是否正确,以及后端虚拟主机配置。

openssl s_client 默认使用运行环境的信任库。若要验证某个 CA 文件,可使用 -CAfile 指定它:

openssl s_client \
  -connect 203.0.113.20:443 \
  -servername api.example.net \
  -CAfile /etc/ssl/certs/ca-certificates.crt \
  -verify_return_error </dev/null

上述路径只是常见示例,不能假定所有系统都使用该位置。应先确认发行版和实际 CA 文件路径。部分 Debian、Ubuntu 系统常见系统证书包路径为 /etc/ssl/certs/ca-certificates.crt;部分 RHEL 系系统则常见 /etc/pki/tls/certs/ca-bundle.crt。镜像、容器和精简系统可能不同。

如果使用私有 CA,proxy_ssl_trusted_certificate 应指向包含相应信任证书的 PEM 文件。不要把服务器叶子证书误当成通用可信 CA,也不要在没有确认来源和用途时,把不明证书加入全局系统信任库。对私有 CA,优先使用范围明确、由管理员维护的 CA 文件。

上游服务也需要正确发送链。通常应由服务端发送叶子证书和必要的中间证书;根证书一般由验证端信任库提供。若链缺少中间证书,短期内给 Nginx 增加某张证书可能让单一环境通过,但更稳妥的修复通常是由上游按其服务配置补齐完整链,并在客户端侧再次验证。

第三步:检查证书主机名与 SNI 是否一致

证书链有效,不等于证书属于当前访问的上游名称。证书通常通过主题备用名称(SAN)标识适用的域名;Nginx 校验时使用的名称必须与证书中的有效名称匹配。

Nginx 的相关指令作用不同:

第三步:检查证书主机名与 SNI 是否一致配图

  • proxy_ssl_verify on; 开启上游证书验证。
  • proxy_ssl_trusted_certificate 指定验证时使用的可信 CA 文件。
  • proxy_ssl_name 指定用于证书名称验证的名称;未显式设置时,默认通常基于 $proxy_host。
  • proxy_ssl_server_name on; 开启向上游发送 SNI。它控制 TLS 握手时是否发送服务器名称,不等同于证书名称校验开关。
  • proxy_set_header Host 设置的是 TLS 建立后 HTTP 请求中的 Host 头,也不等同于 SNI 或证书校验名称。

因此,proxy_set_header Host 写对了,不代表 SNI 一定正确;SNI 正确,也不代表 HTTP 请求进入了正确的虚拟主机。要分别核对。

可以用 curl 在 Nginx 所在环境中验证特定 IP、域名和 CA 的组合。--resolve 可让请求连接到指定 IP,同时保留 URL 中的域名用于 TLS 和 HTTP 请求:

curl -v \
  --resolve api.example.net:443:203.0.113.20 \
  --cacert /path/to/ca-bundle.pem \
  https://api.example.net/health

如果成功,说明在该工具、该 CA 文件和该域名下,测试路径能够完成校验并得到 HTTP 响应。若报主机名不匹配,优先检查证书 SAN、URL 域名、SNI 和 Nginx 的 proxy_ssl_name,而不是随意关闭验证。若结果与 Nginx 不同,还要比较二者实际使用的 CA 文件、目标地址和请求域名。

上游组名与证书域名不同的配置

例如,Nginx 通过内部 IP 连接上游,但后端证书签发给 api.example.net。此时显式设置校验名称和 SNI:

upstream app_backend {
    server 203.0.113.20:443;
}

server {
    listen 443 ssl;
    server_name www.example.net;

    location /api/ {
        proxy_pass https://app_backend;

        proxy_ssl_verify on;
        proxy_ssl_trusted_certificate /path/to/ca-bundle.pem;
        proxy_ssl_verify_depth 3;

        proxy_ssl_server_name on;
        proxy_ssl_name api.example.net;

        proxy_set_header Host api.example.net;
    }
}

这里 proxy_ssl_name 与 proxy_ssl_server_name 分别负责证书名称校验和 SNI;Host 则用于上游收到 HTTP 请求后的路由。是否把 Host 设置成上游域名,要按后端应用的虚拟主机配置决定。proxy_ssl_verify_depth 也不应为消除错误而随意调大:它控制允许验证的证书链深度,不能补齐缺失的中间证书,也不能修复错误的主机名。

若上游证书由公有 CA 签发,Nginx 所在系统的 CA 证书包需要可用;若使用私有 CA,应将信任范围限定到明确的证书文件,并确保 Nginx 工作进程能读取。修改配置前先备份相关配置文件;避免直接覆盖不相关的系统 CA 文件。

第四步:从系统与服务配置中定位具体分支

如果 OpenSSL 测试提示信任链失败,但上游证书看起来完整,接下来检查 Nginx 指向的 CA 文件是否存在、内容是否为 PEM 格式,以及运行 Nginx 的进程是否能读取。只检查当前登录用户能否读取并不充分,因为工作进程可能以其他用户运行。

sudo nginx -T | grep -E 'proxy_ssl_(verify|trusted_certificate|verify_depth|server_name|name)'
sudo ls -l /path/to/ca-bundle.pem

如果是容器部署,路径应在容器文件系统中存在,并确认容器镜像包含或挂载了所需文件。若 CA 文件是通过挂载提供的,还要检查挂载是否覆盖了镜像内原有路径。不要为解决单个文件读取问题而给证书目录设置过宽权限;应按实际运行用户授予读取所需文件的权限。

若证书链和名称均通过独立测试,但 Nginx 仍失败,可检查:

  1. 测试目标是否相同:Nginx 与测试工具是否连接到同一个 IP 和端口,是否存在 DNS 轮询、负载均衡或不同网络出口。
  2. SNI 是否相同:OpenSSL 测试是否带了正确的 -servername,而 Nginx 是否启用了 proxy_ssl_server_name。
  3. CA 文件是否相同:测试命令指定的 CA 与 Nginx 的 proxy_ssl_trusted_certificate 是否为同一份文件。
  4. 实际配置是否相同:修改的配置是否被包含,匹配到的是否是当前请求的 location,是否有其他层级的配置影响结果。
  5. 日志是否指向另一种握手问题:例如 TLS 版本、密码套件或后端主动断开。这类故障不能通过更换 CA 证书解决。

还要区分 TLS 和 HTTP 阶段:如果 Nginx 已完成 TLS 握手并收到上游 HTTP 响应,证书验证就不是造成 404、403 等应用状态码的直接原因。此时检查 proxy_pass 的 URI 处理、Host 头、后端虚拟主机和应用路由。

常见根因与对应修复

观察结果更可能的原因修复方向
TCP 连接失败或超时地址、端口、路由、防火墙或后端监听异常先恢复连接,不先改证书校验
unable to get local issuer certificate上游中间链缺失,或 Nginx 信任库不含所需 CA补齐上游链,或配置正确的受信任 CA 文件
证书名称不匹配Nginx 校验名称与证书 SAN 不一致核对证书和域名,必要时设置正确的 proxy_ssl_name
SNI 下拿到错误证书未发送 SNI 或发送了错误名称启用 proxy_ssl_server_name,并核对名称
openssl 成功而 Nginx 失败两者目标、CA 文件、SNI 或实际配置不同逐项对齐测试条件并查看 Nginx 生效配置
TLS 成功但返回 404/403HTTP Host、路径或应用路由不符检查 proxy_set_header Host、URI 和后端路由

不建议把 proxy_ssl_verify 关闭作为长期修复。关闭后,Nginx 不再按配置验证上游证书,可能无法识别连接到了错误或不受信任的服务。如果为了临时恢复而调整了校验开关,应明确限制影响范围、记录变更,并尽快恢复验证;不要把临时措施作为证书问题已解决的依据。

验证恢复与控制变更风险

调整配置前备份对应文件,并记录原来的校验设置、CA 路径、SNI 和名称。修复后先测试配置语法,再平滑重载;不要在语法检查失败时重载。

sudo nginx -t
sudo systemctl reload nginx

systemctl 不适用于所有部署方式。若 Nginx 运行在容器中,应按该环境的管理方式检查配置并重载;先确认服务管理方式,不要猜测服务名。若 nginx -t 报错,停止重载,恢复备份或修正配置后再次检查。

恢复验证至少包括三项:

  1. 从 Nginx 所在环境,用预期域名、SNI、目标地址和 CA 文件进行证书验证。
  2. 通过 Nginx 发起实际业务请求,确认不再返回由上游握手失败导致的 502,并检查对应错误日志。
  3. 确认上游收到的 HTTP Host、路径和响应符合预期;TLS 成功并不等于应用路由正确。

如果重载后出现新故障,应根据变更记录恢复原配置,并重新执行语法检查。证书链、名称、SNI 和 HTTP Host 是相互关联但不同的检查点,回滚时也应明确回退了哪一项,避免为了恢复业务而遗留关闭验证的配置。

复发监控点

证书更新、CA 轮换、后端域名变更、负载均衡地址调整和容器镜像更新,都可能改变上游证书验证结果。可在这些变更后安排一次从 Nginx 所在环境发起的证书链与主机名检查,并监控 Nginx 错误日志中的证书验证和握手错误。

业务监控应同时关注上游连接失败率、502 比例和后端健康状态;单独监控证书到期时间,不能覆盖链不完整、SNI 错误或名称不匹配问题。发生告警时,记录实际连接地址、校验名称、SNI、CA 文件和错误日志,再沿原因树逐层定位,通常比直接关闭验证或替换证书更容易找到根因。

Nginx 上游服务的证书验证与后端主机、网络线路及服务器部署环境密切相关。A5idc数据提供中国香港、美国、日本、韩国、中国台湾、新加坡和马来西亚等地区的物理服务器,可为网站、业务后台和接口服务提供多地区部署资源;香港、美国等地的不同线路与服务器配置,也能适配不同业务的网络和计算需求。

本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/6438.html

相关推荐