proxypassreverse 用于重写响应头中的 location、content-location 和 uri 等字段，将后端真实地址替换为反向代理的对外地址，确保跳转和资源引用正常；它必须与 proxypass 成对出现且路径前缀及目标地址结尾斜杠保持一致。
ProxyPassReverse 的作用不是转发请求，而是重写响应头里的 Location、Content-Location 和 URI 等 HTTP 头字段。当后端服务器（比如 Tomcat、PHP-FPM 或另一个 Apache）返回 301/302 跳转或绝对路径链接时，这些地址默认指向后端真实地址（如 http://localhost:8080/login），用户直接访问会失败或暴露内网结构。ProxyPassReverse 就是把它们替换成反向代理的对外地址，确保跳转和资源引用正常。
基本写法与位置要求
必须和 ProxyPass 成对出现，且路径前缀一致；它不处理请求，只改响应头：
ProxyPass /app http://127.0.0.1:8080/ProxyPassReverse /app http://127.0.0.1:8080/
注意第二行末尾的斜杠 —— 它必须和 ProxyPass 后面的目标地址结尾保持一致（都带或都不带），否则重写可能出错。例如后端返回 Location: /login，Apache 会把它变成 /app/login；如果目标地址少写了斜杠，就可能拼成 /applogin。
常见错误场景与修复
以下情况容易被忽略，导致页面跳转 404 或样式丢失：
CPA Update - Secure CLI Proxy API Maintenance
下载
安全更新和维护 CLI Proxy API（CPA）部署与配置。用于 CPA 镜像升级、配置变更、认证目录兼容修复、上线验证与回滚。适用于用户提到“CPA 更新/升级/配置改了/容器重建/回滚”等场景。
- 后端应用硬编码了完整域名（如
https://internal.example.com/css/style.css）→ProxyPassReverse不处理这种绝对 URL，需改后端配置或用mod_substitute替换响应体 - 多个
ProxyPass共享同一后端，但ProxyPassReverse只写了一个 → 每个ProxyPass都要配对应的ProxyPassReverse - 用了路径重写（如
RewriteRule）但没同步调整ProxyPassReverse→ 建议优先用ProxyPass路径映射，避免混用规则
配合其他关键指令一起用
单靠 ProxyPassReverse 不够，实际部署中通常还需这几项：
-
ProxyPreserveHost On：让后端看到原始 Host 头，方便多租户或基于域名的逻辑 -
ProxyRequests Off：关闭正向代理功能，防止被滥用为开放代理 -
ProxyVia On（可选）：在响应头添加 Via 字段，便于链路追踪 - 必要时加
Timeout和ProxyTimeout，避免后端响应慢拖垮代理
一个完整可用的虚拟主机片段
假设你用 Apache 作为前端，代理到本地 3000 端口的 Node.js 应用：
<virtualhost>
ServerName example.com
ProxyPreserveHost On
ProxyRequests Off
<pre class="brush:php;toolbar:false;">ProxyPass / http://127.0.0.1:3000/
ProxyPassReverse / http://127.0.0.1:3000/
# 如果后端返回 Set-Cookie 的 Path=/admin，而你代理的是 /app/
# 可加这一行修正 Cookie 路径
ProxyPassReverseCookiePath / /app/
# 如需改 Cookie 域名（比如后端设了 domain=localhost）
ProxyPassReverseCookieDomain localhost example.com
改完记得 apachectl configtest 测试配置，再 systemctl reload apache2（或 httpd -k graceful）生效。
