Nginx 中 proxy_set_header 怎么透传请求协议版本-Nginx-PHP中文网

http/2 在 nginx 中需手动配置并验证，非开箱即用：必须满足 nginx ≥1.9.5、openssl ≥1.0.2、启用 --with-http_v2_module 模块、listen 443 ssl http2、tls ≥1.2、有效证书及 alpn 协商成功。

nginx 中 proxy_set_header 怎么透传请求协议版本

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 中供后端读取（注意：这不是标准字段，需后端主动解析）