需先安装Node.js运行时并启用PM2插件,再配置运行用户、项目路径与入口文件,最后通过反向代理将域名请求转发至应用端口实现对外访问。

如果您希望在宝塔面板中快速搭建 Node.js 运行环境并使用 PM2 管理器部署项目,则需先安装 Node.js 运行时,再启用宝塔内置的 PM2 插件进行进程托管。以下是具体操作步骤:
一、通过软件商店安装 Node.js
宝塔面板提供图形化方式安装 Node.js,支持多版本共存,无需手动编译,适合大多数生产场景。
1、登录宝塔面板后台,点击左侧菜单栏的软件商店。
2、在搜索框中输入Node.js,找到官方提供的Node.js 版本管理器插件。
3、点击安装按钮,在弹出窗口中选择所需版本(如v18.19.0或v20.11.1),勾选安装 PM2 管理器选项后开始安装。
4、等待安装完成,页面显示“已安装”状态,此时 Node.js 命令和 npm 命令已全局可用。
二、启用并配置 PM2 管理器
PM2 管理器插件安装后需手动启用,并设置运行用户与工作目录,确保能正确加载项目入口文件。
1、安装完成后返回软件商店,找到PM2 管理器,点击设置按钮。
2、在配置页面中,将运行用户设为网站所属用户(如 www),避免权限不足导致启动失败。
3、确认Node.js 版本路径已自动匹配为刚安装的版本(例如 /www/server/nvm/versions/node/v20.11.1/bin/node)。
4、保存配置,返回 PM2 管理器主界面,点击添加项目按钮进入部署流程。
三、通过 PM2 部署 Node.js 项目
部署前需确保项目文件已上传至服务器指定目录,并具备可执行权限;PM2 将以守护进程方式持续运行应用。
1、点击添加项目,填写项目名称(如 my-node-app)和项目路径(如 /www/wwwroot/my-node-app)。
2、在启动文件字段中输入入口文件名(如 app.js 或 server.js),确保该文件位于项目根目录下。
3、在运行参数中可填写环境变量(如 NODE_ENV=production),多个变量用空格分隔。
4、点击提交,PM2 自动检测依赖并执行 npm install(若 package.json 存在且未安装 node_modules)。
5、启动成功后,状态栏显示运行中,并可查看实时日志、CPU 占用及内存使用情况。
四、手动安装 Node.js(备用方案)
当软件商店插件不可用或需自定义编译参数时,可通过 SSH 登录服务器,使用 NVM 工具安装指定版本 Node.js。
1、使用宝塔终端或 SSH 工具连接服务器,执行命令下载并安装 NVM:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
2、重新加载环境变量:
source ~/.bashrc
3、列出可安装版本:
nvm list-remote
4、安装指定版本(如 v16.20.2):
nvm install v16.20.2
5、设置默认版本:
nvm alias default v16.20.2
五、配置反向代理使项目对外访问
Node.js 应用默认监听本地端口(如 3000),需通过宝塔网站配置反向代理,将域名请求转发至该端口。
1、进入宝塔面板的网站列表,点击对应站点的设置。
2、切换到反向代理选项卡,点击添加反向代理。
3、目标 URL 填写http://127.0.0.1:3000(端口号需与项目实际监听端口一致)。
4、提交后,检查代理规则是否生效,访问域名即可加载 Node.js 应用页面。










