proxy_redirect用于修正后端返回的location响应头，使其适配公网路径；它仅修改location和refresh字段，需与proxy_pass配合且匹配严格，常见场景包括内网地址替换、相对路径补全及正则动态处理。
Nginx 在 location 块中配置 proxy_redirect，核心是让后端返回的 Location 响应头（比如 302 跳转地址）变成客户端能正常访问的公网路径，而不是暴露内网地址或错配子路径。
你得先明确：proxy_redirect 不改请求，只改响应头里的 Location 和 Refresh 字段；它不碰响应体，也不影响其他逻辑。规则写在 location 块里，必须和 proxy_pass 配合使用，且匹配逻辑非常严格——旧前缀必须和后端实际返回的字符串完全一致（协议、IP、端口、斜杠一个都不能差）。
✅ 明确后端返回的 Location 格式再写规则
用 curl -I 看真实值，例如：
curl -I https://example.com/login # 返回： # Location: http://127.0.0.1:3000/dashboard # 或 # Location: /auth/callback # 或 # Location: https://backend.local:8443/logout
根据这三类常见情况，对应配置：
后端返回绝对内网地址（最常见）
比如返回 Location: http://192.168.1.5:8080/admin
location /app/ {
proxy_pass http://192.168.1.5:8080/;
proxy_redirect http://192.168.1.5:8080/ https://example.com/app/;
}
- 注意：
proxy_pass末尾有/，表示剥离/app/后转发；proxy_redirect的 old_prefix 也必须带/，且和返回值一字不差。 - new_prefix 末尾也要带
/，否则/admin会变成https://example.com/appadmin（少斜杠就拼接错）。
后端返回相对路径，但你用了子路径代理
比如 Nginx 配置是 location /api/ { proxy_pass http://backend/; }，后端却返回 Location: /user/profile
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
location /api/ {
proxy_pass http://backend/;
proxy_redirect / /api/;
}
- 这条规则把所有以
/开头的跳转路径（如/user/profile）替换成/api/user/profile - 它不关心协议和域名，只做前缀替换，适合纯路径补全场景。
后端地址不固定（Docker/多环境常见）
可能返回 http://localhost:3000/xxx、http://app-dev:8080/xxx、http://10.0.2.15:3001/xxx
location / {
proxy_pass http://backend;
proxy_redirect ~^http://[^/]+(?::\d+)?/(.*)$ https://example.com/$1;
}
- 正则
~^http://[^/]+(?::\d+)?/(.*)$匹配任意http://host:port/开头的路径； -
$1捕获/xxx部分，拼到新域名后，结果是https://example.com/xxx； - 若需兼容 HTTPS 返回，改用
~^https?://[^/]+(?::\d+)?/(.*)$。
⚠️ 必须配合的 header 透传（否则后端仍可能生成错地址）
proxy_redirect 是兜底手段，真正治本要让后端自己生成正确跳转：
location /app/ {
proxy_pass http://backend/;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header X-Forwarded-Host $host;
proxy_set_header X-Forwarded-Prefix /app/; # 显式告知子路径，供后端拼接
proxy_redirect http://backend:8080/ https://$host/app/;
# 或用正则通用写法
# proxy_redirect ~^http://[^/]+(/.*)$ /app$1;
}
? 提示：
X-Forwarded-Prefix并非标准头，但 Spring Boot、Express、Flask 等主流框架支持读取它来构造重定向 URL，比硬靠proxy_redirect更健壮。
? 验证是否生效
- 执行
curl -I https://example.com/login，确认Location:值已变成预期地址； - 开启 Nginx 错误日志到
info级别：error_log /var/log/nginx/error.log info;
日志中出现
* redirected to ...表示规则命中并执行了替换； - 如果没变化，90% 是 old_prefix 和后端返回值不完全匹配（比如少了个冒号、端口不对、斜杠方向反了）。
不复杂但容易忽略：路径修正的本质是上下文对齐，proxy_redirect 是最后一道防线，头信息透传才是源头治理。
