proxypassreverse 的核心作用是重写后端响应头中的 url，使其匹配前端代理的域名和路径，解决 location 跳转错误和 set-cookie 域名不一致问题；它专门改写 location、content-location、uri 及 cookie 相关字段，需配合 proxypassreversecookiedomain 和 proxypassreversecookiepath 修正 cookie 的 domain 和 path。
当 Apache 用作反向代理时，后端服务返回的响应头（比如 Location、Set-Cookie）里常包含原始后端域名或路径，导致浏览器跳转错误或 Cookie 无法正确发送。这时 ProxyPassReverse 的核心作用就是重写这些响应头中的 URL，让它们匹配前端代理的域名和路径，从而解决域名不一致问题。
ProxyPassReverse 的基本原理
它不是修改页面内容，而是专门拦截并改写 HTTP 响应头中与重定向和 Cookie 相关的字段：
-
Location（301/302 跳转地址） Content-LocationURI-
Set-Cookie中的Domain和Path（需配合ProxyPassReverseCookieDomain和ProxyPassReverseCookiePath）
常见域名不一致场景及写法
假设你用 https://app.example.com 代理后端 http://127.0.0.1:8080，而后者返回 Location: http://localhost:8080/login 或 Set-Cookie: domain=localhost，就会出错。
正确配置示例：
ProxyPass / http://127.0.0.1:8080/ ProxyPassReverse / http://127.0.0.1:8080/
这会让 Apache 自动把响应头中所有出现 http://127.0.0.1:8080/ 的位置，替换成当前请求进入的协议+主机+路径（即 https://app.example.com/）。
如果代理路径有前缀（比如 /api/），必须严格对应：
安全更新和维护 CLI Proxy API（CPA）部署与配置。用于 CPA 镜像升级、配置变更、认证目录兼容修复、上线验证与回滚。适用于用户提到“CPA 更新/升级/配置改了/容器重建/回滚”等场景。
ProxyPass /api/ http://127.0.0.1:8080/ ProxyPassReverse /api/ http://127.0.0.1:8080/
注意末尾斜杠：前后都带斜杠才匹配准确，否则可能替换失败或误替换。
补充处理 Cookie 域名和路径
仅靠 ProxyPassReverse 不足以修正 Cookie 的 Domain 属性。后端设了 Domain=localhost，浏览器不会把它发给 example.com。
需额外加两行：
ProxyPassReverseCookieDomain localhost app.example.com ProxyPassReverseCookiePath / /api/
第一行把响应中 Set-Cookie: Domain=localhost 改成 Domain=app.example.com；第二行把 Path=/ 改为 Path=/api/，确保 Cookie 只在代理路径下生效。
调试技巧：确认是否生效
用 curl -I 查看真实响应头：
curl -I https://app.example.com/login
对比直接访问后端的结果，重点检查 Location 和 Set-Cookie 是否已被重写。若没变，可能是 ProxyPassReverse 路径不匹配、顺序写反（必须写在 ProxyPass 之后）、或后端返回的是绝对 URL 但格式与配置不一致（如混用 http://localhost 和 http://127.0.0.1）。
