反向代理与 HTTPS 的几个细节
证书链、ALPN、超时和缓冲,出问题时往往都藏在这些细节里。
反向代理看起来只是“转发请求”,但 HTTPS 相关的细节不少,出问题时又很难一眼看出原因。
证书链要完整
只放叶子证书时,部分客户端会报“证书签发者未知”。正确做法是使用包含中间证书的 fullchain,并确认顺序是叶子在前。
bash
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null看返回的链是否包含中间证书,以及 Verify return code 是否为 0。
ALPN 与后端协议
如果后端只支持 HTTP/1.1,而代理默认协商 h2,可能出现握手成功但请求失败。必要时显式指定:
nginx
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection $connection_upgrade;$connection_upgrade 需要一张 map,按 Upgrade 头决定是否保持连接。
超时与缓冲
大文件下载、长连接、流式接口都容易被默认缓冲和超时打断。按接口类型分别设置,不要全局一套参数。
nginx
location /api/stream/ {
proxy_buffering off;
proxy_read_timeout 3600s;
proxy_send_timeout 3600s;
}流式接口关缓冲,静态资源反而应该开缓冲和缓存。
HSTS 与跳转
确认全站 HTTPS 可用之后再加 HSTS,并且先短 max-age 观察:
nginx
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;加之前想清楚:一旦浏览器记住,回退到 HTTP 会直接不可访问。
重定向循环多半是 proto 判断错了
反代后面 $scheme 是 http,应用以为需要跳 HTTPS,于是无限重定向。要么透传 X-Forwarded-Proto,要么在应用侧信任该头。
小结
先把证书链和 ALPN 确认对,再调超时和缓冲。顺序错了,会在错误的方向上浪费很多时间。
说明:文中的地址、域名、主机名与账号均为脱敏示例;配置片段来自实际环境,但版本与网络条件不同,照搬前请先在测试环境验证。最后校对:2025-12-20。