HTTP/2 在 Nginx 中需手动配置并验证，非开箱即用：必须满足 Nginx ≥1.9.5、OpenSSL ≥1.0.2、启用 --with-http_v2_module 模块、listen 443 ssl http2、TLS ≥1.2、有效证书及 ALPN 协商成功。
proxy_set_header 本身不直接透传 HTTP 协议版本（如 HTTP/1.1 或 HTTP/2），因为协议版本是 TCP 连接层面的协商结果，不是可被普通 header 字段携带或转发的值。Nginx 在反向代理时，会根据上游服务器能力与自身配置，**独立决定与后端通信使用的协议版本**，而不是“复制”客户端请求的版本。
为什么不能直接透传协议版本
HTTP 协议版本属于请求行（Request Line）的一部分，例如 GET /path HTTP/1.1，它不属于请求头（Header），因此无法通过 proxy_set_header 设置或传递。Nginx 解析完客户端请求后，该信息仅用于内部处理逻辑，不会作为 header 转发给上游。
FastAPI Flask Proxy
下载
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
实际影响协议版本的关键配置
-
upstream 块中启用 http_v2：若后端支持 HTTP/2，且你希望 Nginx 与后端使用 HTTP/2 通信，需在 upstream 中显式开启：
upstream backend {<br> server 127.0.0.1:8080;<br> # 必须启用 http_v2 才能与后端走 HTTP/2<br> http_v2 on;<br>} -
proxy_http_version 指令控制发送版本：该指令指定 Nginx 向后端发起请求时使用的 HTTP 版本，默认为
1.0，建议设为1.1或2.0：location / {<br> proxy_pass http://backend;<br> proxy_http_version 1.1;<br> # 若后端支持且 upstream 已启用 http_v2，此处设为 2.0 才生效<br>} - keepalive 需配合 proxy_http_version 1.1+：启用长连接依赖 HTTP/1.1 或更高版本，否则会被降级为短连接。
如何让后端感知客户端原始协议版本
虽然协议版本本身不可透传，但你可以用 proxy_set_header 传递相关语义信息供后端参考：
-
proxy_set_header X-Forwarded-Proto $scheme;—— 传递客户端是 http 还是 https -
proxy_set_header X-Forwarded-Protocol $scheme;—— 同上，部分老框架识别此字段 -
proxy_set_header X-Forwarded-Http-Version $http_version;——$http_version是 Nginx 内置变量，值为HTTP/1.0、HTTP/1.1或HTTP/2，可手动注入到 header 中供后端读取（注意：这不是标准字段，需后端主动解析）
验证协议版本是否生效
可通过以下方式确认 Nginx 与后端实际使用的协议：
- 在后端服务（如 Node.js、Python Flask）中打印
request.environ.get('SERVER_PROTOCOL')或等效字段 - 用 tcpdump 或 Wireshark 抓包，查看 upstream 连接的 TLS ALPN 协商（HTTP/2）或明文请求行
- 检查 Nginx error.log，启用
debug日志级别后搜索http v2或http/1.1相关记录
