proxy_redirect 是 nginx 专用于重写后端返回的 location 和 refresh 响应头的指令，确保跳转地址为公网可访问路径；它不处理请求路径，仅修正重定向响应头，需严格匹配前缀、配合 proxy_pass 路径规则，并通过 curl 或 error_log 调试验证。
proxy_redirect 是 Nginx 反向代理中专用于修正后端重定向响应头的关键指令。它不改写请求路径，只处理上游服务返回的 Location 和 Refresh 响应头，确保浏览器跳转到公网可访问的地址，而不是内网 IP、本地端口或错误子路径。
什么时候必须用 proxy_redirect
当后端应用（如 Java Spring Boot、PHP、Node.js）执行重定向（HTTP 301/302）时，它通常基于自身监听地址生成 Location 头。例如：
- 后端运行在
http://192.168.1.10:8080，返回Location: http://192.168.1.10:8080/dashboard - 用户实际通过
https://app.example.com访问，Nginx 代理后若不改写，浏览器就会尝试打开内网地址，失败 - 后端返回相对路径
Location: /login，但 Nginx 配置了location /api/ { proxy_pass http://backend/; }，此时浏览器会跳到https://app.example.com/login（丢失/api/上下文），造成 404
三种核心配置方式及适用场景
精确替换（最常用、推荐初学者）
语法：proxy_redirect http://192.168.1.10:8080/ https://app.example.com/;
要求 old_prefix 与后端返回的 Location 前缀完全一致（协议、主机、端口、末尾斜杠缺一不可）。适用于后端地址固定、环境单一的场景。
正则匹配（应对多变内网地址）
语法：proxy_redirect ~^http://[^/]+(?::\d+)?/(.*)$ https://app.example.com/$1;
忽略原始协议、主机、端口，只提取路径部分 $1，再拼接到目标域名下。适合测试环境 IP 经常变动，或后端可能返回 http://localhost:3000/、http://dev-server:8000/ 等多种格式的情况。
相对路径替换（适配协议自动识别）
语法：proxy_redirect http://192.168.1.10:8080/ /;
将绝对 URL 的 host 部分剥离，变为相对路径。浏览器会基于当前页面的协议（http/https）、域名和端口自动补全。前提是后端返回的是绝对 URL，且你已在 Nginx 中设置 proxy_set_header X-Forwarded-Proto $scheme; 供后端读取。
⚠️ 已弃用 — 该技能已拆分为两个独立技能，以提升模块化程度：**webchat-https-proxy**（HTTPS/WSS 反向代理）和 **webchat-voi...**
与 proxy_pass 路径处理的联动细节
proxy_redirect 的匹配逻辑高度依赖 proxy_pass 末尾是否带斜杠：
-
proxy_pass http://backend;（无尾部斜杠）→ Nginx 原样转发完整路径，如/api/user→ 后端收到/api/user；此时后端返回的 Location 可能含/api/，proxy_redirect 的 old_prefix 需匹配该前缀 -
proxy_pass http://backend/;（有尾部斜杠）→ Nginx 剥离 location 匹配部分，如location /api/ { ... }+ 请求/api/user→ 后端收到/user；此时后端返回的 Location 通常是/user或http://.../user，proxy_redirect 应针对该精简后的路径设计
常见错误：location 配置为 /admin/，proxy_pass 写成 http://admin-svc（无斜杠），后端返回 Location: /admin/login，而 proxy_redirect 却设为 proxy_redirect / /admin/ —— 因为后端返回的是完整路径，这条规则不会生效。
调试与验证方法
启用详细日志定位问题：error_log /var/log/nginx/error.log info;
Nginx 在 info 级别下会记录 proxy_redirect 是否命中、如何改写，例如：proxy redirect http://192.168.1.10:8080/ -> https://app.example.com/
用 curl 直接验证响应头：curl -I https://app.example.com/login
检查返回的 Location: 是否已变成预期的公网地址。如果仍是内网地址，说明规则未触发，需核对：
- old_prefix 是否与后端实际返回的 Location 开头**逐字符一致**（注意大小写、端口、斜杠）
- 指令是否写在正确的 location 块中（proxy_redirect 作用域是 location，不是 server 或 http）
- 是否误用了
proxy_redirect off;关闭了所有重写
