proxypassreverse用于重写后端返回的location等响应头，将内网地址（如http://app:8080/login）替换为客户端实际访问的公网路径（如https://app.example.com/login），需与proxypass严格配对，路径、协议、主机名、端口必须完全一致。
在容器化环境（如 docker、kubernetes）中用 apache 做反向代理时，后端服务常以容器名或内部服务名暴露（如 http://app:8080），而客户端访问的是公网域名（如 https://app.example.com）。proxypassreverse 的作用就是把后端返回的 302/301 响应头中的内网地址（比如 location: http://app:8080/login）自动替换成用户实际访问的公网路径（如 location: /login 或 location: https://app.example.com/login）——前提是配置精准、协议对齐、头信息透传到位。
必须严格配对 ProxyPass 和 ProxyPassReverse
两者第一个参数（路径前缀）和第二个参数（后端地址）必须完全一致，包括末尾斜杠、协议、主机名、端口：
- ✅ 正确示例（Docker Compose 中 service 名为
backend）：
ProxyPass /api/ http://backend:8080/
ProxyPassReverse /api/ http://backend:8080/ - ❌ 错误写法：
ProxyPass /api http://backend:8080/
ProxyPassReverse /api/ http://backend:8080/（路径不一致，无法匹配） - 若后端监听 HTTPS（如
https://backend:8443），且返回的 Location 是https://backend:8443/callback，ProxyPassReverse 第二个参数也必须写成https://backend:8443/，不能省略协议或端口
让后端感知真实协议和域名
容器里运行的 Java、Node.js 或 Python 应用，若未配置信任代理头，会默认生成 HTTP 地址或使用容器内网名。Apache 需主动传递关键信息：
- 强制声明当前是 HTTPS：
RequestHeader set X-Forwarded-Proto "https" - 透传原始 Host，避免后端拼出
http://backend：
ProxyPreserveHost On - 补充 IP 来源（可选但推荐）：
RequestHeader set X-Forwarded-For "%{REMOTE_ADDR}e"
后端框架需启用对应支持：Spring Boot 加 server.forward-headers-strategy=framework；Express 用 app.set('trust proxy', true)；Django 配置 SECURE_PROXY_SSL_HEADER。
安全更新和维护 CLI Proxy API（CPA）部署与配置。用于 CPA 镜像升级、配置变更、认证目录兼容修复、上线验证与回滚。适用于用户提到“CPA 更新/升级/配置改了/容器重建/回滚”等场景。
多服务或多路径需分别配置
一个 Apache 实例代理多个容器服务时（如 auth、api、static），每条 ProxyPass 必须有专属 ProxyPassReverse：
- ProxyPass /auth/ https://auth-svc:8443/
ProxyPassReverse /auth/ https://auth-svc:8443/ - ProxyPass /api/ http://api-svc:3000/v1/
ProxyPassReverse /api/ http://api-svc:3000/v1/ - 注意：第二条中后端路径含
/v1/，ProxyPassReverse 也必须带这个前缀，否则无法替换Location: http://api-svc:3000/v1/users
验证与常见陷阱
直接用 curl 检查后端真实响应，再比对 Apache 输出：
- 执行：
curl -v https://app.example.com/login
观察响应头中Location:字段内容，确认是否仍含容器名或内网地址 - 检查 Apache 是否启用了必要模块：
a2enmod proxy proxy_http headers - 避免硬编码绝对 URL：后端代码中尽量用
response.sendRedirect("/dashboard")（相对路径），而非"http://backend:8080/dashboard"——后者 ProxyPassReverse 无法修正
