首页/运维/正文

反向代理与 HTTPS 的几个细节

证书链、ALPN、超时和缓冲,出问题时往往都藏在这些细节里。

运维容器与部署2025-12-20约 2 分钟387 字

反向代理看起来只是“转发请求”,但 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。