proxy_set_header是Nginx中将自定义请求头透传给后端的核心指令，须置于location或server块内生效，后端需主动读取对应header字段；支持固定值、内置变量动态传递及覆盖默认行为，并需注意大小写与多值拼接。
在 Nginx 中，proxy_set_header 是将自定义请求头（包括环境参数）透传给后端服务的核心指令。关键在于：它必须写在 location 块或 server 块中，且仅对当前代理上下文生效；后端应用需主动读取对应 header 字段才能获取这些参数。
设置常见环境参数（如环境标识、来源信息）
你可以在 location 中直接用 proxy_set_header 添加任意 header，例如传递当前部署环境、请求来源或调试标记：
-
proxy_set_header X-Env "prod";—— 固定值，用于标识生产环境 -
proxy_set_header X-Forwarded-For $remote_addr;—— 保留原始客户端 IP（Nginx 默认已设，但可显式覆盖） -
proxy_set_header X-Request-ID $request_id;—— 利用 Nginx 内置变量生成唯一请求 ID，便于链路追踪 -
proxy_set_header X-Cluster-Node "nginx-web-01";—— 标识当前 Nginx 实例，方便后端做灰度或路由判断
动态传递运行时变量（如 Host、Scheme、路径）
借助 Nginx 内置变量，可让后端感知真实请求上下文，避免硬编码：
FastAPI Flask Proxy
下载
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
-
proxy_set_header X-Real-Scheme $scheme;—— 传 http 或 https，尤其在 SSL 终结于 Nginx 时有用 -
proxy_set_header X-Real-Host $host;—— 传浏览器访问的 Host（非 upstream 地址） -
proxy_set_header X-Original-URI $request_uri;—— 传完整原始路径+查询参数，供后端重定向或鉴权参考 -
proxy_set_header X-Forwarded-Prefix "/api";—— 若 Nginx 做了路径重写（如rewrite ^/api/(.*)$ /$1 break;），可显式告知前缀
注意 header 覆盖与清除默认行为
Nginx 默认会发送部分 header（如 Host、Connection），若要修改或禁用，需显式设置：
-
proxy_set_header Host $host;—— 显式设置 Host，否则默认转发上游地址（可能为backend:8080） -
proxy_set_header Connection '';—— 清空 Connection，避免干扰 HTTP/1.1 keep-alive - 未显式设置的 header（如
User-Agent）会原样透传；如需屏蔽，设为空：proxy_set_header User-Agent ""; - 同名 header 多次设置时，以最后一条为准；若需多值，需拼接（如
proxy_set_header X-Tags "$tag1,$tag2";）
后端如何接收这些参数
Header 名称会自动转为标准格式（如 X-Env → x_env 或 HTTP_X_ENV），具体取决于语言和框架：
- Node.js（Express）：
req.get('X-Env')或req.headers['x-env'] - Python（Django）：
request.META.get('HTTP_X_ENV') - Java（Spring Boot）：
@RequestHeader("X-Env") String env - Go（net/http）：
r.Header.Get("X-Env")
不复杂但容易忽略：header 名大小写不敏感，但建议统一用短横线分隔的 PascalCase 风格（如 X-Deploy-Stage），便于识别和维护。
