proxy_set_header是Nginx反向代理中用于设置发往后端请求头的指令，需在location或server块中配合proxy_pass使用，可添加、修改或清空请求头，支持变量与固定值。
在 Nginx 中，proxy_set_header 是反向代理场景下修改或添加请求头的核心指令，用于控制发往后端服务（如上游应用服务器）的 HTTP 请求头。它不修改客户端发给 Nginx 的原始请求头，而是**重写或新增 Nginx 转发给 upstream 时携带的请求头**。
基本语法和作用位置
proxy_set_header 必须写在 location 或 server 块中，且仅对启用了代理的上下文（如使用了 proxy_pass）生效。语法为：
proxy_set_header Header-Name Value;
FastAPI Flask Proxy
下载
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
其中：
• Header-Name 是标准或自定义请求头名（如 X-Real-IP、X-Forwarded-For、X-Request-ID）；
• Value 可以是固定字符串，也可以是 Nginx 内置变量（如 $remote_addr、$http_user_agent、$request_id）；
• 若值为空字符串（""），该请求头将被**完全移除**（不发送给后端）；
• 每个 proxy_set_header 指令只设置一个头，重复声明同名头会覆盖前一个（Nginx 默认已预设部分头，如 Host、Connection）。
常用自定义请求头示例
以下是在实际代理配置中高频使用的写法：
-
proxy_set_header X-Real-IP $remote_addr;—— 把客户端真实 IP 传给后端（适用于直接暴露或一层代理） -
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;—— 追加客户端 IP 到X-Forwarded-For链（比$remote_addr更安全，支持多层代理） -
proxy_set_header X-Forwarded-Proto $scheme;—— 告知后端当前是http还是https（对生成绝对 URL 很关键） -
proxy_set_header X-Request-ID $request_id;—— 透传唯一请求 ID（需启用random_index on;或依赖模块生成，常用于链路追踪） -
proxy_set_header X-Forwarded-Host $host;—— 保留原始 Host，避免后端误判域名 -
proxy_set_header Authorization $http_authorization;—— 显式转发客户端的认证头（默认被 Nginx 清除，需手动恢复）
注意默认行为与常见陷阱
Nginx 在启用 proxy_pass 时会自动重写部分请求头，例如：
-
Host头默认设为proxy_pass指定的上游地址的 host（不是客户端原始 host），如需保留，应显式写：proxy_set_header Host $host; -
Connection、Keep-Alive等连接相关头会被自动清理，一般无需干预 -
Authorization和Cookie等敏感头默认不会透传，必须用proxy_set_header显式声明才能发送 - 若在
http块顶层设置proxy_set_header，它会继承到所有 proxy location，但更推荐按需在具体location中设置，避免误影响
完整配置片段参考
一个典型的安全代理配置示例：
location /api/ {<br>
proxy_pass https://backend-server;<br>
proxy_set_header Host $host;<br>
proxy_set_header X-Real-IP $remote_addr;<br>
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;<br>
proxy_set_header X-Forwarded-Proto $scheme;<br>
proxy_set_header X-Forwarded-Host $host;<br>
proxy_set_header X-Request-ID $request_id;<br>
proxy_set_header Authorization $http_authorization;<br>
} 
