如何在Cpanel/Whm环境下修改SSH使用的Node.js CLI版本
Cpanel/WHM环境下将SSH CLI Node.js版本切换为12+的操作方法
场景背景
Cpanel的Node.js应用设置菜单提供多版本Node.js选择项,可针对单个Node应用单独配置运行版本,但该配置仅作用于对应应用的运行沙箱,不会自动同步到SSH会话的默认CLI版本,常见表现为:后台已选择12+版本创建应用,但SSH登录后执行
node -v,返回的仍是系统默认的v8.17.0。
问题根源
Cpanel的多版本Node管理依赖内置的nvm工具实现,和Linux系统全局安装的Node.js包属于完全独立的两套环境,默认没有打通路径配置,因此SSH会话会优先调用系统目录下的老版本Node CLI。
操作步骤
- 核查可用的已安装Node版本
通过SSH登录服务器后,执行/usr/local/cpanel/3rdparty/bin/nvm ls,列出所有Cpanel后台菜单中已完成安装的Node版本,确认需要的12.x及以上版本已在清单内;如果清单中没有对应版本,可先通过WHM的Node.js版本管理界面完成目标版本的安装,再执行后续操作。 - 加载Cpanel内置的nvm运行环境
Cpanel内置的nvm安装在自定义目录,不会自动加载到普通SSH会话中,需依次执行两条命令完成环境加载:- 执行
export NVM_DIR="/usr/local/cpanel/3rdparty/var/nvm",配置nvm工作目录 - 执行
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh",将nvm脚本加载到当前会话
加载完成后,直接输入nvm能输出版本帮助信息,即代表环境配置正常。
- 执行
- 切换目标Node版本
若仅需要在当前SSH会话临时使用12+版本,执行nvm use 12即可,系统会自动匹配已安装的最高12.x小版本,替换当前会话下node、npm命令的指向路径。
若需要永久固定当前用户的默认CLI Node版本,在执行完切换命令后,再执行nvm alias default 12,后续新开的SSH会话都会默认使用该版本的Node CLI。 - 验证配置结果
执行node -v查看返回的版本号,确认是否已切换为目标12+版本,不再显示原来的v8.17.0。
- 管理员全局配置提示:如果是WHM管理员账号,无需逐用户操作,可直接在WHM的全局调整设置项中找到Node.js默认CLI版本配置,选择12+版本后全局生效,所有用户的SSH会话都会默认使用该版本,无需单独做路径适配。
内容的提问来源于stack exchange,提问作者Muhammad Dyas Yaskur
相关产品推荐
相关产品推荐

