proxy_set_header 是 Nginx 控制请求头转发的关键指令，必须显式配置 Host、X-Real-IP、X-Forwarded-For、X-Forwarded-Proto 等头以确保后端正确识别客户端 IP、协议、域名及端口，未显式声明的头默认被丢弃。
在 Nginx 中，proxy_set_header 是控制上游服务（如后端应用）接收到的 HTTP 请求头的关键指令。它不单是“转发”原始请求头，而是主动重写或注入请求头，实现标准化、安全性和兼容性——这才是真正意义上的“标准化转发”。
明确哪些头需要标准化
不是所有请求头都该原样传递。比如 Host、X-Real-IP、X-Forwarded-For、X-Forwarded-Proto 等，若不显式设置，后端可能拿到反向代理的内部地址或错误协议信息。
- Host：应设为上游服务期望的域名，而非客户端发来的原始 Host（尤其当 Nginx 做多站点复用时）
-
X-Real-IP：设为
$remote_addr，即真实客户端 IP（注意：若前端还有 CDN 或其他代理，需结合real_ip模块信任可信源） -
X-Forwarded-For：追加
$remote_addr，保留原始链路（避免覆盖已有值，Nginx 默认会追加） -
X-Forwarded-Proto：设为
$scheme，让后端知道用户实际用的是 http 还是 https
典型标准化配置示例
以下是一段常用且安全的 location 内配置：
location / {
proxy_pass http://backend;
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;
proxy_set_header X-Forwarded-Port $server_port;
}
注意：$proxy_add_x_forwarded_for 是 Nginx 内置变量，它会在原有 X-Forwarded-For 值后追加 $remote_addr，比直接写 $remote_addr 更稳妥；而 $host 优先取请求头 Host，缺失时 fallback 到 server_name，比 $http_host 更可靠。
FastAPI Flask Proxy
下载
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
避免常见陷阱
标准化失效往往源于配置位置或覆盖逻辑出错：
- 不要在
http块全局设置proxy_set_header Host $host后，又在server或location里重复设置不同值——后者会覆盖前者，但容易遗漏 - 如果上游要求特定
Host（如api.example.com），就该写死：proxy_set_header Host api.example.com;，而不是依赖$host - 未清除默认继承的请求头？Nginx 不会自动删除客户端带的某些头（如
Connection、Keep-Alive），必要时可用proxy_hide_header或proxy_set_header Connection ''清空
验证是否生效
最直接的方式是在后端应用中打印全部请求头（如 Node.js 的 req.headers、Python Flask 的 request.headers），重点检查：
-
X-Real-IP是否为真实客户端 IP（而非 Nginx 本机 IP） -
X-Forwarded-For是否包含多个 IP 且末尾是客户端 IP -
X-Forwarded-Proto是否与浏览器地址栏协议一致（https 页面下应为https） -
Host是否符合后端路由或鉴权预期
不复杂但容易忽略。
