first commit

DEPLOYMENT.md

@@ -0,0 +1,105 @@
+# 宝塔面板 NODE 项目部署说明
+
+## 项目配置
+
+### 端口配置
+- 生产环境端口：4001
+- 端口范围：4001-4010（可在宝塔面板中调整）
+
+### 启动方式
+
+#### 方式一：直接启动（推荐用于宝塔面板）
+```bash
+npm run start
+# 或
+npm run start:bt
+```
+
+#### 方式二：PM2 进程管理
+```bash
+# 安装 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. **安装依赖**
+   ```bash
+   npm install
+   ```
+
+3. **构建前端**
+   ```bash
+   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 范围内的其他端口。
+
+### 权限问题
+确保项目目录及子目录有正确的读写权限：
+```bash
+chmod -R 755 /www/wwwroot/ggl
+chown -R www:www /www/wwwroot/ggl
+```
+
+### 日志查看
+- 应用日志：`logs/` 目录
+- PM2 日志：`pm2 logs ggl-app`
+- 宝塔面板日志：在项目管理页面查看