Nginx反向代理HTTPS上游:正确发送SNI并校验证书
浏览器与Nginx的HTTPS正常,不代表Nginx到上游的HTTPS也已经正确验证。两段连接各有自己的域名、证书和信任设置。本文以Ubuntu 24.04上的Nginx反向代理为例,处理你管理的HTTPS上游;浏览器收到旧证书的排查见实际HTTPS入口检查。
先分清地址、TLS名称与HTTP主机名
假设公网网站是www.example.com,上游实际连接地址是192.0.2.20:443,上游证书覆盖origin.example.com。这三个值可能不同。以下都是占位值,必须按自己的拓扑替换。
| 配置对象 | 作用 |
|---|---|
| proxy_pass中的地址 | 决定Nginx连接哪台上游服务器和端口。 |
| proxy_ssl_name | 指定校验上游证书所用的名称,也作为开启SNI后发送的名称。 |
| proxy_set_header Host | 设置TLS握手完成后HTTP请求的Host,让上游应用选择站点;不替代SNI或证书校验。 |
Nginx中proxy_ssl_server_name和proxy_ssl_verify默认都为off;仅把proxy_pass改成https://,不应被当成已启用上游身份验证。proxy_ssl_name默认来自proxy_pass主机部分,直接写IP时尤其要确认它是否匹配证书。
从代理服务器先核验上游本身
在代理所在服务器、允许直连的网络中执行;保持真实上游名称,用固定地址检查目标:
curl --noproxy "*" --resolve origin.example.com:443:192.0.2.20 --connect-timeout 5 --max-time 15 -I https://origin.example.com/
若上游使用私有CA,应通过可信渠道取得对应CA证书,并用curl的--cacert指定它;不能下载来历不明的根证书或加-k跳过验证。连接超时、名称不符、证书链错误和HTTP返回错误应分别处理。上游不支持HEAD时改用普通只读测试请求,不把405直接认作TLS失败。
在实际代理location中加入验证设置
保存原配置,下面片段合并到真正处理请求的location,不另建冲突规则。示例上游应用也要求Host为origin.example.com:
location / {
proxy_pass https://192.0.2.20;
proxy_ssl_server_name on;
proxy_ssl_name origin.example.com;
proxy_ssl_verify on;
proxy_ssl_trusted_certificate /etc/ssl/certs/ca-certificates.crt;
proxy_ssl_verify_depth 2;
proxy_set_header Host origin.example.com;
}
/etc/ssl/certs/ca-certificates.crt是Ubuntu常见的系统CA集合,使用前确认文件存在、权限正确并来自受信任的更新流程。私有CA场景可为这个上游单独指定受控PEM信任文件,不必扩大整机信任范围;信任文件不是站点私钥。
verify_depth按实际证书链层级设置,本例2不是所有上游的通用值。上游应提供必要中间证书;错误链和错误域名应修复对应配置,不能以verify off作为验收结果。如果上游应用要求保留公网Host,就按它的明确要求设置Host,同时仍使用覆盖上游证书的proxy_ssl_name,两者分开验证。
检查、加载并确认两段都正常
sudo nginx -t && sudo systemctl reload nginx
检测失败时不重载。成功后从正常业务入口访问一个无副作用页面,结合代理错误日志和上游访问日志确认请求确实到达目标。语法通过只证明配置可解析,不证明上游证书被接受。可能出现的关键线索:
| 现象 | 处理方向 |
|---|---|
| certificate does not match | 核对proxy_ssl_name与上游实际证书SAN。 |
| certificate verify failed | 核对信任CA、上游中间链、有效期及验证深度。 |
| TLS通过但页面属于其他站点 | 核对HTTP Host与上游路由,不关闭证书验证。 |
| 上游直测正常而代理仍失败 | 核对Nginx实际加载的location、文件路径及运行环境。 |
需要验证拒绝能力时,在独立测试实例中使用错误名称或不被信任的测试证书,确认代理拒绝;不要在生产上临时放置错误证书。完成标准是客户端到代理正常、代理到上游保持verify on并通过正确名称和可信链校验,实际业务也返回预期内容。基础代理结构见Nginx反向代理教程。