proxypass路径映射必须斜杠对齐、顺序从具体到宽泛、配套proxypassreverse和proxypreservehost；斜杠缺失或顺序颠倒会导致404或跳转错乱，如/realpath/→http://backend/才正确转发路径。

ProxyPass 路径映射不是写对就行，而是得“对得刚好”——斜杠位置、顺序先后、前后端路径对齐，三者错一个就可能 404 或跳转错乱。

路径前后斜杠必须成对出现

Apache 根据斜杠有无决定是否剥离前缀。不一致就会多拼一层或少剥一层。

• /app/ → http://backend:8080/：访问 /app/static/logo.png，转发为 http://backend:8080/static/logo.png
• /app/ → http://backend:8080/myapp/：转发为 http://backend:8080/myapp/static/logo.png
• 错误写法：ProxyPass /app/ http://backend:8080（缺末尾斜杠）→ 实际请求变成 http://backend:8080/app/static/logo.png，后端根本收不到

规则顺序必须从具体到宽泛

Apache 自上而下匹配，命中即停，不继续检查。兜底规则不能放在最前面。

CPA Update - Secure CLI Proxy API Maintenance

安全更新和维护 CLI Proxy API（CPA）部署与配置。用于 CPA 镜像升级、配置变更、认证目录兼容修复、上线验证与回滚。适用于用户提到“CPA 更新/升级/配置改了/容器重建/回滚”等场景。

下载

• ✅ 正确示例：
  ProxyPass /admin/api/ http://admin:8080/
ProxyPass /user/profile/ http://user:9000/
ProxyPass /assets/ http://cdn:8081/
ProxyPass / http://app:3000/
• ❌ 错误示例：
  ProxyPass / http://app:3000/ ← 所有请求都被它吃掉
  ProxyPass /api/ http://api:8000/ ← 永远不会执行

必须配套 ProxyPassReverse 和 ProxyPreserveHost

只写 ProxyPass 是半截配置，后端返回的重定向和 Cookie 头会指向自己，而不是你的域名。

• ProxyPassReverse 路径前缀必须和 ProxyPass 完全一致（包括斜杠），用于改写 Location、Set-Cookie 等响应头
• ProxyPreserveHost On 让后端拿到原始 Host 请求头，避免生成错误的绝对链接
• 两者需写在同一作用域，比如都放在 <virtualhost></virtualhost> 或 <location></location> 块里

用 封装提升可读性

把 ProxyPass、ProxyPassReverse、ProxyPreserveHost 组在一起，逻辑清晰，调试方便。

• 示例：
  <location></location>
  ProxyPass http://admin-api:8080/
  ProxyPassReverse http://admin-api:8080/
  ProxyPreserveHost On
  
• 注意：<location></location> 不改变匹配逻辑，仍按配置顺序自上而下执行