本文详细介绍使用宝塔面板部署Node.js应用的完整流程，包括环境配置、项目上传、PM2管理及域名绑定等关键步骤，帮助开发者快速实现生产环境部署。
一、准备工作
在开始部署前，请确保已完成以下准备：
- 已安装最新版宝塔面板（推荐7.9+版本）
- 服务器已配置安全组规则（开放3000、80、443等端口）
- Node.js项目已完成本地开发和测试
二、安装Node.js环境
- 登录宝塔面板，进入「软件商店」
- 搜索「Node.js」并选择对应版本安装（建议LTS版本）
- 安装PM2管理器（用于进程守护）
验证Node.js安装
node -v
npm -v三、上传项目文件
通过以下任一方式上传项目：
- 方式1：宝塔文件管理器直接上传压缩包并解压
- 方式2：使用Git克隆项目（需提前安装Git）
Git克隆示例
git clone https://github.com/your-project.git
cd your-project
npm install四、配置PM2管理
- 打开宝塔「PM2管理器」
- 点击「添加项目」
- 填写项目信息：
- 项目路径：选择项目根目录
- 启动文件：一般为app.js或index.js
- 项目名称：自定义标识
- 点击「确认」启动项目
五、配置网站域名
- 在宝塔「网站」菜单点击「添加站点」
- 填写域名信息（可同时添加带www和不带www的域名）
- 在「网站目录」选择项目public文件夹（静态资源目录）
- 在「反向代理」选项卡添加代理：
- 代理名称：自定义
- 目标URL：http://127.0.0.1:3000（对应Node.js应用端口）
六、高级配置（可选）
1. 环境变量配置
在PM2管理界面点击「项目设置」→「环境变量」添加：
{
"NODE_ENV": "production",
"PORT": 3000
}2. HTTPS配置
- 在宝塔「网站」设置中申请SSL证书
- 开启「强制HTTPS」选项
- 在Node.js代码中添加HTTPS支持：
// 适配反向代理的代码片段
app.enable('trust proxy');七、常见问题排查
- 502错误：检查PM2进程是否正常运行，端口是否冲突
- 静态资源404：确认网站目录指向正确的public文件夹
- 性能优化：建议开启Nginx缓存和Gzip压缩
通过以上步骤，您已成功在宝塔面板部署Node.js应用。建议定期通过PM2查看日志监控应用状态，并设置定时任务进行项目备份。
评论