共计 2600 个字符,预计需要花费 7 分钟才能阅读完成。
排查 Nginx 反向代理的 TLS 问题时,可以先分清客户端到入口、入口到上游这两段连接。两段链路的协议、证书校验对象和 TLS 终止位置可能不同:先画清这些边界,再核对证书链、上游协议与连接配置,排查目标会更明确。
素材给出的线索:上游 HTTP 版本需要显式确认
据 NGINX 博客 2026-11-09 条目摘要(未阅读全文),NGINX Ingress Controller 默认使用 HTTP/1.1 与后端 Pod 通信;摘要还提到,越来越多后端接受无 TLS 的 HTTP/2(h2c),部分较旧后端仍需要 HTTP/1.0,gRPC 后端已有单独文档覆盖(NGINX 博客该条目)。这些是摘要陈述,不能据此推断某个具体集群的默认值,但足以说明:代理到上游的协议是一个需要显式确认的运维参数。
为什么值得单独确认?HTTP/1.1 支持持久连接,适合大多数 Web 后端;h2c 把多路复用带到明文连接,减少连接数,但明文意味着没有 TLS 提供的机密性与完整性保护,只适合可信网络或已由其他层保护的链路;HTTP/1.0 通常缺少持久连接,可能增加连接建立开销。版本不匹配时,常见表现可能是 502、504、gRPC 调用失败或升级失败,但这是排查方向的推断,不是本文验证过的结论,仍需结合代理日志与后端日志判断。
先把 TLS 终止位置定下来
TLS 证书运维的第一步不是续期,而是确认终止点:客户端 TLS 在边缘 Nginx 终止,还是透传到后端由后端终止。终止点决定私钥放在哪、证书链由谁维护、续期失败由谁告警。若边缘终止,代理到上游可能是明文 HTTP 或 h2c,此时上游协议的信任边界要单独评估;若透传,代理只做四层转发,证书问题会落到后端,代理日志能提供的信息也更少。
入口访问控制与 TLS 是不同层。素材中 NGINX Gateway Fabric 的 AccessPolicy 条目摘要说,它可以在 Gateway 或单条路由上允许或阻止客户端 IP 与 CIDR 范围(NGINX 博客该条目,仅标题与摘要)。这说明“谁能连进来”和“证书是否有效”应分开治理:访问策略不能替代证书校验,证书也不能替代来源控制。
TLS 证书运维的五个检查面
以下为通用建议,不是素材事实,也未在本环境验证:
- 证书链完整:服务端应下发终端证书和必要的中间证书。只给终端证书,部分客户端会验证失败;不同客户端对链的容忍度不同,需用多种客户端验证。
- SNI 与多域名:同一入口承载多个域名时,证书选择依赖 SNI。旧客户端或不支持 SNI 的客户端可能拿到默认证书,需确认默认证书策略。
- 续期闭环:不仅监控“证书是否过期”,还要监控“续期任务是否成功”。到期时间告警应留出处理窗口;续期失败要能触发告警,而不是等到过期。
- 灰度与回滚:新证书先在小流量入口或测试域名验证,保留旧证书与旧配置的回滚路径。私钥权限最小化,避免进入日志或版本库。
- 协议与套件:TLS 版本与加密套件策略应与客户端兼容性匹配。关闭旧协议前,先统计客户端分布;没有数据时不要凭感觉关闭。
一份可执行的排查顺序
| 检查项 | 目的 | 建议动作 | 依据边界 |
|---|---|---|---|
| 客户端协议 | 确认入口 TLS 版本与 HTTP 版本分布 | 查看访问日志与客户端错误,先建立基线 | 通用建议 |
| 上游协议 | 确认后端实际支持的协议 | 与后端负责人确认,并查看代理错误日志 | 素材摘要提示版本差异;具体需核实 |
| 证书链 | 避免中间证书缺失 | 用多种客户端验证完整链 | 通用建议 |
| 续期任务 | 避免“证书未过期但续期已失败” | 同时设置到期告警与续期失败告警 | 通用建议 |
| 回滚路径 | 变更失败时可恢复 | 保留旧证书、旧配置与变更前证据 | 通用建议 |
未执行示例:只示意配置位置
下面片段仅用于说明“TLS 终止”和“上游 HTTP 版本”在配置中的位置,地址、域名、路径均为占位符,未执行,也不代表任何版本的最佳实践。具体指令与字段名应以所用 Nginx 或 Ingress Controller 版本文档为准。
upstream app_backend {
server 10.0.0.10:8080;
keepalive 32;
}
server {
listen 443 ssl;
server_name example.com;
ssl_certificate /etc/nginx/tls/example.com.fullchain.pem;
ssl_certificate_key /etc/nginx/tls/example.com.key;
location / {
proxy_pass http://app_backend;
proxy_http_version 1.1;
proxy_set_header Connection "";
}
}
这是放在 Nginx http {} 上下文中的片段,不是包含 events {} 与 http {} 的完整主配置。将域名、证书链、私钥路径和上游地址替换为自己的值,避免与已有 server_name、监听端口重复。私钥需与证书匹配,实际 Nginx 工作进程须能读取相关文件,上游也必须支持这里使用的 HTTP/1.1。
变更前保留原配置,并使用该实例实际的 Nginx 可执行文件及配置路径执行 nginx -t。语法和文件读取通过后,再按现有服务管理方式平滑重载;仍需从实际入口核对证书、上游响应及错误日志,不能把语法通过当作业务验证。若重载失败或业务异常,恢复原配置、再次检查并平滑重载;存在多实例或 WAF 接管端口时,先确认目标进程与监听归属。
这个示例把 TLS 终止在 Nginx,并以 HTTP/1.1 访问上游;keepalive 与 Connection "" 的配合是常见写法,但是否适合你的上游,需要结合后端是否支持持久连接来确认。若后端只支持 HTTP/1.0,或需要 h2c,不能直接套用此段;本文不给出未核实的 h2c 指令名。
变更时最容易被忽略的两件事
第一,证书轮换和上游协议变更不要放在同一次变更里。证书问题与协议问题的症状可能重叠,混在一起会拉长定位时间。第二,保留“变更前”的证据:客户端 TLS 版本分布、上游协议确认记录、证书链验证结果、续期任务状态。没有这些证据,回滚只能靠猜。
最后需要说明:本文没有对任何 Nginx 版本、Ingress Controller 版本或云厂商行为做实测,也没有给出性能数字。素材只支持“上游 HTTP 版本存在差异、需要按后端能力选择”这一层结论;TLS 证书运维部分属于通用工程建议。实际配置前,请以目标环境文档、日志和测试结果为准。
示例说明:文中命令与配置示例未在本站执行;实际部署前请核对官方文档、目标版本与回滚条件。
常见问题
NGINX Ingress Controller 默认用什么协议访问后端?
据素材摘要,默认使用 HTTP/1.1;摘要还提到部分后端接受 h2c、较旧后端可能仍需 HTTP/1.0。本文未阅读全文,具体行为需以所用版本和目标环境核实。
上游启用 h2c 是否一定更好?
不能这样判断。h2c 是无 TLS 的 HTTP/2,是否适合取决于后端支持情况与链路信任边界;本文没有验证性能差异。
TLS 证书运维只看到期时间够吗?
不够。正文建议同时检查证书链、SNI 与多域名策略、续期失败告警、灰度验证和回滚路径。
文中的 Nginx 配置可以直接使用吗?
不可以。那是未执行示例,域名、地址、路径均为占位符,指令和字段名应以目标环境版本文档为准。
引用资料
- Controlling upstream HTTP versions in NGINX Ingress Controller
- Allow and block client IPs in NGINX Gateway Fabric with AccessPolicy
资料链接仅表示正文使用了该素材,不代表所有结论已独立核验。