ggl/DEPLOYMENT.md

宝塔面板 NODE 项目部署说明

项目配置

端口配置

• 生产环境端口：4001
• 端口范围：4001-4010（可在宝塔面板中调整）

启动方式

方式一：直接启动（推荐用于宝塔面板）

npm run start
# 或
npm run start:bt

方式二：PM2 进程管理

# 安装 PM2（如果未安装）
npm install -g pm2

# 启动应用
npm run pm2:start

# 停止应用
npm run pm2:stop

# 重启应用
npm run pm2:restart

宝塔面板配置步骤

1. 创建 Node.js 项目

   • 在宝塔面板中选择「Node.js项目」
   • 项目路径：/www/wwwroot/ggl
   • 端口：4001（或4001-4010范围内任意端口）

2. 安装依赖

   npm install
   

3. 构建前端

   npm run build
   

4. 启动项目

   • 启动文件：start-production.cjs
   • 或使用启动命令：npm run start

环境变量配置

在宝塔面板的项目设置中添加以下环境变量：

NODE_ENV=production
PORT=4001
JWT_SECRET=your-production-jwt-secret-key-here

文件结构

/www/wwwroot/ggl/
├── api/                    # 后端 API
├── src/                    # 前端源码
├── dist/                   # 前端构建产物
├── uploads/                # 文件上传目录
├── logs/                   # 日志目录
├── database.db             # SQLite 数据库
├── start-production.cjs    # 生产环境启动文件
├── ecosystem.config.js     # PM2 配置文件
└── .env.production         # 生产环境配置

注意事项

1. 确保宝塔面板已安装 Node.js 环境（推荐 v18+）
2. 确保端口 4001 未被其他服务占用
3. 数据库文件 database.db 需要有读写权限
4. uploads 目录需要有写入权限
5. 如需修改端口，请同时修改以下文件：
   • api/server.ts
   • ecosystem.config.js
   • .env.production

故障排除

端口冲突

如果端口 4001 被占用，可以修改为 4002-4010 范围内的其他端口。

权限问题

确保项目目录及子目录有正确的读写权限：

chmod -R 755 /www/wwwroot/ggl
chown -R www:www /www/wwwroot/ggl

日志查看

• 应用日志：logs/ 目录
• PM2 日志：pm2 logs ggl-app
• 宝塔面板日志：在项目管理页面查看