Node 项目系统部署教程,宝塔面板一键搭建运行环境
林傲
作者 林傲
系统部署 2026/09/24 30 阅读 1 评论

Node 项目系统部署教程,宝塔面板一键搭建运行环境

0 0
该文章由 AI 生成,内容仅供参考,请注意甄别。

对于很多前端开发者来说,本地运行 Node 项目轻车熟路,但一旦涉及到线上服务器部署,往往会遇到环境配置繁琐、进程守护困难等问题。其实,借助宝塔面板强大的图形化管理功能,我们可以轻松实现一键搭建运行环境,让 Node 项目的部署变得简单高效。下面是详细的部署教程。

一、 服务器准备与宝塔面板安装

在开始之前,你需要准备一台纯净环境的 Linux 服务器(推荐 CentOS 或 Ubuntu)。通过 SSH 连接服务器,运行宝塔面板官方安装命令。安装完成后,终端会显示面板的访问地址、账号和密码。登录宝塔面板,首次进入时会提示安装 LNMP 或 LAMP 套件,这里我们可以按需选择,后续 Node 环境需要单独安装。

二、 一键安装 Node.js 环境管理器

宝塔面板提供了专门的 Node.js 环境管理器插件,免去了手动编译安装的烦恼。

  1. 登录宝塔面板,点击左侧菜单栏的“软件商店”。
  2. 在搜索框中输入“Node.js版本管理器”,找到该插件并点击“安装”。
  3. 安装完成后,点击“设置”,在弹出的窗口中选择你项目所需的 Node 版本(推荐选择 LTS 长期维护版),点击“安装”。等待版本安装完成,服务器就具备了 Node 运行环境。

三、 上传项目文件与安装依赖

  1. 点击左侧菜单栏的“文件”,进入默认的网站目录(如 /www/wwwroot)。
  2. 在该目录下创建一个文件夹,命名为你的项目名称。
  3. 将本地开发好的 Node 项目文件打包上传至该目录并解压。确保项目的入口文件(如 app.js 或 server.js)位于根目录下。
  4. 打开宝塔的“终端”,通过 cd 命令进入项目目录,执行 npm install 或 yarn install 安装项目依赖包。

四、 配置 PM2 进程守护

Node 项目直接运行的话,一旦关闭终端或遇到报错,进程就会退出,因此必须使用进程守护工具。宝塔面板内置了 PM2 管理器。

  1. 在宝塔“软件商店”中搜索并安装“PM2管理器”。
  2. 安装完成后点击“设置”,进入 PM2 面板。
  3. 点击“添加项目”,选择你的项目目录,填写启动文件名(如 app.js),并可自定义项目名称。
  4. 点击“提交”,PM2 会自动启动你的 Node 项目并守护进程。此时,你的项目已经可以在服务器的特定端口(如 3000 端口)上运行了。

五、 配置 Nginx 反向代理

Node 项目通常监听的是非 80/443 端口,而线上环境用户默认访问的是 80 端口,因此需要配置 Nginx 反向代理来实现域名访问。

  1. 点击左侧菜单“网站”,点击“添加站点”,输入你的域名,PHP版本选择“纯静态”,提交。
  2. 在网站列表中找到刚添加的域名,点击“设置”。
  3. 在左侧找到“反向代理”,点击“添加反向代理”。
  4. 代理名称随意填写,目标URL填写 http://127.0.0.1:3000(请将 3000 替换为你 Node 项目实际监听的端口),发送域名填写 $host,点击提交即可。

六、 总结

通过以上五个步骤,我们就利用宝塔面板完成了 Node 项目的完整部署。从环境搭建到进程守护,再到反向代理,宝塔面板将复杂的命令行操作转化为了直观的界面点击,极大地降低了部署门槛。如果你在部署过程中遇到端口未放行的问题,记得在宝塔面板的“安全”选项中放行对应的防火墙端口。

文章告知

访问者可将本网站提供的内容或服务用于个人学习、研究或欣赏,以及其他非商业性或非盈利性用途,但同时应遵守著作权法及其他相关法律的规定,不得侵犯本网站及相关权利人的合法权利。除此以外,将本网站任何内容或服务用于其他用途时,须征得本网站及相关权利人的书面许可,并支付报酬。

上一篇 网站系统部署全流程,域名解析 + Nginx 反向代理配置 2026/09/24 下一篇 生产服务器部署前必须做的几项安全配置 2026/10/06

Comments

评论与回复

1
正在加载评论...