proxy_redirect用于重写后端响应头中的location和refresh url以适配前端地址，仅修改响应头、不处理请求，支持字面量和正则匹配，可关闭或透传协议/主机头辅助正确重定向。
在 Nginx 中，proxy_redirect 用于重写后端服务器返回的响应头中 Location 和 Refresh 字段的 URL，使其适配前端 Nginx 的访问地址，避免重定向跳转到内网或错误端口。它不修改请求，只改响应头中的重定向地址。
proxy_redirect 的基本语法和匹配逻辑
proxy_redirect 按“原始值 → 替换值”方式工作，支持字面量匹配和正则匹配：
- 字面量形式：
proxy_redirect http://backend:8080/ /;表示把响应头中以http://backend:8080/开头的Location值，替换成/ - 正则形式：
proxy_redirect ~^http://[^/]+(/.*)$ $1;可剥离任意协议+域名，只保留路径部分 - 关闭重写：
proxy_redirect off;禁用所有重写（慎用，可能导致跳转失效）
常见场景：后端返回绝对路径导致跳转失败
例如后端 Spring Boot 应用返回 Location: https://192.168.1.100:8443/login?next=/home，用户无法访问该内网地址。此时可在 location 块中配置：
proxy_redirect https://192.168.1.100:8443/ https://example.com/;
CPA Update - Secure CLI Proxy API Maintenance
下载
安全更新和维护 CLI Proxy API（CPA）部署与配置。用于 CPA 镜像升级、配置变更、认证目录兼容修复、上线验证与回滚。适用于用户提到“CPA 更新/升级/配置改了/容器重建/回滚”等场景。
这样响应头就会变成 Location: https://example.com/login?next=/home，用户可正常跳转。
配合 proxy_set_header 实现协议与主机透传
proxy_redirect 默认只处理 Location 响应头，而重定向是否使用 https 或正确域名，还依赖后端是否信任 Nginx 的转发头。建议同步设置：
-
proxy_set_header X-Forwarded-Proto $scheme;告诉后端当前是 http 还是 https -
proxy_set_header Host $host;保证后端生成的重定向链接基于正确的 Host - 若后端基于
X-Forwarded-Proto构建重定向 URL，就可避免硬编码内网地址，减少对proxy_redirect的依赖
调试技巧：确认是否生效
用 curl -I 查看响应头，对比代理前后 Location 的变化：
- 直接访问后端：
curl -I http://192.168.1.100:8080/path记下原始Location - 通过 Nginx 访问：
curl -I https://example.com/path观察是否已被重写 - Nginx 错误日志中不会记录
proxy_redirect是否匹配，但若配置语法错误会启动失败，可用nginx -t验证
