Apache与Node.js不能共用80端口，必须让Node.js运行在其他端口（如3000），再由Apache通过启用proxy模块并配置VirtualHost反向代理（如ProxyPass "/api/" "http://127.0.0.1:3000/"）实现协同。
为什么 Apache 默认端口不能直接代理 Node.js 服务
因为 listen EADDRINUSE: address already in use :::80 这类错误根本不是 Node.js 或 Apache “不兼容”，而是两者同时想独占 80 端口。XAMPP 启动后，Apache 已绑定 80（和 443），此时你在代码里写 app.listen(80) 必然失败。反向代理的前提是：Node.js 必须先在**其他端口跑起来**（比如 3000、5000），再由 Apache 把 /api/ 这类路径转发过去。
启用 Apache 的 proxy 模块并验证是否生效
不改模块，ProxyPass 配置就是摆设。打开 xampp/apache/conf/httpd.conf，确认以下四行前面没有 #：
LoadModule proxy_module modules/mod_proxy.so LoadModule proxy_connect_module modules/mod_proxy_connect.so LoadModule proxy_ftp_module modules/mod_proxy_ftp.so LoadModule proxy_http_module modules/mod_proxy_http.so
改完保存，重启 Apache。然后终端执行：httpd -M | findstr proxy（Windows）或 httpd -M | grep proxy（macOS/Linux），看到 proxy_module (shared) 和 proxy_http_module (shared) 才算真正启用。
Zenlink - Node SDK for ZenHeart
下载
ZenHeart zenlink 与 zenlink-mcp 为 OpenClaw，涵盖安装、MCP 注册、钩子接线、入站轮询及升级维护。
用 VirtualHost 配置反向代理路径（非全局 ProxyPass）
直接在 httpd.conf 里写 ProxyPass 容易污染主配置，推荐走虚拟主机。编辑 xampp/apache/conf/extra/httpd-vhosts.conf，追加：
<VirtualHost *:80>
ServerName localhost
DocumentRoot "D:/xampp/htdocs"
ProxyRequests Off
<Proxy *>
Require all granted
</Proxy>
ProxyPass "/api/" "http://127.0.0.1:3000/"
ProxyPassReverse "/api/" "http://127.0.0.1:3000/"
</VirtualHost>
-
ProxyPassReverse必须配，否则 Node.js 返回的Location响应头（如重定向）会暴露真实端口 - 路径末尾的
/不能省——/api和/api/行为完全不同，缺斜杠会导致子路径 404 - 如果 Node.js 服务启用了 HTTPS 目标（如
https://localhost:3001），还得加SSLProxyEngine on
Node.js 启动后如何验证代理是否通
别只刷浏览器看首页。分三步验证：
- 先确保 Node.js 确实运行：
curl http://127.0.0.1:3000/health（假设你有这个接口），返回正常才继续 - 再测代理层：
curl http://localhost/api/health，应得到和上一步完全一样的响应 - 最后查 Apache 日志：
xampp/apache/logs/access.log里应有"GET /api/health HTTP/1.1" 200记录；若出现502 Proxy Error，大概率是 Node.js 没启动，或端口/地址写错
跨域问题别指望代理解决——它只是把请求“换壳”发出去，真正的 CORS 头仍由 Node.js 服务自己控制。代理本身不添加、不修改响应头，这点容易被忽略。
