Add Docker deployment support

- Add Dockerfile for containerization - Add docker-compose.yml for easy deployment - Add .dockerignore to optimize build - Add .env.example for environment configuration - Add DOCKER_DEPLOY.md with comprehensive deployment guide Support for: - Local Docker deployment - Cloud platforms (Render, Railway, Fly.io, GCP, AWS) - Persistent storage configuration - Health checks and monitoring
2025-10-06 02:17:37 +08:00
parent 6dca025e96
commit ad862f73d1
5 changed files with 354 additions and 0 deletions
--- a/.dockerignore
+++ b/.dockerignore
@@ -0,0 +1,18 @@
+node_modules
+npm-debug.log
+.git
+.gitignore
+README.md
+.env
+.DS_Store
+*.log
+auth.json
+a-req.txt
+a-req-err.txt
+a-res.txt
+o-req.txt
+o-req-err.txt
+o-res.txt
+o2-req.txt
+auth-res.txt
+todo.md
--- a/.env.example
+++ b/.env.example
@@ -0,0 +1,3 @@
+# API 认证配置
+# 从 Factory 获取你的 refresh token
+DROID_REFRESH_KEY=your_refresh_token_here
--- a/DOCKER_DEPLOY.md
+++ b/DOCKER_DEPLOY.md
@@ -0,0 +1,288 @@
+# Docker 部署指南
+
+## 本地 Docker 部署
+
+### 1. 准备环境变量
+
+创建 `.env` 文件（从 `.env.example` 复制）：
+
+```bash
+cp .env.example .env
+```
+
+编辑 `.env` 文件，填入你的 refresh token：
+
+```env
+DROID_REFRESH_KEY=your_actual_refresh_token_here
+```
+
+### 2. 使用 Docker Compose 启动
+
+```bash
+docker-compose up -d
+```
+
+查看日志：
+
+```bash
+docker-compose logs -f
+```
+
+停止服务：
+
+```bash
+docker-compose down
+```
+
+### 3. 使用原生 Docker 命令
+
+**构建镜像：**
+
+```bash
+docker build -t droid2api:latest .
+```
+
+**运行容器：**
+
+```bash
+docker run -d \
+  --name droid2api \
+  -p 3000:3000 \
+  -e DROID_REFRESH_KEY="your_refresh_token_here" \
+  droid2api:latest
+```
+
+**查看日志：**
+
+```bash
+docker logs -f droid2api
+```
+
+**停止容器：**
+
+```bash
+docker stop droid2api
+docker rm droid2api
+```
+
+## 云平台部署
+
+### Render.com 部署
+
+1. 在 Render 创建新的 Web Service
+2. 连接你的 GitHub 仓库
+3. 配置：
+   - **Environment**: Docker
+   - **Branch**: docker-deploy
+   - **Port**: 3000
+4. 添加环境变量：
+   - `DROID_REFRESH_KEY`: 你的 refresh token
+5. 点击 "Create Web Service"
+
+### Railway 部署
+
+1. 在 Railway 创建新项目
+2. 选择 "Deploy from GitHub repo"
+3. 选择分支：docker-deploy
+4. Railway 会自动检测 Dockerfile
+5. 添加环境变量：
+   - `DROID_REFRESH_KEY`: 你的 refresh token
+6. 部署完成后会自动分配域名
+
+### Fly.io 部署
+
+1. 安装 Fly CLI：
+   ```bash
+   curl -L https://fly.io/install.sh | sh
+   ```
+
+2. 登录：
+   ```bash
+   fly auth login
+   ```
+
+3. 初始化应用（在项目目录）：
+   ```bash
+   fly launch
+   ```
+
+4. 设置环境变量：
+   ```bash
+   fly secrets set DROID_REFRESH_KEY="your_refresh_token_here"
+   ```
+
+5. 部署：
+   ```bash
+   fly deploy
+   ```
+
+### Google Cloud Run 部署
+
+1. 构建并推送镜像：
+   ```bash
+   gcloud builds submit --tag gcr.io/YOUR_PROJECT_ID/droid2api
+   ```
+
+2. 部署到 Cloud Run：
+   ```bash
+   gcloud run deploy droid2api \
+     --image gcr.io/YOUR_PROJECT_ID/droid2api \
+     --platform managed \
+     --region us-central1 \
+     --allow-unauthenticated \
+     --set-env-vars DROID_REFRESH_KEY="your_refresh_token_here" \
+     --port 3000
+   ```
+
+### AWS ECS 部署
+
+1. 创建 ECR 仓库
+2. 推送镜像到 ECR
+3. 创建 ECS 任务定义
+4. 配置环境变量：
+   - `DROID_REFRESH_KEY`
+5. 创建 ECS 服务
+
+## 持久化配置
+
+如果需要持久化刷新的 tokens：
+
+### Docker Compose 方式
+
+修改 `docker-compose.yml`：
+
+```yaml
+services:
+  droid2api:
+    volumes:
+      - auth-data:/app
+      
+volumes:
+  auth-data:
+```
+
+### Docker 命令方式
+
+```bash
+docker volume create droid2api-data
+
+docker run -d \
+  --name droid2api \
+  -p 3000:3000 \
+  -e DROID_REFRESH_KEY="your_refresh_token_here" \
+  -v droid2api-data:/app \
+  droid2api:latest
+```
+
+## 健康检查
+
+容器启动后，可以通过以下端点检查服务状态：
+
+```bash
+curl http://localhost:3000/
+curl http://localhost:3000/v1/models
+```
+
+## 环境变量说明
+
+| 变量名 | 必需 | 说明 |
+|--------|------|------|
+| `DROID_REFRESH_KEY` | 是 | Factory refresh token，用于自动刷新 API key |
+| `NODE_ENV` | 否 | 运行环境，默认 production |
+
+## 故障排查
+
+### 容器无法启动
+
+查看日志：
+```bash
+docker logs droid2api
+```
+
+常见问题：
+- 缺少 `DROID_REFRESH_KEY` 环境变量
+- refresh token 无效或过期
+- 端口 3000 已被占用
+
+### API 请求返回 401
+
+**原因**：refresh token 过期或无效
+
+**解决**：
+1. 获取新的 refresh token
+2. 更新环境变量
+3. 重启容器
+
+### 容器频繁重启
+
+检查健康检查日志和应用日志，可能是：
+- 内存不足
+- API key 刷新失败
+- 配置文件错误
+
+## 安全建议
+
+1. **不要将 `.env` 文件提交到 Git**
+2. **使用 secrets 管理敏感信息**（如 GitHub Secrets、Docker Secrets）
+3. **定期更新 refresh token**
+4. **启用 HTTPS**（云平台通常自动提供）
+5. **限制访问来源**（通过防火墙或云平台配置）
+
+## 性能优化
+
+### 多阶段构建（可选）
+
+```dockerfile
+# 构建阶段
+FROM node:24-alpine AS builder
+WORKDIR /app
+COPY package*.json ./
+RUN npm ci
+
+# 生产阶段
+FROM node:24-alpine
+WORKDIR /app
+COPY --from=builder /app/node_modules ./node_modules
+COPY . .
+EXPOSE 3000
+CMD ["node", "server.js"]
+```
+
+### 资源限制
+
+在 docker-compose.yml 中添加：
+
+```yaml
+services:
+  droid2api:
+    deploy:
+      resources:
+        limits:
+          cpus: '1'
+          memory: 512M
+        reservations:
+          cpus: '0.5'
+          memory: 256M
+```
+
+## 监控和日志
+
+### 查看实时日志
+
+```bash
+docker-compose logs -f
+```
+
+### 导出日志
+
+```bash
+docker logs droid2api > droid2api.log 2>&1
+```
+
+### 集成监控工具
+
+可以集成：
+- Prometheus + Grafana
+- Datadog
+- New Relic
+- Sentry（错误追踪）
--- a/23
+++ b/23
@@ -0,0 +1,23 @@
+# 使用官方 Node.js 运行时作为基础镜像
+FROM node:24-alpine
+
+# 设置工作目录
+WORKDIR /app
+
+# 复制 package.json 和 package-lock.json
+COPY package*.json ./
+
+# 安装项目依赖
+RUN npm ci --only=production
+
+# 复制项目文件
+COPY . .
+
+# 暴露端口（默认3000，可通过环境变量覆盖）
+EXPOSE 3000
+
+# 设置环境变量
+ENV NODE_ENV=production
+
+# 启动应用
+CMD ["node", "server.js"]
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -0,0 +1,22 @@
+version: '3.8'
+
+services:
+  droid2api:
+    build: .
+    container_name: droid2api
+    ports:
+      - "3000:3000"
+    environment:
+      # 必需：设置refresh token
+      - DROID_REFRESH_KEY=${DROID_REFRESH_KEY}
+      # 可选：如果需要修改端口，在config.json中配置
+    volumes:
+      # 可选：持久化auth.json以保存刷新的tokens
+      - ./data:/app/data
+    restart: unless-stopped
+    healthcheck:
+      test: ["CMD", "wget", "--quiet", "--tries=1", "--spider", "http://localhost:3000/"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+      start_period: 40s