proxy_redirect用于重写后端返回的Location等响应头，解决重定向地址暴露内网或协议/域名不匹配问题；默认自动替换为请求的协议+主机+端口，也可显式指定或正则重写，并需注意HTTPS、端口及X-Forwarded-Proto协同配置。
Nginx 的 proxy_redirect 指令专门用于重写后端服务器返回的 Location、Refresh 和 Content-Location 响应头，解决负载均衡或反向代理场景下重定向地址暴露内网路径、域名错误或端口不匹配的问题。
为什么需要 proxy_redirect？
当后端应用（如 Flask、Spring Boot）生成 302 重定向时，它通常基于自身监听地址构造 Location: http://192.168.1.10:8080/login。若该服务部署在内网，且由 Nginx 统一对外提供 https://app.example.com 入口，用户浏览器收到原始重定向头就会跳转到不可达的内网地址——导致重定向失败。
proxy_redirect 就是在 Nginx 转发响应前，主动查找并替换这些响应头中的 URL，使其指向正确的公网地址。
基本语法与常见写法
格式为：proxy_redirect [default|off|redirect replacement];
-
默认行为（default）：Nginx 自动将后端响应头中形如
http://upstream_ip:port/的地址，替换为当前请求的协议、主机名和端口（即$scheme://$host:$server_port）。适用于简单单域名场景。 -
显式重写：更可靠，推荐使用。
proxy_redirect http://192.168.1.10:8080/ https://app.example.com/;
表示把响应头中所有以http://192.168.1.10:8080/开头的Location值，替换成https://app.example.com/开头。 -
支持正则：用
~或~*（忽略大小写）开头，例如：proxy_redirect ~^http://[^/]+(/.*)$ https://app.example.com$1;
可捕获任意后端域名后的路径，统一映射到公网域名下。
配合 HTTPS 和非标准端口的关键细节
如果 Nginx 使用 HTTPS 对外，但后端是 HTTP + 非标准端口（如 http://10.0.0.5:3000），需注意：
- 确保
proxy_redirect中的replacement使用https://，否则浏览器可能拒绝跳转（混合内容或 HSTS 策略）。 - 若 Nginx 监听 443 但未显式设置
server_name或$host不准确，建议硬编码域名，避免依赖变量出错。 - 后端应用若通过
X-Forwarded-Proto判断协议，也要同步配置proxy_set_header X-Forwarded-Proto $scheme;，否则它可能仍生成http://开头的重定向。
调试与验证方法
启用 proxy_redirect 后，可通过以下方式确认是否生效：
- 用
curl -I请求一个会触发重定向的接口，观察返回的Location头是否已变为预期的公网地址。 - 在 Nginx 配置中临时添加
add_header X-Debug-Location $sent_http_location;，直接在响应头中输出原始Location值（需开启underscores_in_headers on;并注意命名规范）。 - 检查 error.log：若
proxy_redirect未匹配到任何响应头，Nginx 默认静默；若配置语法错误，启动时会报错。
