proxy_redirect用于修正后端返回的Location/Refresh响应头，将内网或错误跳转地址重写为公网可访问URL；支持前缀匹配、相对路径替换、正则提取及子路径纠偏，需严格匹配协议、域名和斜杠。
Nginx 的 `proxy_redirect` 不是为“处理 HTTPS 响应”而设，它只在后端返回 301/302/307 等重定向响应时，修正其中的 `Location` 和 `Refresh` 响应头——核心目标是把后端生成的、面向内网或私有端口的跳转地址（如 `http://localhost:3000/login`），替换成用户实际访问的公网可访问 URL（如 `https://example.com/login`）。HTTPS 场景下的关键难点，在于协议一致性、端口隐式省略、以及后端是否信任代理头。 以下从实操角度拆解最关键的几类纠正技巧：
确保协议自动适配：用相对替换 + X-Forwarded-Proto
后端若读取 X-Forwarded-Proto 判断当前协议，就能生成相对路径或协议中立的跳转；此时 Nginx 只需剥离内网 host 部分，让浏览器按当前页面补全：
- 在
location块中配置：proxy_set_header X-Forwarded-Proto $scheme; - 搭配：
proxy_redirect http://127.0.0.1:8080/ /;或proxy_redirect http://backend.local:3000/ /; - 效果：后端返回
Location: http://backend.local:3000/dashboard→ Nginx 改为Location: /dashboard→ 浏览器自动补成https://example.com/dashboard
直接硬编码 HTTPS 公网地址（适合生产环境）
当后端无法改造、或你要求跳转绝对可控时，显式写出目标协议和域名最稳妥：
- 确认后端返回的是完整绝对地址，例如：
Location: http://172.18.0.5:8080/callback - 配置：
proxy_redirect http://172.18.0.5:8080/ https://example.com/; - ⚠️ 注意：前后缀必须完全一致——
http://host/和http://host不匹配；https://example.com/末尾斜杠不能少，否则路径拼接出错
用正则统一提取路径，屏蔽所有内网变体
容器 IP、localhost、不同端口混用？一条正则覆盖全部：
WebChat Voice Proxy
下载
⚠️ 已弃用 — 该技能已拆分为两个独立技能，以提升模块化程度：**webchat-https-proxy**（HTTPS/WSS 反向代理）和 **webchat-voi...**
- 配置：
proxy_redirect ~^http://[^/]+(?::\d+)?/(.*)$ https://example.com/$1; - 解释：
—~^http://[^/]+(?::\d+)?/匹配任意 http 开头的 host+可选端口+斜杠
—(.*)$捕获路径部分（如login?next=/home）
—$1将其拼到目标域名后 - 兼容场景：后端返回
http://localhost:3000/api/auth、http://10.0.2.4:8000/logout、http://dev-server:9000/，全被映射为https://example.com/api/auth等
子路径代理下的路径前缀纠偏
比如 Nginx 配置了 location /admin/ { proxy_pass http://backend/; }，而后端返回 Location: /login，浏览器会跳到 https://example.com/login（丢失 /admin/）：
- 正确写法：
proxy_redirect / /admin/; - 原理：把以根路径开头的 Location（即
/login）替换成/admin/login - ⚠️ 若后端返回的是
Location: http://backend/login，则要用绝对匹配：proxy_redirect http://backend/ https://example.com/admin/;
