XAMPP需启用mod_proxy等模块并配置ProxyPass才能反向代理Node.js服务；须修改httpd.conf启用模块、在httpd-vhosts.conf中设VirtualHost规则、配置ProxyPreserveHost和ProxyPassReverse、绑定hosts，否则将404或返回默认页。
XAMPP 本身不支持直接运行 Node.js 应用，也不能把 Node.js 当作 Apache 的模块加载；想让 XAMPP（Apache）为本地 Node.js 服务做反向代理，必须手动启用 Apache 的 mod_proxy 及相关模块，并严格配置 ProxyPass 规则——否则请求会 404 或直接返回 Apache 默认页。
确认 Apache 已启用 proxy 相关模块
Apache 默认禁用反向代理能力。需编辑 httpd.conf（通常在 XAMPP\apache\conf\httpd.conf），取消以下四行的注释（删除开头的 #）：
LoadModule proxy_module modules/mod_proxy.so LoadModule proxy_http_module modules/mod_proxy_http.so LoadModule proxy_connect_module modules/mod_proxy_connect.so LoadModule ssl_module modules/mod_ssl.so
⚠️ 注意：mod_ssl.so 仅在你要代理 HTTPS 目标（如 https://localhost:3001）时才必须启用；若只代理 HTTP（如 http://localhost:3000），可跳过这行。
改完保存，重启 Apache（通过 XAMPP Control Panel）。可在终端执行 httpd -M | findstr proxy（Windows）或 httpd -M | grep proxy（macOS/Linux）验证是否加载成功。
在虚拟主机中配置 ProxyPass 规则
不要直接改 <Directory> 或根 Location，而应在 httpd-vhosts.conf（路径通常是 XAMPP\apache\conf\extra\httpd-vhosts.conf）里新增一个 <VirtualHost> 块，例如：
<VirtualHost *:80>
ServerName node.local
ProxyPreserveHost On
ProxyPass /api http://localhost:3000/api
ProxyPassReverse /api http://localhost:3000/api
# 若需代理根路径（不推荐），可用：ProxyPass / http://localhost:3000/
</VirtualHost>关键点：
-
ProxyPreserveHost On：让后端 Node.js 收到的Host头仍是node.local，而非localhost:3000，避免路由/重定向出错 -
ProxyPassReverse必须与ProxyPass完全一致：它重写响应头中的Location、Set-Cookie等 URL，否则重定向会跳转到localhost:3000而不是node.local - 路径末尾斜杠必须统一：若
ProxyPass /api后目标带斜杠（http://localhost:3000/api/），则请求/api/user会被转成/api/user；若目标不带斜杠，则可能变成/apiuser—— 很容易 404
修改 hosts 文件并测试访问
Apache 不会自动解析 node.local，需手动绑定：
编辑系统 hosts 文件（Windows：C:\Windows\System32\drivers\etc\hosts；macOS/Linux：/etc/hosts），追加一行：
127.0.0.1 node.local
保存后，在浏览器访问 http://node.local/api/test，应得到 Node.js 服务的响应。若返回 503 或 “Service Temporarily Unavailable”，说明 Node.js 进程未运行或端口被占用；若返回 404 且日志里有 proxy: error reading status line from remote server，大概率是 ProxyPass 路径或目标地址写错了。
Apache 错误日志（XAMPP\apache\logs\error.log）是唯一可信依据，所有代理失败都优先查它。
为什么不用 XAMPP 自带的 PHP/CGI 方式跑 Node.js？
因为 Node.js 是独立进程，不是 CGI 脚本，不能靠 AddHandler 或 ScriptAlias 调用。有人尝试用 mod_proxy_fcgi，但那是为 PHP-FPM 设计的，对 Node.js 无效。强行混用只会触发 500 Internal Server Error 或 Apache 挂起。唯一正路就是 mod_proxy_http + 显式 ProxyPass。
真实项目里，ProxyPass 往往要配多段（如 /api、/uploads、/ws），且需注意 WebSocket 需额外加 ProxyPass /ws ws://localhost:3000/ws —— 这个细节，90% 的 XAMPP 教程都漏掉。
