如何在 XAMPP 环境中通过 Apache 反向代理访问 Node.js 服务-php教程-PHP中文网

必须启用的Apache模块是mod_proxy.so和mod_proxy_http.so；若后端为HTTPS还需mod_proxy_connect.so，WebSocket代理则额外需mod_proxy_wstunnel.so。

如何在 xampp 环境中通过 apache 反向代理访问 node.js 服务

能访问，但必须手动启用 proxy 模块、配置 VirtualHost、且 Node.js 不能监听 80 端口——否则直接报错或 404。

必须启用的 Apache 模块有哪些

Apache 默认禁用所有代理能力，mod_proxy.so 和 mod_proxy_http.so 是最低要求；缺一不可。打开 XAMPP\apache\conf\httpd.conf，确认以下两行前面没有 #：

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

若 Node.js 后端是 HTTPS（如 https://localhost:3001），还需启用：

LoadModule proxy_connect_module modules/mod_proxy_connect.so
并在 VirtualHost 中加 SSLProxyEngine on

改完保存，重启 Apache；验证是否生效：在终端运行 httpd -M | findstr proxy（Windows）或 httpd -M | grep proxy（macOS/Linux），看到 proxy_module 和 proxy_http_module 均为 (shared) 才算成功。

反向代理规则必须写在 httpd-vhosts.conf 里

不要往 httpd.conf 底部硬塞 ProxyPass，容易污染主配置、难维护。正确位置是 XAMPP\apache\conf\extra\httpd-vhosts.conf，新增一个块：

<virtualhost>
    ServerName node.local
    ProxyPreserveHost On
    ProxyPass /api/ http://localhost:3000/api/
    ProxyPassReverse /api/ http://localhost:3000/api/
</virtualhost>

关键点：

arcgis-js

提供 ArcGIS Maps SDK for JavaScript 开发辅助，涵盖 2D/3D 地图视图、图层管理、数据可视化、空间分析等功能模块的参考和示例指导。

下载

ProxyPreserveHost On：确保 Node.js 收到的 Host 头仍是 node.local，不是 localhost:3000，否则路由或重定向会出错
/api/ 末尾斜杠必须严格对齐——ProxyPass /api/ 对应 http://localhost:3000/api/；若目标地址不带斜杠，/api/user 会被拼成 /apiuser，直接 404
ProxyPassReverse 必须与 ProxyPass 完全一致：它负责重写响应头里的 Location、Set-Cookie 等 URL，否则重定向会跳到 localhost:3000

Node.js 必须先跑在非 80 端口，且不能用 XAMPP Shell 启动

Apache 已占 :80，Node.js 再调 app.listen(80) 必然失败，报 EADDRINUSE。必须让 Node.js 监听其他端口（如 3000、5000）：

启动命令用系统 CMD 或 PowerShell，别用 XAMPP 控制面板自带的 Shell——它不加载你的系统 PATH，node 命令会找不到
验证 Node.js 是否真在跑：curl http://localhost:3000/health（假设有该接口），返回正常才继续
再测代理层：curl http://node.local/api/health，若返回同内容，说明代理通了

最后别忘了配 hosts：编辑 C:\Windows\System32\drivers\etc\hosts，加一行 127.0.0.1 node.local，否则浏览器根本解析不了这个域名。

WebSocket 代理要额外启用 mod_proxy_wstunnel

如果 Node.js 提供的是 ws:// 接口（比如 Socket.IO），普通 ProxyPass 会卡在握手阶段。必须启用：

LoadModule proxy_wstunnel_module modules/mod_proxy_wstunnel.so（在 httpd.conf 中取消注释）
配置时路径需明确指向 ws:// 协议：ProxyPass /ws/ ws://localhost:3000/ws/
仍需保留 ProxyPreserveHost On 和 ProxyPassReverse /ws/ ws://localhost:3000/ws/

最容易被忽略的是：模块启用后没重启 Apache，或者 WebSocket 配置里漏了 wss? 协议前缀，导致连接直接被拒绝而非超时。