要让apache用自定义页面接管5xx代理错误，需同时配置proxyerroroverride on和对应状态码的errordocument，并用proxypass /errors/ !排除错误页路径以防循环代理。

要让 Apache 用自定义页面接管后端崩溃导致的 5xx 错误（如 502、503），光开 ProxyErrorOverride On 是不够的——它默认不处理代理模块生成的错误，必须配合 ErrorDocument 显式声明，并防止错误页路径被再次代理。

必须显式配置每个目标状态码的 ErrorDocument

ProxyErrorOverride 本身不提供页面，只“允许”你覆盖代理错误；没配 ErrorDocument，它就完全不生效。你需要为想接管的每个状态码单独指定本地 URI：

• ErrorDocument 502 /errors/502.html
• ErrorDocument 503 /errors/503.html
• ErrorDocument 504 /errors/504.html

路径必须以 / 开头，是 Web 可访问的 URI（比如放在 /var/www/html/errors/ 下），不能是文件系统绝对路径，也不能是外部 URL。

CPA Update - Secure CLI Proxy API Maintenance

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

下载

关键：排除错误页路径，避免被 ProxyPass 拦截

如果主代理规则是 ProxyPass / http://backend/，而你的错误页路径是 /errors/，Apache 默认会把对 /errors/503.html 的请求也转发给后端，结果可能返回 404 或无限循环。必须加显式排除：

• ProxyPass /errors/ !（写在 ProxyPass / 之前）
• 确保该路径下所有资源（HTML/CSS/JS）由 Apache 直接服务，不依赖后端
• 页面内引用资源建议用根路径，例如 /errors/style.css，避免相对路径错位

确保响应状态码保持原值

浏览器是否显示自定义页，取决于响应头中的状态码是否匹配。Apache 默认维持原始 502/503 状态码，但如果你的错误页是 PHP 或其他动态脚本，需手动设置：

• PHP 中加：http_response_code(503);
• 静态 HTML 不用处理，Apache 自动保留原始状态码

作用域与配置位置要统一

ProxyErrorOverride 是目录级指令，生效范围取决于上下文：

• 写在 <virtualhost></virtualhost> 里，影响整个虚拟主机
• 不要分散写在多个 <location></location> 中——它不会跨 ProxyPass 边界生效
• 若同时有 /api/ 和 /admin/ 多个代理，应在同一层级统一开启 ProxyErrorOverride On