要让upstream块真正支持http/2多路复用,必须显式添加http2指令(nginx≥1.9.13),后端须为可信https端点(如8443),proxy_pass用https://前缀,keepalive设为4–12,proxy_http_version保持1.1,并清除connection头。

要让 upstream 块真正支持 HTTP/2 多路复用并用于集群回源调优,关键不是“开启开关”,而是满足协议前提、显式声明、匹配连接策略,并规避 HTTP/1.1 的遗留配置惯性。
upstream 必须显式启用 http2 指令
Nginx 默认所有 upstream 通信走 HTTP/1.1,哪怕后端是 HTTPS + HTTP/2 服务。必须在 upstream 定义中为每个 server 行添加 http2,且 Nginx 版本 ≥ 1.9.13:
- 正确写法:
upstream api_http2 { server 10.0.1.5:8443 http2; server 10.0.1.6:8443 http2; } - 仅写
server 10.0.1.5:8443;不会触发 HTTP/2,即使 proxy_pass 是 https:// - 若后端不支持 HTTP/2(如未启用 ALPN 或 TLS 版本过低),Nginx 自动降级,无报错但失去多路复用优势
回源地址必须对应 HTTPS 端点,且证书可信
HTTP/2 在 Nginx upstream 层强制依赖 TLS,因此:
- 后端监听端口应为 HTTPS(如 8443),而非 HTTP(8080);
-
proxy_pass必须使用 https:// 前缀(如proxy_pass https://api_http2;); - 生产环境需确保后端证书由可信 CA 签发;测试环境可临时加
proxy_ssl_verify off;; - 推荐启用
proxy_ssl_server_name on;,支持 SNI,便于同一 IP 承载多个 HTTP/2 后端域名
按多路复用特性重设 keepalive 与请求头
HTTP/2 单连接可并发处理数十请求,无需 HTTP/1.1 那样的高连接池:
- keepalive 值建议设为 4–12(例如
keepalive 8;),过高易压垮后端连接数; - 必须保留
proxy_http_version 1.1;(不是 2.0)——这是 Nginx 当前设计:用 HTTP/1.1 请求头协商复用连接,实际走 HTTP/2 流; - 清除干扰头:
proxy_set_header Connection '';(Upgrade和Connection在 HTTP/2 中被禁止透传,Nginx 会自动过滤,但显式清空更稳妥)
配合健康检查与容错策略做回源稳定性调优
HTTP/2 连接更“重”,一次失败可能影响多个 stream,因此健康检查需更灵敏:
- 设置较短的故障窗口:
max_fails=2 fail_timeout=15s,避免单次网络抖动导致长时间隔离; - 显式启用错误码计数:
proxy_next_upstream error timeout http_502 http_503 http_504;,否则 5xx 不触发摘除; - 对长耗时回源(如文件下载、报表生成),适当延长
proxy_read_timeout,但须小于fail_timeout,否则超时不被识别为失败; - 关键回源链路可配
backup节点,但注意:HTTP/2 backup 也需同样启用 http2 和 TLS 配置











