Nginx 的 proxy_set_header 不支持动态值直接拼接，但可通过 map 指令映射变量、内置变量组合及慎用 if+set 实现灵活 header 控制，需注意覆盖规则、Host 显式设置、作用域和空值处理。
Nginx 的 proxy_set_header 本身不支持动态值的直接拼接（比如变量嵌套或条件判断），但通过合理组合内置变量、map 指令和条件逻辑，完全可以实现灵活、可维护的请求头控制。
用 map 构建动态 header 值
这是最常用也最推荐的方式：把复杂逻辑提前映射为简单变量，再在 proxy_set_header 中引用。
- 在
http块中定义 map，根据请求特征（如 host、path、header）生成自定义变量 - 支持正则匹配、多条件 fallback、默认值设定
- 避免在 upstream 区域重复写冗长判断
例如，按域名区分后端服务标识：
map $host $backend_tag {
default "unknown";
~^api\.example\.com$ "mobile-api";
~^admin\.example\.com$ "admin-panel";
example.com "web-main";
}
然后在 location 中使用：
FastAPI Flask Proxy
下载
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
location / {
proxy_pass https://backend;
proxy_set_header X-Service-Tag $backend_tag;
}
利用内置变量组合基础信息
Nginx 提供大量只读变量（如 $scheme、$host、$request_uri、$http_x_forwarded_for），可直接用于构造 header。
- 转发真实客户端 IP（注意可信代理链）：
proxy_set_header X-Real-IP $remote_addr; - 保留原始协议和主机：
proxy_set_header X-Forwarded-Proto $scheme;和proxy_set_header X-Forwarded-Host $host; - 透传特定上游 header：
proxy_set_header X-Request-ID $request_id;（需配合random_index或uuid模块生成）
用 if + set 实现简单条件覆盖（慎用）
虽然 Nginx 官方不建议在 location 中大量使用 if，但对少量 header 覆盖仍可行——前提是理解其限制（if 在 rewrite 阶段执行，且不能嵌套）。
- 仅用于覆盖单个 header，不要依赖多个
if顺序 - 配合
set先赋值再引用，比直接在proxy_set_header里写表达式更清晰 - 示例：对 API 路径添加特殊标记
location /api/ {
set $api_flag "true";
if ($request_method = "POST") {
set $api_flag "post";
}
proxy_set_header X-Api-Mode $api_flag;
proxy_pass http://api_backend;
}
避免常见陷阱
灵活不等于随意，几个关键点直接影响行为可靠性：
-
Header 覆盖规则：同名
proxy_set_header后面的会覆盖前面的；未显式设置的 header 默认被清除（如 Host） -
Host 头必须显式设置：除非用
proxy_pass带域名（如http://upstream/），否则需加proxy_set_header Host $host; - 变量作用域：map 定义在 http 级生效；set 变量只在当前 location 或 if 块内有效
- 空值处理：变量为空时 header 会被设为空字符串，必要时用 map 设默认值或用 if 过滤
