要通过 mod_proxy_http 实现请求转发，需启用代理模块并正确配置路径映射：先手动启用 mod_proxy 和 mod_proxy_http 模块，再在 VirtualHost 中设置 ProxyPass/ProxyPassReverse，注意 ProxyRequests Off、ProxyPreserveHost On 及路径一致性，HTTPS 或认证场景需额外启用 mod_proxy_ssl 并配置 SSLProxyEngine 和头信息透传。
要通过 mod_proxy_http 把请求转发到后端服务器，核心是启用代理模块 + 正确配置路径映射规则。整个过程不复杂，但几个关键点没配对或漏掉，就容易返回 404、跳转失败或头信息丢失。
确认并启用 mod_proxy_http 模块
这个模块不能靠默认开启，必须手动加载：
- Linux（如 Ubuntu/Debian）：运行
sudo a2enmod proxy proxy_http，再sudo systemctl restart apache2 - Windows（XAMPP/WAMP）：打开
httpd.conf，取消以下两行的注释：LoadModule proxy_module modules/mod_proxy.so LoadModule proxy_http_module modules/mod_proxy_http.so
- 重启 Apache（不是重载），用
apachectl -M | grep proxy或apache2ctl -M验证模块已加载
在虚拟主机中设置转发规则
直接在 <VirtualHost> 块里写 ProxyPass 和 ProxyPassReverse：
<VirtualHost *:80>
ServerName myapp.local
ProxyRequests Off
<Proxy *>
Require all granted
</Proxy>
ProxyPreserveHost On
ProxyPass /api http://10.20.30.40:8080/api
ProxyPassReverse /api http://10.20.30.40:8080/api
</VirtualHost>注意三点：
-
ProxyRequests Off是必须的，禁用正向代理，只保留反向代理能力 -
ProxyPreserveHost On让后端收到的Host头仍是myapp.local，而不是10.20.30.40，便于后端日志和路由识别 -
ProxyPass和ProxyPassReverse的路径结尾要严格一致（都带/或都不带），否则可能触发重定向跳转到后端原始地址
支持 HTTPS 后端或带认证的场景
如果后端是 https://api.example.com：
- 确保还启用了
mod_proxy_ssl（Linux 执行sudo a2enmod proxy_ssl；Windows 取消mod_proxy_ssl.so注释） - 在
<VirtualHost *:443>中加上SSLProxyEngine on -
ProxyPass目标直接写https://...即可
如果后端需要前端透传 Cookie、Authorization 等凭证：
CPA Update - Secure CLI Proxy API Maintenance
下载
安全更新和维护 CLI Proxy API（CPA）部署与配置。用于 CPA 镜像升级、配置变更、认证目录兼容修复、上线验证与回滚。适用于用户提到“CPA 更新/升级/配置改了/容器重建/回滚”等场景。
- 默认情况下这些头会自动传递，但某些旧版 Apache 或特殊配置下可能被过滤
- 可显式添加：
ProxyPass /api http://backend:8080/api ProxyPassReverse /api http://backend:8080/api RequestHeader set Authorization "%{HTTP:Authorization}e" env=HTTP_AUTHORIZATION Header edit Location ^http://backend:8080/ https://myapp.local/（后者用于修正后端返回的
Location重定向头）
常见问题快速排查
- 请求能进 Apache，但返回 503：检查后端服务是否监听、防火墙是否放行、
Require all granted是否生效 - 页面加载了 HTML，但 CSS/JS 404：确认后端返回的资源路径是否含绝对 URL（如
/static/app.css），若含完整域名，需用ProxyPassReverse或后端改用相对路径 - 浏览器报 CORS：说明前端仍直连后端——确保所有请求都走代理路径（如
/api/xxx），而非直接访问http://backend:8080/xxx
不复杂但容易忽略细节。
