Apache虚拟主机中配置ProxyPass需启用mod_proxy、mod_proxy_http等模块，配对使用ProxyPass/ProxyPassReverse，严格匹配路径斜杠，开启ProxyPreserveHost On，并正确处理HTTPS后端及X-Forwarded头。
在 apache 虚拟主机中用 proxypass 把特定请求转发到不同后端容器，关键在于路径匹配精准、模块启用完整、代理头处理得当。不是加几行就能通，得按逻辑分步配。
必须启用的代理模块
Apache 默认不开启代理功能，XAMPP 或标准安装都需要手动激活以下模块（在 httpd.conf 中取消注释）：
-
mod_proxy.so—— 代理基础框架 -
mod_proxy_http.so—— 处理 HTTP/HTTPS 后端转发（最常漏掉，会导致 503 或 404） -
mod_proxy_connect.so—— 若后端是 HTTPS，必须启用，并配合SSLProxyEngine on -
mod_headers.so—— 后续加 CORS 或自定义请求头时需要
虚拟主机内配置 ProxyPass 规则
把规则写在 <virtualhost></virtualhost> 块里，路径顺序很重要：长路径优先，避免被短路径规则提前截断。例如要同时代理 /api 和 /admin 到不同容器：
<VirtualHost *:80> ServerName example.com ProxyRequests Off ProxyPreserveHost On <h1>先匹配更具体的路径</h1><p><Proxy /api/> Require all granted </Proxy> ProxyPass /api/ <a href="https://www.php.cn/link/9173175d480c3122372779e1ea1441d5">https://www.php.cn/link/9173175d480c3122372779e1ea1441d5</a> ProxyPassReverse /api/ <a href="https://www.php.cn/link/9173175d480c3122372779e1ea1441d5">https://www.php.cn/link/9173175d480c3122372779e1ea1441d5</a></p><p><Proxy /admin/> Require all granted </Proxy> ProxyPass /admin/ <a href="https://www.php.cn/link/a78ea664e2643a7f2e51ef826c077ab2">https://www.php.cn/link/a78ea664e2643a7f2e51ef826c077ab2</a> ProxyPassReverse /admin/ <a href="https://www.php.cn/link/a78ea664e2643a7f2e51ef826c077ab2">https://www.php.cn/link/a78ea664e2643a7f2e51ef826c077ab2</a></p><h1>根路径可指向默认容器</h1><p>ProxyPass / <a href="https://www.php.cn/link/648065d6b81ecfa8cc16a36a1aadb0a1">https://www.php.cn/link/648065d6b81ecfa8cc16a36a1aadb0a1</a> ProxyPassReverse / <a href="https://www.php.cn/link/648065d6b81ecfa8cc16a36a1aadb0a1">https://www.php.cn/link/648065d6b81ecfa8cc16a36a1aadb0a1</a> </VirtualHost>
注意：/api/ 和 http://.../ 结尾的斜杠必须对齐，否则路径拼接错位（如变成 http://x/api//user）。
WebChat Voice Proxy
下载
⚠️ 已弃用 — 该技能已拆分为两个独立技能，以提升模块化程度：**webchat-https-proxy**（HTTPS/WSS 反向代理）和 **webchat-voi...**
转发到 HTTPS 容器的特别处理
如果后端容器跑在 HTTPS（比如 Docker 内启了 TLS 的服务），需额外两步：
- 在
<virtualhost></virtualhost>内加上SSLProxyEngine on - 若后端证书非权威签发（如自签名），加
SSLProxyVerify none和SSLProxyCheckPeerCN off（仅限测试环境）
否则会报 500 Proxy Error 或连接被拒绝。
常见问题与应对
转发后页面加载失败、跳转错乱、Cookie 丢失？多半是下面几个点没配好：
-
ProxyPassReverse缺失 → 后端返回的Location、Set-Cookie响应头不会重写，浏览器跳转仍指向原始后端地址 -
ProxyPreserveHost On没开 → 后端容器收不到原始 Host 头，可能影响多租户或虚拟主机识别 - CORS 报错 → Apache 不自动加跨域头，前端访问
example.com/api仍被拦，可在 VirtualHost 内用Header set Access-Control-Allow-Origin "*"临时解决（生产建议由后端控制） - 静态资源 404 → 检查后端是否期望带前缀路径（如容器内路由为
/static/，而你转发的是/api/static/），必要时用ProxyPassMatch或RewriteRule做路径改写
