如何利用 Nginx proxy_redirect 自动修复后端 301 重定向中丢失的 SSL 端口号-Nginx-PHP中文网

Nginx自身触发301重定向时端口丢失，根本原因是其默认以监听端口（如80）构造Location头，而非客户端请求的外部端口（如8080）；需通过absolute_redirect off、port_in_redirect off和server_name_in_redirect off协同控制。

如何利用 nginx proxy_redirect 自动修复后端 301 重定向中丢失的 ssl 端口号

当后端服务（比如 Node.js、Django 或 Spring Boot）返回 301 重定向响应时，它通常基于自身监听的地址生成 Location 响应头，例如 http://localhost:8080/login 或 https://backend.example.com/dashboard/。如果这个后端跑在反向代理之后，而 Nginx 没有干预，浏览器就会直接跳转到那个内部或不带端口/协议的地址，导致失败——尤其是 HTTPS 场景下，端口 443 被省略是正常行为，但若后端错误地写了 http://... 或硬编码了非标准端口（如 :8443），问题就暴露了。

为什么后端 301 的 Location 会出错？

后端一般不知道自己被代理，也不清楚外部访问协议（HTTP/HTTPS）、域名和路径前缀。它只按 Host 请求头或自身配置拼接跳转地址。常见错误包括：

返回 http:// 地址，而用户实际通过 https:// 访问
返回带内部端口的地址，如 https://example.com:8443/callback
返回不含路径前缀的地址，比如代理路径是 /api/，但后端跳转成 /auth 而非 /api/auth

proxy_redirect 是怎么起作用的？

proxy_redirect 不修改请求，而是重写后端响应中 Location 和 Refresh 头的值。它在 Nginx 把响应发给客户端之前生效，属于“响应头改写”机制。

它的基本语法是：

proxy_redirect ;

aperture: the L402 aware reverse proxy

安装并运行 Aperture（Lightning Labs 的 L402 闪电反向代理），用于创建 L402 付费墙、配置付费 API 端点、为其他代理托管付费内容或测试 L402 认证流程。

下载

例如：

proxy_redirect http://localhost:8080/ https://$host/; —— 将后端返回的所有以 http://localhost:8080/ 开头的跳转，替换成 https://your-domain/
proxy_redirect ~^http://[^/]+(/.*)$ $1; —— 正则提取路径部分，丢弃原始 host 和协议，适配任意后端 host
proxy_redirect / /api/; —— 把相对跳转 /login 改成 /api/login（需配合 proxy_pass 路径截断使用）

修复 HTTPS + 端口丢失的关键配置

假设你用 Nginx 代理一个后端服务，用户访问 https://app.example.com/admin，后端运行在 http://127.0.0.1:3000，且它返回了 Location: http://127.0.0.1:3000/login。你需要三步闭环：

确保传给后端正确的协议：加 proxy_set_header X-Forwarded-Proto $scheme;
让后端生成的跳转至少是相对路径或协议中立地址（推荐后端配置为使用 X-Forwarded-Proto 判断协议）
用 proxy_redirect 强制修正最终输出：
proxy_redirect http://127.0.0.1:3000/ https://$host/;
或更健壮的写法：
proxy_redirect ~^http://[^/]+(?::\d+)?(/.*)?$ https://$host$1;