如何将本地 Node.js 服务部署到宝塔面板:完整的部署指南

embedded/2025/2/12 9:11:16/
文章简介:

将本地开发的 Node.js 项目部署到线上服务器是开发者常见的工作流程之一。在这篇文章中,我将详细介绍如何将本地的 Node.js 服务通过宝塔面板(BT 面板)上线。宝塔面板是一个强大的服务器管理工具,具有简洁的 UI 和丰富的功能,适合用来管理服务器、部署应用程序和维护网站。


正文:

宝塔面板(BT)提供了方便的 Web 界面,简化了服务器管理和网站运维的流程。将本地 Node.js 服务部署到宝塔服务器,经过以下几个步骤即可轻松实现。

第一步:准备你的本地 Node.js 服务

在将服务部署到服务器之前,首先确保你的本地 Node.js 项目已经准备好,并且可以正常启动。

  1. 安装项目依赖
    如果还没有安装依赖,首先在项目根目录下执行以下命令:

    npm install
    
  2. 本地启动项目
    使用以下命令确保项目可以在本地成功运行:

    npm start
    

    或者:

    node app.js
    

    确保应用正常启动并没有报错,浏览器中可以正常访问。

  3. 配置项目端口
    检查你的 app.jsserver.js 文件,确保定义了服务监听的端口,比如:

    const port = process.env.PORT || 3000;
    app.listen(port, () => {console.log(`Server is running on port ${port}`);
    });
    
第二步:准备宝塔面板服务器

如果你已经在宝塔面板上配置了服务器,可以直接跳到下一步。如果还没有,则需要配置一台服务器并安装宝塔面板。

  1. 购买服务器
    登录阿里云、腾讯云等云服务商平台,选择合适的服务器配置(如 2vCPU、4G 内存),并购买服务器。

  2. 安装宝塔面板
    登录到你的服务器后,执行以下命令来安装宝塔面板:

    CentOS 系统:

    yum install -y wget && wget -O install.sh http://download.bt.cn/install/install_6.0.sh && sh install.sh
    

    Ubuntu/Debian 系统:

    wget -O install.sh http://download.bt.cn/install/install-ubuntu_6.0.sh && sudo bash install.sh
    

    执行安装脚本后,系统会提示安装成功,并给出宝塔面板的登录地址、账号和密码。

  3. 登录宝塔面板
    打开浏览器,访问安装成功时提示的面板地址,使用提供的账号密码登录宝塔。

第三步:安装 Node.js 运行环境

宝塔面板的强大之处在于它支持一键安装各种常用的运行环境。我们需要安装 Node.js 来运行我们的应用。

  1. 在宝塔面板中安装 Node.js

    • 打开宝塔面板的 软件商店
    • 在左侧栏中找到 运行环境,然后找到 Node.js
    • 选择你需要的 Node.js 版本,点击安装。
  2. 检查 Node.js 是否安装成功
    安装完成后,打开 终端SSH 工具(如 PuTTY),在命令行中输入以下命令,检查 Node.js 是否已成功安装:

    node -v
    

    如果显示 Node.js 的版本号,则安装成功。

第四步:上传你的 Node.js 项目

接下来,你需要将本地的项目文件上传到宝塔面板的服务器。

  1. 打包你的项目
    在本地项目目录下执行以下命令来打包项目:

    zip -r my-node-app.zip .
    
  2. 上传到服务器

    • 在宝塔面板中,点击左侧的 文件
    • 选择你想要存放项目的目录(通常是 /www 目录下),然后点击右上角的 上传 按钮,将 my-node-app.zip 文件上传到服务器。
    • 上传完成后,解压该压缩包,确保所有项目文件上传成功。
第五步:安装项目依赖
  1. 通过 SSH 登录服务器,进入到你的项目目录:

    cd /www/my-node-app
    
  2. 安装依赖
    执行以下命令,安装项目的依赖库:

    npm install
    

    这一步会自动读取 package.json 中的依赖并进行安装。

第六步:配置 PM2 管理 Node.js 服务

为了让你的 Node.js 服务能够持续运行,我们使用 PM2 来管理应用进程。PM2 是一个非常流行的 Node.js 进程管理工具,支持应用的自动重启和监控。

  1. 安装 PM2
    在服务器终端中,执行以下命令安装 PM2:

    npm install pm2 -g
    
  2. 启动你的 Node.js 服务
    使用 PM2 启动 Node.js 应用:

    pm2 start app.js --name "my-node-app"
    
    • app.js 是你应用的入口文件。
    • --name 参数为你的应用命名,方便在多个应用中管理。
  3. 设置开机自启
    为了确保服务器重启后,Node.js 服务可以自动启动,执行以下命令:

    pm2 startup
    pm2 save
    
第七步:配置 Nginx 反向代理

在宝塔面板中,我们可以通过 Nginx 反向代理将外部请求转发给 Node.js 服务。

  1. 安装 Nginx
    软件商店 中,找到 Nginx,选择安装。

  2. 配置 Nginx 反向代理

    • 在宝塔面板的左侧,点击 网站,然后点击 添加站点,填写你想绑定的域名和站点信息。
    • 添加完成后,点击站点的设置,找到 反向代理 选项。
    • 在代理目标填写 Node.js 监听的地址(如 http://127.0.0.1:3000),并启用反向代理。
  3. 保存配置并重启 Nginx
    配置完成后,保存并重启 Nginx,然后项目就运行成功了。
    在这里插入图片描述

第八步:测试和优化
  1. 测试服务
    打开你绑定的域名或服务器的 IP 地址,检查是否可以正常访问你的 Node.js 服务。

  2. 监控和调试
    使用 PM2 的日志功能来监控服务的状态和调试可能的问题:

    pm2 logs my-node-app
    
  3. SSL 配置(可选)
    如果需要配置 HTTPS,可以在宝塔面板的 SSL 选项中,使用 Let’s Encrypt 免费申请证书,并绑定到你的站点。


结语:

通过宝塔面板,你可以轻松将本地的 Node.js 服务部署到线上,并通过 PM2 和 Nginx 实现进程管理和反向代理。整个过程简单高效,即便是没有太多服务器管理经验的开发者,也能快速上手。

希望这篇指南能帮助你顺利将本地 Node.js 服务部署到宝塔面板中!


http://www.ppmy.cn/embedded/161561.html

相关文章

【SSH免密】Linux使用PublicKey公钥免密登录服务器

在SSH(Secure Shell)中,公钥(Public Key)和私钥(Private Key)是一对密钥,用于实现安全的身份验证和加密通信 公钥(Public Key):可以公开分发&…

如何利用DeepSeek开源模型打造OA系统专属AI助手

利用DeepSeek开源模型打造OA系统专属AI助手,可以显著提升办公效率,增强信息检索和管理能力。 注册与登录DeepSeek平台 访问DeepSeek官网 访问DeepSeek的官方网站DeepSeek。使用电子邮件或手机号码注册账号并登录。 获取API Key 登录DeepSeek平台&am…

3DTiles格式的文件可以用什么软件打开?

用DasViewer加载对应的json文件即可。 DasViewer是一款免费极速实景三维模型浏览器,采用多细节层次模型逐步自适应加载技术,让用户在极低的电脑配置下,也能流畅的加载较大规模实景三维模型,提供方便快捷的数据浏览操作。 目前DasViewer Beta 3.4.0版正式上线&…

Word2vec Skip-Gram 模型

图例 Skip-gram 模型,假设句子中的每个词都决定了相邻词的选取,所以你可以看到Skip-gram模型的输入是 W t W_{t} Wt​, 预测的输出是 W t W_t Wt​ 周边的词 也是说Skip-gram的目标是:给定一个中心词 W t W_t Wt​, 预测其上下…

DeepSeek系统崩溃 | 极验服务如何为爆火应用筑起安全防线?

引言 极验服务让您的产品站在风口之时,不必担心爆红是灾难的开始,而是期待其成为驱动持续创新的全新起点。 01现象级狂欢背后,你的业务安全防线抗得住吗? “近期DeepSeek线上服务受到大规模恶意攻击,注册可能繁忙&am…

将DeepSeek接入Excel实现交互式对话

引言 将DeepSeek接入Excel,为你带来前所未有的交互体验!“哪里不懂,选中哪里”,然后直接在侧边栏对话框向DeepSeek发问,非常地方便! 案例演示 设置接入方式 既可以通过本地部署的DeepSeek接入Excel&#…

Agent论文阅读:NormEnforcement with a Soft Touch: Faster Emergence, Happier Agents

摘要(ABSTRACT) 在多智能体系统(multiagent system, MAS)中,智能体之间的交互可通过社会规范(social norms)进行调节。通常,社会规范并非预设的规则(hardcoded rules&am…

HTML之JavaScript分支结构

HTML之JavaScript分支结构 if switch <!DOCTYPE html> <html lang"en"><head><meta charset"UTF-8"><meta name"viewport" content"widthdevice-width, initial-scale1.0"><title>Document</t…