宝塔Node.js多版本共存与PM2管理教程

宝塔面板支持多版本Node.js共存，但并非开箱即用——它默认仅允许一个“系统默认”版本生效，其余版本需手动绕过软链接限制，通过PM2显式指定绝对路径的Node二进制文件启动应用；同时必须坚持项目级本地安装依赖（禁用全局npm install -g），并在开机自启时彻底脱离nvm shell环境，采用systemd服务或rc.local中硬编码的完整路径方案，才能确保不同Node版本（如v16与v18）的应用长期稳定、互不干扰地并行运行。

宝塔面板里装多个 Node.js 版本，到底能不能共存？

能，但不是靠宝塔自带的“软件商店”一键安装就能自动隔离——它默认只允许一个版本被设为“系统默认”，其他版本装完就躺在 /www/server/nvm/versions/node/ 里吃灰。真正让多版本共存生效的关键，是绕过宝塔的全局软链，改用 PM2 的 --node-args 或直接指定二进制路径启动。

PM2 启动时怎么指定某个 Node 版本？

别用 pm2 start app.js 这种默认命令，它永远走系统 PATH 里的第一个 node。必须显式传入目标 Node 可执行文件路径：

pm2 start /www/server/nvm/versions/node/v18.19.0/bin/node --name my-v18-app -- app.js

注意三点：

• --name 用于区分不同版本的进程，否则 PM2 会按脚本名去重，v16 和 v18 的同名项目可能互相 kill
• -- 是分隔符，后面才是传给 Node 的参数（比如 app.js、--port=3001）
• 路径必须写全，不能用 nvm use 16.20.2 && pm2 start...，因为 PM2 守护进程不继承 shell 的 nvm 环境

为什么用 nvm 安装的 Node 在 PM2 里找不到模块？

常见报错：Error: Cannot find module 'express'，即使 npm install 明明在项目目录下跑成功了。根本原因是：nvm 切换版本时，会动态修改 NODE_PATH 和 npm config get prefix，而 PM2 启动时没加载 nvm 的 shell 函数，导致 require() 找不到全局 link 的模块（比如用 npm install -g pm2 装的，其实也该避免全局装）。

解决办法只有两个：

• 所有依赖都用 npm install（不加 -g）装到项目 node_modules 下，这是最稳的
• 如果非要用全局模块（比如某些 CLI 工具），得手动把对应 Node 版本的 global node_modules 路径加进环境变量：
  NODE_PATH=/www/server/nvm/versions/node/v16.20.2/lib/node_modules

宝塔面板里怎么避免「重启后 PM2 进程消失」？

宝塔的“PM2管理器”插件本质是读取 ~/.pm2/dump.pm2 并调用 pm2 startOrReload，但它不会帮你记住你当初用的是哪个 Node 路径。一旦服务器重启或宝塔重载服务，它只会用默认 node 去拉起项目，大概率报错退出。

可靠做法是放弃宝塔的 PM2 图形界面，改用开机自启脚本：

echo "/www/server/nvm/versions/node/v18.19.0/bin/node $(which pm2) start /www/wwwroot/myapp/app.js --name myapp-v18" >> /etc/rc.d/rc.local

并确保 rc.local 有执行权限：chmod +x /etc/rc.d/rc.local。更稳妥的方案是用 systemd 写 service 文件，但要注意：systemd 不读用户级 nvm 配置，所以路径必须绝对写死，且 WorkingDirectory 必须设对，否则 require('./config') 会找错地方。

多版本共存本身不难，难的是每个环节都得断开对“默认环境”的依赖——从安装、启动、依赖管理到持久化，只要漏掉一处，项目就可能在某次更新后静默失败。

今天关于《宝塔Node.js多版本共存与PM2管理教程》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于的内容请关注golang学习网公众号！