proxy_redirect用于重写后端返回的location和refresh响应头中的绝对url，使其指向正确的前端地址；它按顺序匹配并替换，支持字面量、变量和正则，隐式规则默认存在，相对路径不生效，可显式配置或禁用。
在 Nginx 中，proxy_redirect 的作用是重写后端服务器返回的 Location 和 Refresh 响应头中的 URL，让客户端跳转到正确的前端地址，而不是暴露内部服务路径。它不改变请求路径，只改响应头里的重定向地址。
理解 proxy_redirect 的匹配逻辑
proxy_redirect 会按配置顺序逐条匹配响应头中 Location 的值（即重定向目标 URL），一旦匹配成功，就用右侧的值替换左侧的匹配部分。匹配支持字面量和变量，也支持正则表达式（以 ~ 或 ~* 开头）。
- 默认情况下，Nginx 会自动启用一条隐式规则：
proxy_redirect http://localhost:8080/ /;（若后端返回http://localhost:8080/api/login，会被改写为/api/login） - 显式配置优先于隐式规则；未匹配时，原
Location不变 - 若后端返回的是相对路径（如
/login），proxy_redirect不生效——它只处理绝对 URL
常见场景与配置写法
假设前端域名是 https://example.com，后端服务跑在 http://127.0.0.1:3000，且后端返回的重定向地址为 http://127.0.0.1:3000/dashboard，需将其改为 https://example.com/dashboard：
FastAPI Flask Proxy
下载
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
- 简单替换：
proxy_redirect http://127.0.0.1:3000/ https://example.com/; - 适配 HTTP/HTTPS 混合：用变量动态构造目标协议
proxy_redirect http://127.0.0.1:3000/ $scheme://$host/; - 处理带路径前缀的情况（如代理到
/app/下）： 后端返回http://127.0.0.1:3000/login，想映射为https://example.com/app/loginproxy_redirect http://127.0.0.1:3000/ https://example.com/app/;
禁用或绕过 proxy_redirect
某些后端（如 OAuth 授权回调）需要保持原始 Location 不变，或者由前端 JS 处理跳转，此时可关闭重写：
- 完全禁用：
proxy_redirect off; - 仅禁用某条规则（比如不想改写第三方跳转）：不配置对应匹配项，或用更精确的正则排除
- 注意：
off会同时禁用隐式规则，所有Location都原样透传
调试技巧与注意事项
如果重定向没生效，先确认三点：
- 后端返回的确实是绝对 URL（含协议+主机），否则
proxy_redirect不触发 - 检查 Nginx 日志中是否有
proxy_redirect匹配失败提示（开启error_log ... debug;可看到详细匹配过程） - 确保配置在
location块内，且该块实际被命中（例如proxy_pass指向了后端） - 避免重复配置：多个
proxy_redirect规则可能相互干扰，建议每 location 最多一条明确规则
