proxy_redirect用于重写后端返回的Location和Refresh响应头，仅匹配替换、不修改响应体，支持字面量和正则语法，默认default模式自动替换proxy_pass目标部分，但复杂场景需显式配置以适配HTTPS或子路径。
当 Nginx 作为反向代理时，后端应用（如 Flask、Django、Spring Boot）返回的 302 或 301 响应中常带有原始内部地址的 Location 头（例如 http://127.0.0.1:8000/login），直接透传给客户端会导致跳转失败。此时需用 proxy_redirect 重写该头，将其替换为对外暴露的域名路径。
理解 proxy_redirect 的作用机制
proxy_redirect 不修改响应体，只改写响应头中的 Location 和 Refresh 字段。它按“匹配 → 替换”方式工作，支持字面量和正则两种语法。Nginx 默认开启 proxy_redirect default，会自动将后端返回的 Location 中与 proxy_pass 目标一致的部分，替换成当前 server_name 和请求 URI 路径。
但默认行为仅适用于简单场景。一旦后端返回绝对 URL 且与 proxy_pass 地址不完全匹配，或需统一收敛到 HTTPS/特定子路径，就必须显式配置。
常见配置方式与写法示例
假设你通过 https://example.com/app 访问服务，Nginx 将请求转发至 http://127.0.0.1:3000，而后端返回 Location: http://127.0.0.1:3000/dashboard，你需要把它变成 https://example.com/app/dashboard。
-
基础字面量替换（推荐用于固定路径）：
proxy_redirect http://127.0.0.1:3000/ https://example.com/app/;
注意末尾斜杠必须一致，否则不匹配。 -
使用正则灵活处理（适配多端口或动态 host）：
proxy_redirect ~^http://[^/]+(/.*)$ https://example.com/app$1;
它捕获后端返回 URL 的路径部分（$1），拼接到新域名后。 -
关闭重写（调试时临时禁用）：
proxy_redirect off;
此时 Nginx 不干预Location，便于抓包确认原始值。
配合 proxy_set_header 避免协议/主机错乱
仅靠 proxy_redirect 不够——后端若依赖 X-Forwarded-Proto 或 Host 头生成跳转地址，还需同步设置：
-
proxy_set_header Host $host;（或$proxy_host，视需求） proxy_set_header X-Forwarded-Proto $scheme;proxy_set_header X-Forwarded-For $remote_addr;
尤其当 Nginx 终止 HTTPS，后端却生成 http:// 开头的 Location 时，X-Forwarded-Proto 能让后端主动构造 https:// 链接，减少对 proxy_redirect 的依赖。
调试与验证要点
配置后务必验证实际响应头：
- 用
curl -I https://example.com/app/login查看返回的Location是否已修正 - 检查 Nginx error log，若出现
proxy_redirect: no replacement for ...，说明规则未命中，需调整匹配模式 - 注意：若后端返回相对路径（如
/dashboard），proxy_redirect不生效，此时应由后端或前端处理，或用sub_filter（不推荐，有性能开销）
