XAMPP环境下部署Node.js项目 XAMPP反向代理配置教程-php教程-PHP中文网

xampp需启用mod_proxy等模块并配置proxypass才能反向代理node.js服务；须修改httpd.conf启用模块、在httpd-vhosts.conf中设virtualhost规则、配置proxypreservehost和proxypassreverse、绑定hosts，否则将404或返回默认页。

xampp环境下部署node.js项目 xampp反向代理配置教程

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></directory> 或根 Location，而应在 httpd-vhosts.conf（路径通常是 XAMPP\apache\conf\extra\httpd-vhosts.conf）里新增一个 <virtualhost></virtualhost> 块，例如：

<virtualhost>
    ServerName node.local
    ProxyPreserveHost On
    ProxyPass /api http://localhost:3000/api
    ProxyPassReverse /api http://localhost:3000/api
    # 若需代理根路径（不推荐），可用：ProxyPass / http://localhost:3000/
</virtualhost>

关键点：

jm-jsjkxyjs02-pzl-803

查询全球任意城市的实时天气和未来天气预报

下载

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 教程都漏掉。