ProxyPassReverse 通过精确前缀匹配替换后端响应中 Location、Content-Location 和 URI 头的绝对 URL，将内网地址（如 http://127.0.0.1:8080/login）改为客户端访问的公网地址（如 https://new.com/login），需严格配置后端原始地址，配合 ProxyPreserveHost 和 X-Forwarded-Proto 才能正确适配域名变更。
ProxyPassReverse 的作用不是“自动适应域名变更”，而是按配置规则精确替换响应头中的 URL 前缀。它本身不感知域名变化，也不会动态推导新域名——你必须明确告诉它：后端返回的哪个地址，要替换成客户端看到的哪个公网地址。只要配置与后端实际返回值严格匹配，就能在域名切换（比如从 http://old.com 改为 https://new.com）时，让重定向始终落在新域名下。
ProxyPassReverse 如何应对域名变更
- 它只处理后端响应中
Location、Content-Location和URI这三个 HTTP 响应头里的绝对 URL - 替换逻辑是字符串前缀匹配 + 替换，不是 DNS 解析或智能识别
- 所以“域名变更”生效的前提，是你同步更新了
ProxyPassReverse指令中的目标地址（即后端原始地址），并确保它和后端真实返回的一致
例如：
后端 Tomcat 返回 Location: http://127.0.0.1:8080/login
你想让用户跳到 https://new.com/login，而不是旧的 https://old.com/login
→ 你不需要改 ProxyPassReverse 的“输出部分”，因为 Apache 会自动用当前请求的协议+域名+路径拼接；
→ 你只需确保 ProxyPassReverse 的第二参数（后端地址）写对了：
ProxyPassReverse / http://127.0.0.1:8080/
Apache 就会把 http://127.0.0.1:8080/login → 自动转成 https://new.com/login（基于当前 Host 和 X-Forwarded-Proto）
配置要点：让域名变更真正生效
更新虚拟主机的
ServerName和证书绑定
确保<VirtualHost *:443>中的ServerName new.com已设置，并加载了对应 SSL 证书保留
ProxyPreserveHost On
让原始 Host 头（如new.com）传给后端，避免后端因收到localhost而生成错误跳转-
显式传递协议信息（HTTPS 必须）
RequestHeader set X-Forwarded-Proto "https" RequestHeader set X-Forwarded-Port "443"
后端（如 Spring Boot）需启用代理头支持，否则可能仍生成
http://开头的 Location
CPA Update - Secure CLI Proxy API Maintenance下载安全更新和维护 CLI Proxy API（CPA）部署与配置。用于 CPA 镜像升级、配置变更、认证目录兼容修复、上线验证与回滚。适用于用户提到“CPA 更新/升级/配置改了/容器重建/回滚”等场景。
检查后端是否硬编码域名
如果后端代码里写了response.sendRedirect("http://old.com/logout")，ProxyPassReverse 完全无效
✅ 正确做法：用相对路径（/logout）或基于X-Forwarded-*动态构建 URL
多域名共存时的处理方式
比如同时支持 old.com 和 new.com，都代理到同一后端：
- 不要用一个
ProxyPassReverse兼容两个域名（它不负责输出域名） - Apache 会自动根据当前请求的
Host和协议生成对外 URL，无需额外配置 - 只需确保：
- 两个
<VirtualHost>分别配置了各自的ServerName - 每个都启用
ProxyPreserveHost On和RequestHeader set X-Forwarded-Proto -
ProxyPassReverse的后端地址保持一致（如http://127.0.0.1:8080/）
- 两个
这样，访问 https://old.com/app 触发重定向 → 变成 https://old.com/success
访问 https://new.com/app 触发重定向 → 自动变成 https://new.com/success
验证是否生效的最简方法
用 curl 直接看响应头：
curl -I https://new.com/login
观察返回的 Location: 是否已是 https://new.com/...
如果不是，优先检查：
- 后端实际返回的 Location 值（用
-v查看完整响应） -
ProxyPassReverse路径和协议是否与该值完全一致 -
mod_proxy和mod_proxy_http是否已启用 - 配置是否写在当前生效的
<VirtualHost>块内
不复杂但容易忽略
