One API 中转站高可用部署方案

One API 是一个开源的 API 中转管理平台，支持将多个 AI 服务商的 API 统一接入，通过自定义渠道实现负载均衡、限流控制和成本优化。

架构设计

                    ┌─────────────┐
                    │   Nginx     │  (HTTPS 443)
                    └──────┬──────┘
                           │
        ┌──────────────────┼──────────────────┐
        │                  │                  │
  ┌─────▼─────┐      ┌────▼────┐      ┌─────▼─────┐
  │ One API 1 │      │ One API2│      │ One API 3│
  │  :3000    │      │  :3001   │      │  :3002   │
  └─────┬─────┘      └────┬────┘      └─────┬─────┘
        └──────────────────┼──────────────────┘
                           │
              ┌────────────▼────────────┐
              │      MySQL 共享存储       │
              └──────────────────────────┘

Docker Compose 部署

version: "3.8"
services:
  one-api:
    image: ssawing/one-api:latest
    container_name: one-api
    restart: unless-stopped
    ports:
      - "3000:3000"
    volumes:
      - ./data:/data
    depends_on:
      - mysql
  mysql:
    image: mysql:8.0
    container_name: one-api-mysql
    restart: unless-stopped
    environment:
      MYSQL_ROOT_PASSWORD: your_strong_password
      MYSQL_DATABASE: one_api
    volumes:
      - ./mysql:/var/lib/mysql

高可用配置要点

• 多实例部署：通过 Nginx upstream 配置多个 One API 实例，轮询负载均衡
• 会话共享：所有实例连接同一个 MySQL 数据库，渠道配置实时同步
• 健康检查：Nginx upstream 配置 max_fails 和 fail_timeout，自动摘除故障节点
• SSL 终端：在 Nginx 层处理 HTTPS，容器间通信走 HTTP
• 数据持久化：MySQL 主从复制，One API /data 目录映射到宿主机

安全加固

• 修改管理后台路径（如 /admin-secret-path/）防止扫描
• 设置复杂的渠道 Token，定期轮换
• 通过 Nginx limit_req 限制单 IP 请求频率
• 配置 Key 鉴权白名单

高可用部署的核心是冗余 + 故障自动切换。生产环境建议使用 K8s 进行容器编排和自动恢复。