ros/claude-code-router

Fork 0

mirror of https://github.com/musistudio/claude-code-router.git synced 2026-01-29 22:02:05 +00:00

Files

musistudio e7608ada4a fix docs

2026-01-01 21:17:41 +08:00

3.3 KiB

Raw Blame History

Server 部署

Claude Code Router Server 支持多种部署方式，从本地开发到生产环境。

Docker 部署（推荐）

使用 Docker Hub 镜像

docker run -d \
  --name claude-code-router \
  -p 3456:3456 \
  -v ~/.claude-code-router:/app/.claude-code-router \
  musistudio/claude-code-router:latest

使用 Docker Compose

创建 docker-compose.yml：

version: '3.8'
services:
  claude-code-router:
    image: musistudio/claude-code-router:latest
    container_name: claude-code-router
    ports:
      - "3456:3456"
    volumes:
      - ./config:/app/.claude-code-router
    environment:
      - LOG_LEVEL=info
      - HOST=0.0.0.0
      - PORT=3456
    restart: unless-stopped

启动服务：

docker-compose up -d

自定义构建

从源码构建 Docker 镜像：

git clone https://github.com/musistudio/claude-code-router.git
cd claude-code-router
docker build -t claude-code-router:latest .

配置文件挂载

将配置文件挂载到容器中：

docker run -d \
  --name claude-code-router \
  -p 3456:3456 \
  -v $(pwd)/config.json:/app/.claude-code-router/config.json \
  musistudio/claude-code-router:latest

配置文件示例：

{
  // 服务器配置
  "HOST": "0.0.0.0",
  "PORT": 3456,
  "APIKEY": "your-api-key-here",

  // 日志配置
  "LOG": true,
  "LOG_LEVEL": "info",

  // LLM 提供商配置
  "Providers": [
    {
      "name": "openai",
      "baseUrl": "https://api.openai.com/v1",
      "apiKey": "$OPENAI_API_KEY",
      "models": ["gpt-4", "gpt-3.5-turbo"]
    }
  ],

  // 路由配置
  "Router": {
    "default": "openai,gpt-4"
  }
}

环境变量

支持通过环境变量覆盖配置：

变量名	说明	默认值
`HOST`	监听地址	`127.0.0.1`
`PORT`	监听端口	`3456`
`APIKEY`	API 密钥	-
`LOG_LEVEL`	日志级别	`debug`
`LOG`	是否启用日志	`true`

生产环境建议

1. 使用反向代理

使用 Nginx 作为反向代理：

server {
    listen 80;
    server_name your-domain.com;

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

2. 配置 HTTPS

使用 Let's Encrypt 获取免费证书：

sudo certbot --nginx -d your-domain.com

3. 日志管理

配置日志轮转和持久化：

version: '3.8'
services:
  claude-code-router:
    image: musistudio/claude-code-router:latest
    volumes:
      - ./logs:/app/.claude-code-router/logs
    environment:
      - LOG_LEVEL=warn

4. 健康检查

配置 Docker 健康检查：

healthcheck:
  test: ["CMD", "curl", "-f", "http://localhost:3456/api/config"]
  interval: 30s
  timeout: 10s
  retries: 3

访问 Web UI

部署完成后，访问 Web UI：

http://localhost:3456/ui/

通过 Web UI 可以：

查看和管理配置
监控日志
查看服务状态

二次开发

如果需要基于 CCR Server 进行二次开发，请查看 API 参考。

3.3 KiB Raw Blame History Unescape Escape