proxy_redirect用于重写后端302响应中Location头的内网地址为公网域名，解决浏览器跳转404、HTTPS降级等问题；需配合proxy_set_header传递X-Forwarded-Proto等头，并确保配置在proxy_pass同级location块中。
当负载均衡器（如 Nginx）代理 Java Web 应用（如 Spring Boot、Tomcat）时，后端服务返回 302 Redirect 响应，其 Location 头中常包含**后端真实地址**（如 http://10.0.1.5:8080/login），而非用户访问的公网域名。浏览器直接跳转该地址，导致页面打不开、HTTPS 降级、跨域失败或路径错乱——这正是 proxy_redirect 要解决的核心问题。
为什么需要 proxy_redirect
默认情况下，Nginx 不会修改后端返回的 Location、Refresh 或 Content-Location 响应头。这些头由后端应用生成，通常基于其自身监听地址构建，与客户端实际访问入口完全不一致。若不重写，重定向将“逃逸”出代理层，破坏请求链路完整性。
proxy_redirect 的基本用法
在 location 块或 upstream 对应的 proxy_pass 后配置，格式为：
proxy_redirect [旧前缀] [新前缀];
常见组合示例：
aperture: the L402 aware reverse proxy
下载
安装并运行 Aperture（Lightning Labs 的 L402 闪电反向代理），用于创建 L402 付费墙、配置付费 API 端点、为其他代理托管付费内容或测试 L402 认证流程。
- 后端返回
Location: http://localhost:8080/api/xxx→ 改为https://api.example.com/api/xxx：proxy_redirect http://localhost:8080/ https://api.example.com/; - 后端返回
Location: /login?next=/admin（相对路径）→ 无需重写，可设为proxy_redirect off;或留空（Nginx 默认处理相对路径） - 统一将所有
http://重定向强制升级为https://（适用于全站 HTTPS）：proxy_redirect http:// https://;
Java 应用常见 Location 错误场景及修复
Spring Boot + Tomcat 默认可能返回含内网 IP 或端口的重定向。需结合后端配置与 Nginx 双向治理：
-
后端主动适配：在
application.yml中启用远程地址识别：server.forward-headers-strategy: native
并确保反向代理（如 Nginx）透传X-Forwarded-Proto和X-Forwarded-Host头 -
Nginx 强制重写：若后端无法修改，直接在
location中覆盖：proxy_set_header X-Forwarded-Proto $scheme;proxy_set_header X-Forwarded-Host $host;proxy_redirect ~^http://[^/]+(/.*)$ $scheme://$host$1;（正则方式，动态替换） -
避免重复重定向：确认未在多个层级（如 CDN + Nginx + 应用）重复设置
proxy_redirect，否则可能造成https://example.com/https://example.com/...嵌套
验证与调试技巧
用 curl -I 检查响应头是否生效：
curl -I https://your-domain.com/login
观察返回的 Location: 是否已变为预期的公网地址。若仍为内网地址，检查：
- 配置是否位于正确的
location块内（必须与proxy_pass同级） - 是否被更外层的
proxy_redirect off;覆盖 - 后端是否返回了绝对 URL ——
proxy_redirect仅作用于绝对 URL，对相对路径（如/home）无效
