宝塔面板直接装Node.js会因路径、权限、环境变量不一致导致npm找不到、全局模块错位等问题；应改用nvm手动安装指定版本，并确保pm2在nvm激活环境下全局安装及启动，配合正确反向代理配置。
宝塔面板里直接装Node.js会踩哪些坑
宝塔面板自带的“软件商店”里点几下就能装 Node.js，但实际跑项目时大概率会出问题：路径不一致、权限不对、npm 命令找不到、全局模块装到错误位置——根本原因是宝塔默认用的是它自己编译的 Node 二进制，和系统 PATH、用户环境变量不联动，尤其当你需要配合 pm2 或使用 nvm 切换版本时，几乎必然失败。
所以别走快捷通道。真实可用的方式是：在宝塔的终端里，用用户身份（不是 root）手动装 nvm，再通过它装指定版本的 Node.js，最后用该环境启动 pm2。
用 nvm 安装 Node.js 并设为默认版本
登录宝塔终端（推荐用“SSH 终端”或“宝塔内置终端”，确保当前是你的网站部署用户，比如 www 或你创建的普通用户，**不要用 root**）：
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
安装完后，关闭并重开终端，或手动加载：source ~/.bashrc（如果用 zsh，则是 source ~/.zshrc）。验证是否生效：nvm --version 应该输出版本号。
-
nvm install 18.19.0（选 LTS 版本更稳，避免用最新奇数版） -
nvm alias default 18.19.0（设为默认，新终端自动激活） -
nvm use 18.19.0（立即切换，确认node -v和npm -v正确）
注意：nvm 安装的 Node 和 npm 全局路径在 ~/.nvm/versions/node/v18.19.0/bin，这个路径不会自动加进系统 PATH，但 nvm use 后当前 shell 是可用的——这点直接影响后续 pm2 能否找到 node。
PM2 必须用 nvm 激活后的环境全局安装
很多人装了 pm2 却启动失败，报错 command not found: pm2 或 Cannot find module 'node:fs'，本质是用了错误的 Node 环境执行 pm2。正确做法是：在 nvm use 激活好 Node 后，再全局安装：
npm install -g pm2
然后确认路径：which pm2 应该返回类似 /home/www/.nvm/versions/node/v18.19.0/bin/pm2。如果不是，说明 npm 没走对环境，可能之前装过系统级 pm2，得先 npm uninstall -g pm2 清掉。
启动项目时，也必须确保在同一个 shell 环境中运行：pm2 start ecosystem.config.js 或 pm2 start app.js。如果用宝塔“计划任务”或“网站监控”调用 PM2，它们默认不读 .bashrc，得显式加载环境：
- 写成完整命令：
source /home/www/.bashrc && pm2 start /www/wwwroot/myapp/app.js - 或者用
pm2 start的--interpreter指定解释器：pm2 start app.js --interpreter /home/www/.nvm/versions/node/v18.19.0/bin/node
宝塔网站配置与反向代理怎么配才不丢请求
Node.js 项目不能像 PHP 那样直接绑定到网站根目录。你得让项目监听一个本地端口（如 3000），再用宝塔的反向代理把域名流量转过去。关键点在于：
- 项目代码里
app.listen(3000, '127.0.0.1')—— 必须绑定127.0.0.1，不能是0.0.0.0（否则外网可直连，绕过宝塔防火墙和 SSL） - 宝塔网站 → “反向代理” → 添加，目标 URL 填
http://127.0.0.1:3000，务必勾选“启用反向代理”和“SSL 重定向”（如果你开了 HTTPS） - 如果项目里用了
req.headers.host或生成绝对 URL，要配好proxy_set_header Host $host;，宝塔默认已加，不用改；但若用pm2的express中间件做静态服务，注意静态路径别和宝塔网站根目录冲突
代理后常见 502 错误，优先检查：pm2 status 是否 online、netstat -tuln | grep :3000 是否真在监听、宝塔防火墙是否放行本地回环（一般不用动，但有些硬核安全策略会拦）。
真正麻烦的不是装，而是环境链路断在哪一环：nvm → node → npm → pm2 → 反向代理 → 请求头透传。漏掉任意一环，表现都是“项目不动”或“白屏”。尤其要注意宝塔后台操作（比如重启网站）不会自动 reload pm2 进程，得自己 pm2 reload 或加部署脚本。
