proxy_pass_header不能在http块中使用，应改用proxy_set_header透传请求头、add_header或默认行为透传响应头；自定义响应头默认透传，需注意$http_*变量命名规则及underscores_in_headers配置。

在 Nginx 的 http 块中，proxy_pass_header 指令**不能直接使用**，它仅在 location 或 server 块中生效。若想在全局（http 级）统一透传特定自定义请求头或响应头，需换用更可靠、更现代的方式。

正确方式：用 proxy_set_header 和 add_header 统一配置

Nginx 不支持在 http 块中用 proxy_pass_header 透传自定义头（该指令本身已废弃且作用有限）。实际应分两类处理：

• 透传客户端请求头到上游（如 X-Real-IP、X-Forwarded-For、自定义头）：用 proxy_set_header
• 透传上游响应头回给客户端（如 X-RateLimit-Limit、X-Request-ID）：用 proxy_pass_request_headers on（默认开启）+ add_header 或 proxy_hide_header 控制

透传自定义请求头（从客户端→上游）

在 http 块中设置，对所有 proxy_pass 生效：

http {
    # 允许透传客户端的自定义头（如 X-Trace-ID、X-User-ID）
    proxy_set_header X-Trace-ID $http_x_trace_id;
    proxy_set_header X-User-ID $http_x_user_id;
<pre class='brush:php;toolbar:false;'># 保留标准代理头
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

}

⚠️ 注意：$http_* 变量名是小写 + 下划线（如 X-Trace-ID → $http_x_trace_id），Nginx 自动转换大小写。

FastAPI Flask Proxy

FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。

下载

透传上游响应头（从上游→客户端）

Nginx 默认会过滤部分响应头（如 Server、Date、Set-Cookie 等），但**自定义头默认不被过滤**。若上游返回了 X-Response-Time 或 X-Backend，Nginx 会原样透传给客户端 —— 无需额外配置。

如需显式控制：

• 允许透传某个头（确保不被隐藏）：proxy_hide_header X-Backend; → 删除这行即可透传
• 强制添加/覆盖响应头：add_header X-Proxy-Timestamp $time_iso8601;
• 若上游头被意外屏蔽，可配合 underscores_in_headers on;（启用下划线支持，避免因头名含下划线被丢弃）

验证是否生效

用 curl 测试端到端头透传：

curl -H "X-Trace-ID: abc123" -H "X-User-ID: user456" http://your-nginx/

检查上游服务日志或响应，确认是否收到这两个头；再检查返回响应中是否有期望的上游自定义响应头（如 X-Backend: api-v2）。