proxy_redirect用于改写后端重定向响应头中的url，解决内网地址暴露问题；需在location中proxy_pass之后配置，支持默认替换和显式映射两种方式，注意正则匹配语法及https协议一致性。
Nginx 的 proxy_redirect 指令用于改写后端服务器返回的 Location 和 Refresh 响应头中的 URL，解决反向代理下重定向地址暴露内网路径或端口的问题。
为什么需要 proxy_redirect
当后端应用（如 Flask、Spring Boot）返回 302 重定向时，它生成的 Location 头通常是内部地址，例如：
用户浏览器直接访问该地址会失败。Nginx 需将这个地址替换成对外可访问的域名路径，比如：
Location: https://example.com/login?next=/admin基本语法与常见用法
proxy_redirect 支持两种写法：
FastAPI Flask Proxy
下载
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
-
默认替换：仅写
proxy_redirect on;，Nginx 自动把后端响应中Location的http://upstream_name/或http://ip:port/替换为当前请求的协议+主机名+端口（来自$scheme、$host、$server_port） -
显式映射：指定源和目标前缀，更精确可控：
proxy_redirect http://192.168.1.10:8080/ https://example.com/;
proxy_redirect http://backend-server/ /;
proxy_redirect ~^http://[^/]+(/.*)$ $1;
关键注意事项
这些细节容易导致失效：
-
proxy_redirect必须放在location块中，且在proxy_pass之后生效 - 如果后端返回的是相对路径（如
Location: /login），Nginx 默认不处理——此时无需proxy_redirect，浏览器会自动基于当前域名解析 - 使用正则匹配时，必须加
~或~*，且目标中可用$1、$2引用捕获组 - 若配置了多个
proxy_redirect，Nginx 按顺序匹配第一个成功项，后续忽略 - 配合 HTTPS 时，确保目标地址协议为
https://，否则可能降级到 HTTP
典型配置示例
假设 Nginx 对外提供 https://app.example.com，后端运行在 http://127.0.0.1:3000，且返回的重定向含完整内网地址：
location / {
proxy_pass http://127.0.0.1:3000;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
<pre class="brush:php;toolbar:false;"># 将后端返回的 http://127.0.0.1:3000/xxx → https://app.example.com/xxx
proxy_redirect http://127.0.0.1:3000/ https://app.example.com/;
# 或更通用：匹配任意 127.0.0.1:3000 开头的 Location
# proxy_redirect ~^http://127\.0\.0\.1:3000(/.*)$ https://app.example.com$1;}
