需通过宝塔面板Node.js管理器安装多版本并为站点绑定:一、安装启用管理器;二、图形界面勾选安装LTS/稳定版;三、SSH用nvm命令行批量安装;四、网站设置中为各站点单独指定已装版本。

如果您在宝塔面板中需要为不同项目运行兼容特定版本的 Node.js,但当前仅安装了单一版本,则需通过 Node.js 管理器添加多个可切换的 Node.js 版本。以下是实现该目标的具体操作步骤:
一、确认Node.js管理器已安装并启用
Node.js 管理器是宝塔面板的第三方插件,必须先安装并启动才能进行多版本管理。未安装时,面板不会显示“Node.js 管理器”入口,也无法执行版本安装操作。
1、登录宝塔面板后台,点击左侧菜单栏的软件商店。
2、在搜索框中输入Node.js 管理器,找到对应插件。
3、若状态显示为“未安装”,点击安装按钮;若已安装但状态为“已停止”,点击启动。
4、安装或启动完成后,刷新页面,在左侧菜单栏底部确认出现Node.js 管理器条目。
二、使用管理器界面直接安装指定版本
Node.js 管理器提供图形化版本列表,支持一键下载、编译与安装多个长期支持(LTS)及最新稳定版,所有版本将被隔离存放,互不干扰。
1、点击左侧Node.js 管理器进入主界面。
2、在“可用版本”区域,勾选需要安装的多个版本(例如:v16.20.2、v18.20.4、v20.15.0)。
3、点击安装选中版本按钮,等待每项安装进度条完成。
4、安装成功后,各版本将出现在“已安装版本”列表中,并显示对应路径(如 /www/server/nvm/versions/node/v18.20.4)。
三、通过SSH命令行调用nvm批量安装
宝塔面板的 Node.js 管理器底层基于 nvm(Node Version Manager)实现,可通过终端手动执行 nvm 命令安装额外版本,适用于管理器界面未列出的版本或需要脚本化部署的场景。
1、在宝塔面板中打开终端(或使用 SSH 工具连接服务器)。
2、执行命令切换至 nvm 目录:cd /www/server/nvm。
3、加载 nvm 环境:source nvm.sh。
4、依次执行安装命令(每行安装一个版本):
nvm install 14.21.3
nvm install 16.20.2
nvm install 18.20.4
5、安装完成后,执行nvm list验证所有已安装版本是否可见。
四、为站点绑定指定Node.js版本
多个 Node.js 版本安装完毕后,需为每个使用 Node.js 的网站单独指定运行时版本,确保进程调用正确的二进制文件,避免版本冲突或模块兼容性错误。
1、进入宝塔面板,点击网站,选择目标站点,点击设置。
2、切换到Node.js选项卡(若未显示,请确认该站点已启用 Node.js 支持)。
3、在“Node.js 版本”下拉菜单中,选择已安装的某一版本(如v18.20.4)。
4、点击保存,系统将自动更新该站点的 Node.js 运行环境配置。
5、对其他站点重复上述步骤,可为每个站点独立分配不同版本(例如 A 站点用 v16,B 站点用 v20)。










