对于很多前端开发者来说,本地运行 Node 项目轻车熟路,但一旦涉及到线上服务器部署,往往会遇到环境配置繁琐、进程守护困难等问题。其实,借助宝塔面板强大的图形化管理功能,我们可以轻松实现一键搭建运行环境,让 Node 项目的部署变得简单高效。下面是详细的部署教程。
一、 服务器准备与宝塔面板安装
在开始之前,你需要准备一台纯净环境的 Linux 服务器(推荐 CentOS 或 Ubuntu)。通过 SSH 连接服务器,运行宝塔面板官方安装命令。安装完成后,终端会显示面板的访问地址、账号和密码。登录宝塔面板,首次进入时会提示安装 LNMP 或 LAMP 套件,这里我们可以按需选择,后续 Node 环境需要单独安装。
二、 一键安装 Node.js 环境管理器
宝塔面板提供了专门的 Node.js 环境管理器插件,免去了手动编译安装的烦恼。
- 登录宝塔面板,点击左侧菜单栏的“软件商店”。
- 在搜索框中输入“Node.js版本管理器”,找到该插件并点击“安装”。
- 安装完成后,点击“设置”,在弹出的窗口中选择你项目所需的 Node 版本(推荐选择 LTS 长期维护版),点击“安装”。等待版本安装完成,服务器就具备了 Node 运行环境。
三、 上传项目文件与安装依赖
- 点击左侧菜单栏的“文件”,进入默认的网站目录(如
/www/wwwroot)。 - 在该目录下创建一个文件夹,命名为你的项目名称。
- 将本地开发好的 Node 项目文件打包上传至该目录并解压。确保项目的入口文件(如
app.js或server.js)位于根目录下。 - 打开宝塔的“终端”,通过
cd命令进入项目目录,执行npm install或yarn install安装项目依赖包。
四、 配置 PM2 进程守护
Node 项目直接运行的话,一旦关闭终端或遇到报错,进程就会退出,因此必须使用进程守护工具。宝塔面板内置了 PM2 管理器。
- 在宝塔“软件商店”中搜索并安装“PM2管理器”。
- 安装完成后点击“设置”,进入 PM2 面板。
- 点击“添加项目”,选择你的项目目录,填写启动文件名(如
app.js),并可自定义项目名称。 - 点击“提交”,PM2 会自动启动你的 Node 项目并守护进程。此时,你的项目已经可以在服务器的特定端口(如 3000 端口)上运行了。
五、 配置 Nginx 反向代理
Node 项目通常监听的是非 80/443 端口,而线上环境用户默认访问的是 80 端口,因此需要配置 Nginx 反向代理来实现域名访问。
- 点击左侧菜单“网站”,点击“添加站点”,输入你的域名,PHP版本选择“纯静态”,提交。
- 在网站列表中找到刚添加的域名,点击“设置”。
- 在左侧找到“反向代理”,点击“添加反向代理”。
- 代理名称随意填写,目标URL填写
http://127.0.0.1:3000(请将 3000 替换为你 Node 项目实际监听的端口),发送域名填写$host,点击提交即可。
六、 总结
通过以上五个步骤,我们就利用宝塔面板完成了 Node 项目的完整部署。从环境搭建到进程守护,再到反向代理,宝塔面板将复杂的命令行操作转化为了直观的界面点击,极大地降低了部署门槛。如果你在部署过程中遇到端口未放行的问题,记得在宝塔面板的“安全”选项中放行对应的防火墙端口。