proxy_redirect用于修正后端返回的Location头，避免浏览器跳转到内网地址；典型场景是反向代理时将http://127.0.0.1:8000/login重写为https://example.com/login。
Nginx 的 proxy_redirect 指令专门用于修正后端服务（如 Flask、Django、Node.js 应用）在返回 301/302 响应时携带的 Location 头——特别是当后端生成的跳转地址是内部路径或不匹配前端暴露地址时，避免浏览器跳转到错误地址。
为什么需要 proxy_redirect？
典型场景：Nginx 作为反向代理，将 /api/ 路径转发给运行在 http://127.0.0.1:8000 的后端。后端逻辑中执行了 return redirect("/login")，它生成的响应头为：
Location: http://127.0.0.1:8000/login
浏览器收到后会直接访问该内网地址，失败。而我们期望它跳转到 https://example.com/login（即用户实际访问的域名路径）。proxy_redirect 就是用来重写这个 Location 头的。
Bailian Usage Proxy
下载
阿里百炼大模型平台多人共享账号用量统计代理服务。解决公司共用账号时无法区分个人用量的问题。适用场景：1)部署用量统计代理；2)统计多人Token用量和调用次数；3)管理大模型API调用配额。
基本语法与常用写法
proxy_redirect 支持两种格式：
-
重写规则式：
proxy_redirect http://127.0.0.1:8000/ /;
→ 把Location中以http://127.0.0.1:8000/开头的部分，替换成/（即相对路径前缀） -
正则式：
proxy_redirect ~^http://[^/]+(/.*)$ $1;
→ 匹配任意原始协议+域名+端口，并只保留路径部分（适用于多后端或动态部署）
注意：该指令必须放在 location 块中，且仅对当前 location 下的 proxy_pass 生效；若设为 off，则完全禁用重写。
常见配置示例
- 后端返回绝对 URL（含域名），需替换为当前域名：
proxy_redirect https://backend.example.com/ https://example.com/; - 后端返回 HTTP 内网地址，前端是 HTTPS：
proxy_redirect http://127.0.0.1:8000/ https://example.com/; - 后端返回根路径跳转，但 Nginx 是子路径代理（如
/app/）：location /app/ {<br> proxy_pass http://127.0.0.1:3000/;<br> proxy_redirect / /app/;<br>}
→ 后端返回Location: /login，被改写为/app/login
调试技巧与注意事项
- 开启
error_log并设为info级别，可查看proxy_redirect是否匹配成功 - 确保
proxy_set_header Host $host;已设置，否则后端可能生成错误的Location - 如果后端使用框架自动生成跳转（如 Django 的
redirect("name")），建议配合FORCE_SCRIPT_NAME或SCRIPT_NAME环境变量，让后端直接输出正确路径，减少依赖 Nginx 重写 -
proxy_redirect default;是快捷写法，等价于把后端proxy_pass地址自动映射为当前请求的协议+host+port，适合简单同构部署
