一键部署 Node.js 应用的宝塔操作流程

一、准备工作

在开始部署前，请确保已完成以下准备工作：

1. 已安装最新版宝塔面板（推荐7.9+版本）
2. 服务器已配置好Nginx/Apache环境
3. 准备好Node.js项目代码（包含package.json）
4. 获取服务器SSH登录权限

二、安装Node.js环境

1. 登录宝塔面板，进入“软件商店”

2. 搜索”Node.js”并选择对应版本安装（建议LTS版本）

 通过SSH验证安装是否成功
node -v
npm -v

三、创建Node.js项目

1. 进入“网站” → 点击“添加站点”

2. 填写域名信息（无域名可先用IP访问）

3. 在“PHP版本”处选择“纯静态”

四、上传项目文件

1. 通过宝塔“文件”管理器上传项目压缩包

2. 解压到网站根目录（通常为/www/wwwroot/your_domain）

 示例目录结构
├── app.js
├── package.json
├── node_modules/
└── public/

五、一键部署配置

1. 进入“网站” → 选择对应站点 → “设置”

2. 切换到“Node项目”选项卡

3. 填写关键参数：

• 项目路径：选择网站根目录
• 启动方式：根据项目选择（app.js/index.js等）
• 端口号：建议使用3000+端口
• 运行用户：推荐使用www

六、依赖安装与启动

1. 通过SSH进入项目目录：

cd /www/wwwroot/your_domain
npm install --production

2. 返回宝塔面板点击“启动”按钮

3. 在“日志”选项卡查看实时运行日志

七、配置反向代理

1. 进入“网站” → “设置” → “反向代理”

2. 添加代理规则：

• 目标URL：http://127.0.0.1:你设置的端口
• 发送域名：$host

八、常见问题解决

1. 端口冲突

修改项目配置文件中的端口号，或在宝塔“安全”面板放行对应端口

2. 依赖安装失败

 清除缓存后重试
npm cache clean --force
rm -rf node_modules
npm install

3. PM2进程管理

建议安装宝塔“PM2管理器”插件实现进程守护

通过以上步骤，你的Node.js应用已经成功部署。宝塔面板的图形化操作大大简化了部署流程，特别适合需要快速上线的开发场景。