部署指南

Docker Compose

version: '3.8'
services:
  ccx:
    image: ghcr.io/benedictking/ccx:latest
    ports:
      - "3000:3000"
    volumes:
      - ./config:/app/.config
    environment:
      - PROXY_ACCESS_KEY=your-proxy-key
      - ADMIN_ACCESS_KEY=your-admin-key
      - ENV=production
    restart: unless-stopped

系统服务

Linux (systemd)

[Unit]
Description=CCX AI API Gateway
After=network.target

[Service]
Type=simple
ExecStart=/opt/ccx/ccx
WorkingDirectory=/opt/ccx
Environment=PROXY_ACCESS_KEY=your-proxy-key
Environment=ADMIN_ACCESS_KEY=your-admin-key
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

macOS (launchd)

参考 docs/service/com.ccx.gateway.plist 配置文件。

环境变量

变量	默认值	说明
PORT	3000	服务端口
ENV	production	运行环境
PROXY_ACCESS_KEY	-	代理访问密钥（必填）
ADMIN_ACCESS_KEY	-	管理界面密钥（可选）
QUIET_POLLING_LOGS	true	静默轮询日志
MAX_REQUEST_BODY_SIZE_MB	50	请求体大小限制

完整环境变量列表请参考项目根目录的 ENVIRONMENT.md。