nginx需主动重写后端返回的location头而非透传:用proxy_redirect修正跳转前缀,配合proxy_set_header传递真实请求头,并可拦截302统一处理;务必通过curl或浏览器开发者工具验证响应头是否生效。

核心是让 Nginx 主动改写后端返回的 Location 头,而不是直接透传内网地址或错误路径。关键不在“禁用跳转”,而在“重写跳转目标”。
用 proxy_redirect 修正跳转地址前缀
该指令专为处理 301/302 响应中的 Location 头设计,必须写在 location 块内,且与 proxy_pass 配套使用:
- 若后端返回
http://127.0.0.1:8080/login,想改为https://example.com/login,写:proxy_redirect http://127.0.0.1:8080/ /; - 若代理路径是
/admin/,但后端返回的是根路径跳转(如/dashboard),需补上前缀:proxy_redirect / /admin/;(末尾斜杠表示“完全替换匹配的路径”) - 支持正则动态适配多种内网地址(Nginx ≥ 1.11.8):
proxy_redirect ~^http://[^/]+(/.*)$ $scheme://$host$1;
传递真实请求上下文,防止后端再错生成
很多后端(Spring Boot、Django 等)会根据请求头自动生成跳转地址。不传对头,下次还是内网地址:
-
proxy_set_header Host $host;:避免后端把 Host 当成 localhost 或 IP -
proxy_set_header X-Forwarded-Proto $scheme;:告诉后端当前是 HTTP 还是 HTTPS,防止硬写http:// -
proxy_set_header X-Real-IP $remote_addr;和X-Forwarded-For $proxy_add_x_forwarded_for;:保障日志与安全逻辑准确
拦截并接管 302(统一加头或控制跳转)
当需要添加 CORS、或确保跳转始终留在同一域名下时,可让 Nginx 拦截 302 并自行响应:
- 启用拦截:
proxy_intercept_errors on;error_page 301 302 = @handle_redirect; - 定义处理块:
@handle_redirect {add_header Access-Control-Allow-Origin "$http_origin" always;add_header Access-Control-Allow-Credentials "true" always;return 302 $sent_http_location;}
验证是否真正生效
别只看配置有没有语法错误,要确认浏览器实际收到的响应头已被修改:
- 用
curl -I https://example.com/some-path查看返回的Location:是否已是公网地址 - 检查响应中是否含
X-Forwarded-Proto: https等关键头 - 打开浏览器开发者工具 → Network → 找到跳转请求,点开 Response Headers 查看原始值










