services:
  postgres:
    image: postgres:18
    container_name: claude-code-hub-db
    restart: unless-stopped
    ports:
      - "35432:5432"
    environment:
      POSTGRES_USER: ${DB_USER:-postgres}
      POSTGRES_PASSWORD: ${DB_PASSWORD:-postgres}
      POSTGRES_DB: ${DB_NAME:-claude_code_hub}
    volumes:
      - postgres_data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U ${DB_USER:-postgres} -d ${DB_NAME:-claude_code_hub}"]
      interval: 5s
      timeout: 5s
      retries: 10
      start_period: 10s

  app:
    image: zsio/claude-code-hub:latest
    container_name: claude-code-hub-app
    depends_on:
      postgres:
        condition: service_healthy
    env_file:
      - ./.env
    environment:
      NODE_ENV: production
      PORT: 23000
      DSN: postgresql://${DB_USER:-postgres}:${DB_PASSWORD:-postgres}@postgres:5432/${DB_NAME:-claude_code_hub}
    ports:
      - "23000:23000"
    restart: unless-stopped

volumes:
  postgres_data:
    driver: local

编辑 .env 文件，修改 ADMIN_TOKEN，然后重启应用：

docker compose restart app

编辑 docker-compose.yaml，修改端口映射：

services:
  app:
    ports:
      - "8080:23000"  # 将 23000 改为任意可用端口

  postgres:
    ports:
      - "15432:5432"  # 修改数据库端口

# 实时查看应用日志
docker compose logs -f app

# 查看最近 200 行日志
docker compose logs --tail=200 app

# 查看数据库日志
docker compose logs -f postgres

1. 检查数据库连接：

   docker compose exec app sh -c 'echo "SELECT version();" | psql $DSN'
   

2. 查看应用日志：

   docker compose logs app | grep -i migration
   

3. 手动执行迁移：

   docker compose exec app pnpm db:migrate
   

4. 如果持续失败，可以重置数据库（⚠️ 会丢失数据）：

   docker compose down -v
   docker compose up -d
   

Nginx 配置示例：

server {
    listen 443 ssl http2;
    server_name your-domain.com;

    ssl_certificate /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;

    location / {
        proxy_pass http://localhost:23000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_cache_bypass $http_upgrade;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

自动备份（推荐）：

# 添加到 crontab（每天凌晨 2 点备份）
0 2 * * * docker exec claude-code-hub-db pg_dump -U postgres claude_code_hub | gzip > /backup/claude_$(date +\%Y\%m\%d).sql.gz

手动备份：

docker exec claude-code-hub-db pg_dump -U postgres claude_code_hub > backup.sql

恢复数据：

docker exec -i claude-code-hub-db psql -U postgres claude_code_hub < backup.sql

本服务仅支持 Claude Code 格式的 API 接口。

直接支持：

• ✅ 原生提供 Claude Code 格式接口的服务商

间接支持（需要先部署 claude-code-router 进行协议转换）：

• 🔄 智谱 AI (GLM)
• 🔄 Moonshot AI (Kimi)
• 🔄 Packy
• 🔄 阿里通义千问
• 🔄 百度文心一言
• 🔄 其他非 Claude Code 格式的 AI 服务

接入流程：

1. 部署 claude-code-router 服务
2. 在 router 中配置需要接入的上游 AI 服务
3. 将 router 的地址作为供应商添加到本系统

使用 Docker 健康检查：

docker compose ps

查看容器资源使用：

docker stats claude-code-hub-app claude-code-hub-db

集成监控工具（可选）：

• Prometheus + Grafana
• Uptime Kuma
• Zabbix

1. 数据库优化：

   • 定期执行 VACUUM ANALYZE
   • 根据实际负载调整连接池大小
   • 为高频查询字段添加索引

2. 应用层优化：

   • 启用 Redis 缓存（可选）
   • 调整 Node.js 内存限制
   • 使用 CDN 缓存静态资源

3. 基础设施：

   • 使用 SSD 存储
   • 增加服务器内存
   • 配置负载均衡（多实例部署）