feat: Implement initial full-stack application structure including frontend pages, components, hooks, API integration, and backend services for account pooling and management.

2026-01-30 07:40:35 +08:00
commit f4448bbef2
106 changed files with 19282 additions and 0 deletions
--- a/DOCKER.md
+++ b/DOCKER.md
@@ -0,0 +1,162 @@
+# Codex Pool Docker 部署指南
+
+## 架构
+
+前后端一体化部署，Go 后端嵌入前端静态文件，单一容器运行。
+
+```
+┌─────────────────────────────────────────┐
+│              Codex Pool                 │
+│  ┌─────────────────────────────────┐    │
+│  │   Frontend (嵌入)                │    │
+│  │   - React SPA                   │    │
+│  └─────────────────────────────────┘    │
+│  ┌─────────────────────────────────┐    │
+│  │   Backend (Go)                  │    │
+│  │   - API 服务                    │    │
+│  │   - Chromium 浏览器自动化       │    │
+│  │   - SQLite 数据库               │    │
+│  └─────────────────────────────────┘    │
+│                 :8848                   │
+└─────────────────────────────────────────┘
+```
+
+## 快速开始
+
+### 1. 创建数据目录
+
+```bash
+mkdir -p data
+```
+
+### 2. 构建并启动
+
+```bash
+# 构建镜像并启动
+docker-compose up -d --build
+
+# 查看日志
+docker-compose logs -f
+```
+
+### 3. 配置 (通过 Web 界面)
+
+首次启动后，访问 Web 界面进行配置：
+
+1. 打开 http://localhost:8848
+2. 进入 **系统配置**
+3. 配置 S2A API 地址和 Admin Key
+4. 配置邮箱服务
+5. 根据需要启用代理
+
+**配置自动保存到数据库，无需重启服务。**
+
+## 常用命令
+
+```bash
+# 停止服务
+docker-compose down
+
+# 重启服务
+docker-compose restart
+
+# 查看状态
+docker-compose ps
+
+# 重新构建并启动
+docker-compose up -d --build
+
+# 进入容器
+docker-compose exec codex-pool sh
+```
+
+## 配置说明
+
+### 环境变量
+
+| 变量 | 默认值 | 说明 |
+|------|--------|------|
+| `PORT` | 8848 | 服务端口 |
+| `BIND_HOST` | 0.0.0.0 | 绑定地址 |
+| `TZ` | Asia/Shanghai | 时区 |
+
+### 数据持久化
+
+| 路径 | 说明 |
+|------|------|
+| `./data/codex-pool.db` | SQLite 数据库 (包含配置) |
+
+### 代理配置
+
+在 Web 界面中配置代理：
+- 进入 系统配置 → 核心配置
+- 开启 **代理设置** 开关
+- 填入代理地址，如 `http://host.docker.internal:7890`
+
+## 生产环境建议
+
+### 1. 使用反向代理
+
+使用 Nginx/Caddy/Traefik 提供 HTTPS：
+
+```nginx
+server {
+    listen 443 ssl;
+    server_name codex-pool.example.com;
+    
+    ssl_certificate /path/to/cert.pem;
+    ssl_certificate_key /path/to/key.pem;
+    
+    location / {
+        proxy_pass http://127.0.0.1:8848;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+    }
+}
+```
+
+### 2. 资源限制
+
+```yaml
+services:
+  codex-pool:
+    deploy:
+      resources:
+        limits:
+          cpus: '2'
+          memory: 2G
+```
+
+### 3. 日志管理
+
+```yaml
+services:
+  codex-pool:
+    logging:
+      driver: "json-file"
+      options:
+        max-size: "10m"
+        max-file: "3"
+```
+
+## 故障排查
+
+### 浏览器自动化失败
+
+检查 Chromium 是否正常：
+```bash
+docker-compose exec codex-pool chromium-browser --version
+```
+
+### 无法连接代理
+
+确保代理配置正确并已启用：
+```bash
+docker-compose exec codex-pool curl -v --proxy http://host.docker.internal:7890 https://www.google.com
+```
+
+### 数据库检查
+
+```bash
+docker-compose exec codex-pool ls -la /app/data/
+```