proxy_redirect用于修改后端返回的location和refresh响应头url，使其适配nginx代理的公网地址；因后端常基于内网地址生成重定向url，不改写会导致浏览器跳转失败。
proxy_redirect 指令用于修改后端服务器返回的 Location 和 Refresh 响应头中的 URL，使其适配前端 Nginx 代理的公网地址，避免重定向跳转到内网或错误路径。
为什么需要 proxy_redirect
后端服务（如 Flask、Spring Boot、PHP）常基于自身监听地址生成重定向地址。例如：
- 后端监听
http://127.0.0.1:8080，返回Location: http://127.0.0.1:8080/login - 用户实际访问的是
https://example.com，Nginx 反向代理请求过去 - 若不改写，浏览器会跳转到不可达的
http://127.0.0.1:8080/login，导致失败
基本语法与常见用法
proxy_redirect 支持两种格式：
-
重写规则形式：
proxy_redirect http://127.0.0.1:8080/ https://example.com/; -
正则匹配形式：
proxy_redirect ~^http://[^/]+(/.*)$ https://example.com$1;
注意：
– 第一个参数是后端返回的原始 Location 值（可为字符串或正则）
– 第二个参数是替换后的目标前缀（支持 $1 等捕获组）
– 若设为 off，则完全禁用重写：proxy_redirect off;
典型配置示例
假设 Nginx 监听 https://api.example.com，反向代理到 http://10.0.1.5:3000：
FastAPI Flask Proxy
下载
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
location / {
proxy_pass http://10.0.1.5:3000/;
proxy_redirect http://10.0.1.5:3000/ https://api.example.com/;
proxy_redirect https://10.0.1.5:3000/ https://api.example.com/;
# 若后端可能混用 http/https，建议都覆盖
}
更健壮的做法是用正则统一处理：
proxy_redirect ~^(http|https)://[^/]+(.*)$ https://api.example.com$2;
这样无论后端返回 http://xxx 还是 https://xxx，都映射到正确的公网域名。
调试与注意事项
启用 proxy_redirect 后，可通过以下方式验证是否生效：
- 用
curl -I请求触发重定向的接口，检查响应头中Location是否已更新 - Nginx 日志中不会直接记录重写过程，但错误重写会导致 302 跳转失败
-
proxy_redirect必须放在proxy_pass所在的 location 块内，且仅对 301/302/307/308 响应生效 - 若后端返回相对路径（如
Location: /login），Nginx 默认不修改，无需配置proxy_redirect
