XAMPP运行FlyWeb项目：配置Apache的反向代理（ProxyPass）指向Node应用-php教程-PHP中文网

xampp的apache默认不启用mod_proxy和mod_proxy_http模块，不配置会导致503或404错误；必须取消httpd.conf中对应loadmodule行的注释、重启服务，并在httpd-vhosts.conf中正确配置proxypass与proxypassreverse规则，路径末尾斜杠需严格一致，同时禁用缓存以防资源加载异常。

xampp运行flyweb项目：配置apache的反向代理（proxypass）指向node应用

直接说结论：XAMPP 的 Apache 默认不启用 mod_proxy 和 mod_proxy_http，不配就 503 或 404；ProxyPass 规则写错路径或没关缓存，前端资源会 404 或加载错；FlyWeb 这类前端+Node混合项目，必须让 Apache 代理到 Node 的实际端口（比如 3000），不能只改根目录。

确认并启用 mod_proxy 相关模块

XAMPP Windows 版（如 v8.2.x）默认禁用代理模块，httpd.conf 里它们是注释掉的。光写 ProxyPass 没用，Apache 启动会报错或静默忽略规则。

打开 C:\xampp\apache\conf\httpd.conf（Mac 对应路径为 /Applications/XAMPP/xamppfiles/etc/httpd.conf）

取消以下三行的注释（删掉开头的 #）：

LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_http_module modules/mod_proxy_http.so
LoadModule rewrite_module modules/mod_rewrite.so

mod_rewrite 虽非必需，但常和 ProxyPass 配合做路径重写或跳转，建议一并启用
保存后重启 Apache —— 不重启等于没配

在虚拟主机或主配置中添加 ProxyPass 规则

别把 ProxyPass 写在 .htaccess 里，它只在服务器级或虚拟主机上下文中生效。FlyWeb 通常前端走 /，API 走 /api，得按需拆分。

CPA Update - Secure CLI Proxy API Maintenance

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

下载

推荐在 httpd-vhosts.conf 中配虚拟主机，比如：

<virtualhost>
    ServerName flyweb.local
    DocumentRoot "C:/xampp/htdocs/flyweb"
<pre class="brush:php;toolbar:false;">ProxyRequests Off
ProxyPreserveHost On

# 前端静态资源仍由 Apache 提供（可选）
Alias /static "C:/xampp/htdocs/flyweb/dist/static"

# 所有 /api/* 请求代理到本地 Node 服务
ProxyPass /api http://127.0.0.1:3000/api
ProxyPassReverse /api http://127.0.0.1:3000/api

# 根路径 fallback 到前端入口（避免 Vue/React Router 404）
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ /index.html [L]

ProxyPreserveHost On 很关键：让 Node 收到原始 Host 头，否则 req.headers.host 变成 127.0.0.1:3000，影响 CORS 或路由判断
如果 Node 服务监听 localhost 而非 127.0.0.1，代理可能失败——统一用 127.0.0.1 更稳

绕过 Apache 缓存导致的资源加载失败

Apache 的 mod_cache（尤其 mod_disk_cache）有时会缓存 Node 返回的 JSON 或 HTML，造成前端反复加载旧数据、接口返回 500 或空白页。

检查 httpd.conf 是否启用了缓存模块：mod_cache、mod_disk_cache、mod_cache_socache —— 如果没主动需要，直接注释掉它们

在 ProxyPass 规则后加一行禁用缓存：

ProxyPass /api http://127.0.0.1:3000/api
ProxyPassReverse /api http://127.0.0.1:3000/api
CacheDisable /api

FlyWeb 的开发模式下，Node 服务通常不设 Cache-Control，Apache 会自作主张缓存响应体，这是最隐蔽的 404/500 来源之一

真正麻烦的不是写几行 ProxyPass，而是 Apache 和 Node 各自的 Host、Origin、Cookie 路径、HTTPS 升级头之间微妙的不匹配。尤其是 FlyWeb 这类带 WebSocket 或长连接的项目，mod_proxy_wstunnel 得额外启用，且 Node 必须显式接受升级请求 —— 这些细节不调通，页面能打开，但实时功能全挂。