proxypass 本身不支持正则，需配合 locationmatch 实现正则代理；locationmatch 先匹配路径，再触发 proxypass 转发，并必须配 proxypassreverse 修正响应头；路径重写应使用 rewriterule + p 标志而非依赖 proxypass。
ProxyPass 本身不支持正则表达式，它只做前缀匹配；但配合 LocationMatch（支持 PCRE 正则），就能实现基于正则的代理路由控制。关键在于：把 ProxyPass 放在 LocationMatch 块内，由 LocationMatch 先完成路径匹配，再触发代理动作。
✅ 正确写法：用 LocationMatch 匹配路径，内部调用 ProxyPass
<locationmatch>
ProxyPass "http://backend-server:8080/"
ProxyPassReverse "http://backend-server:8080/"
</locationmatch>
说明：
-
^/api/v[1-3]/(users|posts)/.*$匹配如/api/v1/users/123、/api/v2/posts?limit=10等路径； -
ProxyPass后面的地址是目标后端服务的根路径，Apache 会自动将匹配到的原始路径（如/api/v1/users/123）完整拼接过去，即转发为http://backend-server:8080/api/v1/users/123； -
ProxyPassReverse必须同步配置，用于重写后端返回的Location、Content-Location等响应头，避免重定向跳转到后端地址。
⚠️ 注意事项
-
LocationMatch中的正则不捕获子组供ProxyPass直接引用（Apache 不支持类似$1的反向引用）； - 若需重写路径（比如去掉
/api/v2/前缀再代理），应搭配RewriteRule+P标志，而不是依赖ProxyPass； -
ProxyPass在<locationmatch></locationmatch>内生效，但不能和<location></location>混用同一路径，否则可能冲突； - 确保已加载
mod_proxy和mod_proxy_http模块：a2enmod proxy proxy_http
? 示例：带路径重写的正则代理（用 RewriteRule）
<locationmatch>
RewriteEngine On
RewriteRule "^/legacy/(.*)$" "/new-api/$1" [P]
ProxyPassReverse "/new-api/"
</locationmatch>
等效于：把 /legacy/users → 代理到后端 /new-api/users。
CPA Update - Secure CLI Proxy API Maintenance
下载
安全更新和维护 CLI Proxy API（CPA）部署与配置。用于 CPA 镜像升级、配置变更、认证目录兼容修复、上线验证与回滚。适用于用户提到“CPA 更新/升级/配置改了/容器重建/回滚”等场景。
注：
[P]表示使用 mod_proxy 处理，此时ProxyPass可省略，但ProxyPassReverse仍需保留以修正响应头。
❌ 常见错误
- 直接在
ProxyPass后写正则（无效）：ProxyPass "^/api/.*" "http://upstream/" # 错误！ProxyPass 不解析正则
- 忘记启用
ProxyPassReverse→ 导致 302 重定向暴露后端地址； -
LocationMatch正则太宽泛（如/.*/），覆盖了静态资源或 phpmyadmin，引发意外代理。
不复杂但容易忽略。
