proxy_redirect off 作用是禁用对后端响应中 Location 和 Refresh 头的自动重写，确保上游返回的重定向地址原样透传给客户端；常用于后端已返回正确公网 URL、子路径适配完成或非 HTTP 重定向场景，需置于 location 或 server 块中 proxy_pass 之后。
在 Nginx 中，proxy_redirect off 的作用是**禁用对后端响应中 Location 和 Refresh 响应头的自动重写**。它本身不是“开启”或“关闭”某个功能的开关，而是明确告诉 Nginx：不要修改上游返回的重定向地址。
什么时候需要设置 proxy_redirect off
常见于以下场景：
- 后端服务（如 Node.js、Python Flask）自己生成了完整的、可直接访问的重定向 URL（例如
https://api.example.com/login），而你希望 Nginx 完全透传，不做任何替换； - 反向代理路径与后端实际路径不一致，但后端已适配并返回正确绝对路径，Nginx 若默认重写反而会出错；
- 使用 WebSocket 代理或某些特殊协议时，
Location头非 HTTP 重定向用途，需保留原样。
如何正确配置
将 proxy_redirect off; 放在 location 块或 server 块中，通常与 proxy_pass 配合使用：
location /api/ {
proxy_pass https://backend-server/;
proxy_redirect off; # 关键：禁用重写
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}注意：proxy_redirect off 必须写在 proxy_pass 之后，且不能放在 http 全局块中（语法错误）。
替代方案：精确控制重写规则
如果只是想避免默认行为，但又需要部分重写，可用显式规则替代 off：
-
proxy_redirect http://localhost:3000/ /api/;—— 把后端返回的http://localhost:3000/xxx替换为/api/xxx； -
proxy_redirect ~^http://[^/]+(/.*)$ $1;—— 正则提取路径，去掉域名，适用于后端返回带域名的绝对路径但你想转成相对路径； - 不写
proxy_redirect也不写off，Nginx 会启用默认重写（基于proxy_pass和server_name推导）。
验证是否生效
用 curl 检查后端返回的原始 Location 头是否被透传：
curl -I https://your-domain.com/api/redirect-test
对比 Nginx 日志中的 upstream response header 与 curl 实际收到的 Location。若两者一致，说明 proxy_redirect off 已生效。
