宝塔部署Node.js及PM2教程详解

本文详细介绍了如何在宝塔面板中一站式完成Node.js环境搭建与PM2项目部署，涵盖图形化安装Node.js多版本、启用并配置PM2管理器、上传项目并自动安装依赖、实时监控进程状态，以及通过反向代理将本地端口应用无缝映射至域名实现公网访问——全程无需命令行操作（支持备用NVM手动安装），兼顾新手友好性与生产环境稳定性，助你5分钟内上线一个高可用的Node.js Web服务。

如果您希望在宝塔面板中快速搭建 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 应用页面。

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