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;

其中：
• 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）。

常用自定义请求头示例

以下是在实际代理配置中高频使用的写法：

FastAPI Flask Proxy

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

下载

• 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>
}