一键部署

使用 docker-compose.yaml 启动

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

启动服务

# 启动所有服务（后台运行）
docker compose up -d

# 查看启动日志
docker compose logs -f

验证部署

检查服务状态

docker compose ps

确保两个容器都是 healthy 或 running 状态

环境变量配置

在项目根目录创建 .env 文件：

# 管理员登录令牌（必须修改为强密码）
ADMIN_TOKEN=!!!change-me-to-a-strong-password!!!

# 数据库配置（可选，已有默认值）
DB_USER=postgres
DB_PASSWORD=!!!change-me!!!
DB_NAME=claude_code_hub

| 变量名 | 必需 | 默认值 | 说明 | |--------|------|--------|------| | ADMIN_TOKEN | ✅ | change-me | 管理员登录令牌，必须修改为强密码 | | DB_USER | ❌ | postgres | 数据库用户名 | | DB_PASSWORD | ❌ | postgres | 数据库密码（生产环境建议修改） | | DB_NAME | ❌ | claude_code_hub | 数据库名称 | | AUTO_MIGRATE | ❌ | true | 启动时自动执行数据库迁移...