NodeBB 必须独立运行于 Node.js（如端口4567），不可嵌入 XAMPP 的 Apache；Apache 仅处理 PHP 项目，两者通过不同端口共存，严禁在 httpd.conf 中 ProxyPass 或修改 CORS 暴露 PHP 接口。
NodeBB 不能直接跑在 XAMPP 的 Apache 下，它必须用 Node.js 独立运行；XAMPP 和 NodeBB 共存没问题，但得明确分工：Apache 处理 PHP 项目（如论坛后台、静态页），NodeBB 用 node 启动并监听独立端口（比如 4567），两者不混用同一服务进程。
为什么不能把 NodeBB 塞进 Apache 的 httpd.conf 里
NodeBB 是基于 Express 的 Node.js 应用，不是 PHP 脚本，也不支持 mod_php 或 mod_proxy 直接托管（本地开发阶段更不该强上反向代理）。强行在 httpd.conf 里加 ProxyPass 或改 DocumentRoot 到 NodeBB 目录，只会导致 403、502 或白屏——因为 Apache 根本不会执行 app.js，它只负责转发或返回文件内容。
- NodeBB 启动后自带 HTTP 服务器，不需要 Apache “加载”它
- XAMPP 的
httpd.conf里写ProxyPass / http://localhost:4567/是可行的，但仅限于你真想用 Apache 当入口网关——而本地调试时，这纯属增加故障点 - Windows 下 XAMPP 的 Shell 按钮启动的终端常不读系统 PATH，
node -v可能报错，这不是 NodeBB 问题，是环境变量没继承
NodeBB 正确启动方式（绕过 XAMPP Shell）
直接用系统终端启动 NodeBB，和 XAMPP 完全解耦。确认 node 和 npm 在系统 PATH 中：
根据 package.json 中的 engines 字段自动检测 Node.js 版本需求，未安装 nvm 时自动安装并切换至对应版本。支持 Windows、macOS、Linux。适用于 Node.js 项目开发、版本切换和环境配置。
- 打开 CMD 或 PowerShell，运行
where node和where npm，路径应类似C:\Program Files\nodejs\node.exe，而非D:\xampp\... - 进 NodeBB 项目目录，执行
npm install（首次），再运行./nodebb start（Linux/macOS）或nodebb start（Windows） - 默认监听
http://localhost:4567，不用改 Apache 的Listen或VirtualHost - 若要换端口，在
config.json里改"port": 4567即可，无需碰 XAMPP 配置
多端口共存时的实际访问路径怎么写
只要端口不冲突，XAMPP（Apache 默认 80 或你设的 8080）和 NodeBB（如 4567）就能同时开着互不干扰：
-
http://localhost→ XAMPP 的 PHP 项目（如 phpMyAdmin 或你的 htdocs 下站点） -
http://localhost:4567→ NodeBB 论坛首页 -
http://localhost:8080→ 另一个 Apache 虚拟主机（比如你配的blog.test） - 别在 hosts 文件里给 NodeBB 绑域名（如
forum.test）再指向127.0.0.1:4567—— 浏览器不认端口号在 hosts 映射里，那样会访问失败
跨域请求被拦？别动 Apache 的 Access-Control-Allow-Origin
如果前端（比如另一个 Vue 项目）调 NodeBB API 报 CORS 错误，解决方式是：
- 在 NodeBB 后端配置里开 CORS：编辑
config.json，确保"cors": { "origin": ["http://localhost:3000"] }存在且正确 - 绝对不要去改 XAMPP 的
httpd.conf加Header set Access-Control-Allow-Origin "*"—— 这会让所有 PHP 接口暴露给任意网站，有安全风险 - NodeBB 自带的
nodebb-plugin-cors插件已足够，无需额外中间件
最易忽略的一点：NodeBB 的 config.json 里 url 字段必须填你实际访问它的地址（如 "http://localhost:4567"），否则头像、静态资源路径会 404——这个值不是 Apache 的域名，也不是 XAMPP 的根路径，就是 NodeBB 自己监听的那个完整 URL。
