Nginx中proxy_redirect不支持$upstream_addr等运行时变量，需用map映射、sub_filter替换或proxy_hide_header+add_header重构Location头来动态修正跳转地址。
在 Nginx 负载均衡反向代理中，后端服务返回的 Location、Refresh 等响应头里常含原始内部地址（如 http://10.0.1.5:8080/login），若不修正，浏览器会直接跳转到不可达的内网地址。仅靠静态 proxy_redirect 无法适配多节点动态上游，必须结合变量实现路径重写。
理解 proxy_redirect 的变量支持限制
Nginx 官方文档明确说明：proxy_redirect 的重写规则**不支持使用 $upstream_addr、$upstream_http_location 等运行时变量**，仅允许字面量或预定义的 URI 变量（如 $scheme、$host）。这意味着不能写成：
proxy_redirect http://$upstream_addr/ /; ❌ 不生效
真正可行的思路是：用 proxy_redirect off 关闭自动重写，改用 sub_filter 或 map + proxy_redirect 静态映射，再配合变量构造通用规则。
方案一：map 映射上游地址 → 域名前缀（推荐）
适用于上游服务部署在固定 IP+端口，且对外暴露统一域名（如 api.example.com）的场景。通过 map 提前将内网地址映射为可变前缀，再用于 proxy_redirect：
- 在
http块中定义映射关系：
map $upstream_addr $upstream_host {<br> default "api.example.com";<br> "10.0.1.5:8080" "api.example.com";<br> "10.0.1.6:8080" "api.example.com";<br>}
- 在 upstream 或 location 中启用：
location /api/ {<br> proxy_pass http://backend;<br> proxy_redirect http://$upstream_host/ /api/;<br> proxy_redirect https://$upstream_host/ /api/;<br>}
注意：$upstream_host 是 map 输出，非运行时变量，Nginx 允许在 proxy_redirect 中使用；/api/ 作为 rewrite prefix，确保重写后路径保留原始请求路径层级。
阿里百炼大模型平台多人共享账号用量统计代理服务。解决公司共用账号时无法区分个人用量的问题。适用场景：1)部署用量统计代理；2)统计多人Token用量和调用次数；3)管理大模型API调用配额。
方案二：sub_filter 动态替换响应头（兼容性强）
当上游地址完全不可预测，或需处理 Refresh、Content-Security-Policy 等多类头字段时，用 sub_filter 直接修改响应体与响应头：
- 开启响应头替换（需
sub_filter_types *）：
location /app/ {<br> proxy_pass http://backend;<br> proxy_redirect off;<br> proxy_set_header Host $host;<br> sub_filter_types *;<br> sub_filter_once off;<br> sub_filter 'http://10.0.1.5:8080' 'https://$host/app';<br> sub_filter 'http://10.0.1.6:8080' 'https://$host/app';<br> sub_filter 'https://10.0.1.5:8443' 'https://$host/app';<br> sub_filter_last_modified off;<br>}
关键点：sub_filter 支持变量（如 $host），但**不支持正则捕获组**；若上游地址太多，建议用脚本生成配置或改用 Lua 模块（如 ngx_http_lua_module）做动态替换。
方案三：用 proxy_hide_header + add_header 重构 Location（精确控制）
适用于后端返回的 Location 总是相对路径或固定结构（如 /login?next=/home），此时可屏蔽原始头，手动构造：
- 先隐藏原始
Location： - 再用
add_header或return逻辑补充（需配合error_page）：
location /svc/ {<br> proxy_pass http://backend;<br> proxy_redirect off;<br> proxy_hide_header Location;<br> error_page 301 302 307 = @handle_redirect;<br>}<br><br>location @handle_redirect {<br> add_header Location "$scheme://$host/svc$upstream_http_location" always;<br> return $status;<br>}
⚠️ 注意：$upstream_http_location 是响应头值，仅在 error_page 上下文中可用；该方式对 3xx 响应有效，但需确保后端返回的是绝对路径或能被正确拼接的相对路径。
核心原则是：不要试图让 proxy_redirect 直接解析运行时变量，而是把变量逻辑前置到 map、sub_filter 或 error_page 流程中。选哪种取决于你的上游稳定性、协议复杂度和是否允许引入第三方模块。
