宝塔面板怎么多版本Node.js共存_利用PM2管理不同Node版本路径下的项目启动

轻强同学_5830

轻强同学_5830

2026-04-04

705人浏览

原创

能共存,但需绕过宝塔默认软链,用pm2显式指定node路径启动、项目级安装依赖、绝对路径配置开机自启。

宝塔面板怎么多版本node.js共存_利用pm2管理不同node版本路径下的项目启动

宝塔面板里装多个 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') 会找错地方。

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

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
node.js调试
node.js调试

node.js调试可以使用console.log()输出调试信息、断点调试和第三方调试工具。详细介绍:1、console.log()输出调试信息,通过在代码中插入console.log()语句,开发人员可以在控制台输出变量的值、函数的执行结果等信息,以便观察代码的执行流程和状态;2、断点调试,可以在代码中设置断点,以便在特定位置暂停代码的执行,观察变量的值和执行流程等。

2023.09.19

10009

8

JavaScript 全栈开发基础(Node.js + 前端)
JavaScript 全栈开发基础(Node.js + 前端)

本专题系统介绍 JavaScript 在全栈开发中的核心知识结构,涵盖 Node.js 基础、Express/Koa 接口构建、前端交互设计、模块化与包管理、数据库连接、前后端数据通信与部署流程。通过完整项目示例,帮助学习者掌握从浏览器到服务器的一体化开发能力,实现真正意义上的全栈入门。

2025.11.26

434

14

Node.js后端开发与Express框架实践
Node.js后端开发与Express框架实践

本专题针对初中级 Node.js 开发者,系统讲解如何使用 Express 框架搭建高性能后端服务。内容包括路由设计、中间件开发、数据库集成、API 安全与异常处理,以及 RESTful API 的设计与优化。通过实际项目演示,帮助开发者快速掌握 Node.js 后端开发流程。

2026.02.10

761

17

JavaScript Node.js流处理与高效数据管道构建实践
JavaScript Node.js流处理与高效数据管道构建实践

本专题聚焦 Node.js 在大规模数据处理场景中的应用,系统讲解 Stream 流机制、背压控制、管道(Pipe)处理以及文件与网络数据流的高效传输方式。内容包括可读流、可写流、双工流与转换流的实现原理,并结合实际案例构建高性能数据处理管道,帮助开发者提升数据处理效率与系统吞吐能力。

2026.04.07

304

13

TypeScript Node.js 全栈工程化与Monorepo架构实践
TypeScript Node.js 全栈工程化与Monorepo架构实践

本专题围绕 TypeScript 在 Node.js 全栈开发中的工程化实践展开,系统讲解 Monorepo 架构设计、包管理策略、模块复用机制以及服务端与前端统一类型系统的构建方法。通过真实项目案例,帮助开发者提升大型全栈项目的可维护性与协作效率。

2026.06.16

538

8

Kratos框架Protobuf接口定义与代码生成合集
Kratos框架Protobuf接口定义与代码生成合集

本专题讲解Kratos框架接口定义体系,涵盖proto编写规范、proto add/client/server生成命令、http注解路由、validate校验、OpenAPI文档生成、跨服务proto复用与兼容性设计。

2026.10.10

0

15

C++虚函数怎么定义和调用
C++虚函数怎么定义和调用

C++虚函数是实现运行时多态的重要机制。本专题从virtual关键字的基本用法入手,介绍基类与派生类之间的函数重写、基类指针调用派生类方法,以及动态绑定的执行过程,帮助初学者掌握虚函数的核心语法。

2026.10.10

0

26

C++类与对象的封装方法教程
C++类与对象的封装方法教程

C++封装是面向对象编程的核心特性之一,通过类将数据与操作数据的函数组织在一起,并利用访问权限控制外部访问。本专题介绍类的定义、成员变量、成员函数以及public、private和protected的使用方法,帮助初学者掌握封装的基本原理。

2026.10.10

0

32

C++构造函数定义与调用方法
C++构造函数定义与调用方法

C++构造函数用于初始化类对象,是面向对象编程的重要基础。本专题从构造函数的定义、声明和调用入手,介绍默认构造函数、带参数构造函数、拷贝构造函数及成员初始化列表,帮助初学者掌握对象创建与初始化的基本方法。

2026.10.10

0

16

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.6万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 133.4万人学习