正确配置 proxy_set_header 是反向代理中传递客户端真实信息的关键，需显式设置 host、x-real-ip、x-forwarded-for、x-forwarded-proto 等头，且必须与 proxy_pass 同处 location 块内，使用 $host、$remote_addr、$proxy_add_x_forwarded_for、$scheme 等变量确保准确性。
要用 proxy_set_header 正确转发请求头，关键是在反向代理时把客户端的真实信息准确传递给后端服务。它不是自动生效的，必须显式配置，否则后端看到的可能是 Nginx 自己的 IP、默认 Host 或丢失协议类型。
必须设置的核心请求头
以下几项在大多数生产场景中都建议配置，缺一不可：
-
Host：设为
$host或$http_host，确保后端收到的 Host 与客户端原始请求一致，避免路由失败或生成错误跳转链接 -
X-Real-IP：设为
$remote_addr，直接传递客户端真实 IP（适用于直连或单层代理） -
X-Forwarded-For：设为
$proxy_add_x_forwarded_for，保留完整代理链路 IP，支持多级代理（比如 CDN → Nginx → 后端） -
X-Forwarded-Proto：设为
$scheme，让后端知道原始请求是 http 还是 https，影响重定向和 URL 生成逻辑
配置位置和继承规则
这个指令必须和 proxy_pass 出现在同一个配置块里，推荐写在 location 中：
FastAPI Flask Proxy
下载
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
- 如果只在
http或server块里定义，会被所有子块继承，但容易被覆盖或误用 - 若
location内又写了同名proxy_set_header，会完全替换上级配置，不是追加 - 每行只能设置一个头，格式固定为
proxy_set_header 头名称 值，不能合并多头到一行
常用变量和注意事项
值部分支持变量，但拼写必须严格匹配：
-
$host和$http_host不同：$http_host优先取请求头里的 Host，$host是 Nginx 解析出的主机名（不含端口） -
$proxy_add_x_forwarded_for是内置变量，会自动追加$remote_addr到原有X-Forwarded-For值后，避免覆盖上游代理信息 - 若需条件透传（例如只在带 Authorization 时转发），要用
map指令先定义变量，再在proxy_set_header中引用 - 头名称区分大小写，但 Nginx 内部统一转为小写+下划线形式，如
$http_user_agent、$http_x_forwarded_for
典型配置示例
放在 location / 块内最稳妥：
proxy_pass http://127.0.0.1:8000;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header X-Forwarded-Host $host;
