Docker部署 - CC-Gateway使用指南

Docker部署方式

CC-Gateway支持两种Docker部署方式：docker-compose（推荐）和docker run命令。

方式一：docker-compose（推荐）

创建项目目录

mkdir cc-gateway && cd cc-gateway

创建配置文件

创建config.yaml文件，参考配置详解：

gateway:
  port: 8080

identity:
  device_id: "your-standardized-device-id"
  email: "user@example.com"

env:
  platform: darwin
  arch: arm64
  os_version: "Darwin 24.4.0"
  node_version: v24.3.0
  terminal: iTerm2.app
  shell: zsh

upstream:
  base_url: https://api.anthropic.com
  api_key: "your-api-key"

创建docker-compose.yaml

services:
  cc-gateway:
    image: cc-gateway:latest
    container_name: cc-gateway
    ports:
      - "8080:8080"
    volumes:
      - ./config.yaml:/app/config.yaml:ro
    restart: unless-stopped
    environment:
      - TZ=Asia/Shanghai

启动服务

docker-compose up -d

方式二：docker run

docker run -d \
  --name cc-gateway \
  -p 8080:8080 \
  -v $(pwd)/config.yaml:/app/config.yaml:ro \
  -e TZ=Asia/Shanghai \
  --restart unless-stopped \
  cc-gateway:latest

常用命令

查看日志

docker logs -f cc-gateway

重启服务

docker restart cc-gateway

停止服务

docker stop cc-gateway

更新版本

docker pull cc-gateway:latest
docker-compose up -d

数据持久化

如果你需要持久化配置文件，可以创建一个数据卷：

docker volume create cc-gateway-config

网络配置

如果你的环境需要通过代理访问外网，可以在docker-compose.yaml中配置：

services:
  cc-gateway:
    environment:
      - HTTP_PROXY=http://your-proxy:port
      - HTTPS_PROXY=http://your-proxy:port

注意：配置文件中的敏感信息（如API密钥）会挂载到容器内，请确保config.yaml文件的权限设置正确，防止未授权访问。

配置详解 →