02.New-Api单渠道多密钥

清夏晚风 Lv7
  2026-04-01 18:56:33 2026-04-01 18:56:33 Created   2026-05-29 14:43:35 2026-05-29 14:43:35 Updated      

功能说明

New API 支持在单个渠道中配置多个 API 密钥，并提供密钥轮询功能。这对于以下场景非常有用：

  • 负载均衡：将请求分散到多个密钥，避免单个密钥达到速率限制
  • 高可用性：当某个密钥失效时自动切换到其他可用密钥
  • 成本优化：充分利用多个账号的免费额度

前置要求

⚠️ 重要提示：密钥轮询模式必须搭配 Redis 和内存缓存功能使用，否则性能将大幅降低，并且无法实现轮询功能。

因此，我们需要使用包含 MySQL 和 Redis 的完整 Docker Compose 配置。

完整 Docker Compose 配置

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
# New-API Docker Compose Configuration
#
# Quick Start:
#   1. docker-compose up -d
#   2. Access at http://localhost:3000
#
# Using MySQL instead of PostgreSQL:
#   1. Comment out the postgres service and SQL_DSN line 15
#   2. Uncomment the mysql service and SQL_DSN line 16
#   3. Uncomment mysql in depends_on (line 28)
#   4. Uncomment mysql_data in volumes section (line 64)
#
# ⚠️  IMPORTANT: Change all default passwords before deploying to production!

version: '3.4' # For compatibility with older Docker versions

services:
  new-api:
    image: calciumion/new-api:latest
    container_name: new-api
    restart: always
    command: --log-dir /app/logs
    ports:
      - '3000:3000'
    volumes:
      - ./data:/data
      - ./logs:/app/logs
    environment:
      - SQL_DSN=postgresql://root:123456@postgres:5432/new-api # ⚠️ IMPORTANT: Change the password in production!
      #      - SQL_DSN=root:123456@tcp(mysql:3306)/new-api  # Point to the mysql service, uncomment if using MySQL
      - REDIS_CONN_STRING=redis://redis
      - TZ=Asia/Shanghai
      - ERROR_LOG_ENABLED=true # 是否启用错误日志记录
      - BATCH_UPDATE_ENABLED=true # 是否启用批量更新 batch update enabled
    #      - STREAMING_TIMEOUT=300  # 流模式无响应超时时间，单位秒，默认120秒，如果出现空补全可以尝试改为更大值 Streaming timeout in seconds, default is 120s. Increase if experiencing empty completions
    #      - SESSION_SECRET=random_string  # 多机部署时设置，必须修改这个随机字符串！！ multi-node deployment, set this to a random string!!!!!!!
    #      - SYNC_FREQUENCY=60  # Uncomment if regular database syncing is needed

    depends_on:
      - redis
      - postgres
    #      - mysql  # Uncomment if using MySQL
    healthcheck:
      test:
        [
          'CMD-SHELL',
          "wget -q -O - http://localhost:3000/api/status | grep -o '\"success\":\\s*true' || exit 1",
        ]
      interval: 30s
      timeout: 10s
      retries: 3

  redis:
    image: redis:latest
    container_name: redis
    restart: always

  postgres:
    image: postgres:15
    container_name: postgres
    restart: always
    environment:
      POSTGRES_USER: root
      POSTGRES_PASSWORD: 123456 # ⚠️ IMPORTANT: Change this password in production!
      POSTGRES_DB: new-api
    volumes:
      - pg_data:/var/lib/postgresql/data
#    ports:
#      - "5432:5432"  # Uncomment if you need to access PostgreSQL from outside Docker

#  mysql:
#    image: mysql:8.2
#    container_name: mysql
#    restart: always
#    environment:
#      MYSQL_ROOT_PASSWORD: 123456  # ⚠️ IMPORTANT: Change this password in production!
#      MYSQL_DATABASE: new-api
#    volumes:
#      - mysql_data:/var/lib/mysql
#    ports:
#      - "3306:3306"  # Uncomment if you need to access MySQL from outside Docker

volumes:
  pg_data:
#  mysql_data:

关键环境变量说明

环境变量 说明 示例
SQL_DSN 数据库连接字符串 root:123456@tcp(mysql:3306)/new-api
REDIS_CONN_STRING Redis连接字符串 redis://redis
TZ 时区设置 Asia/Shanghai
SESSION_SECRET 会话密钥(多机部署必须) your_random_string
NODE_TYPE 节点类型(主/从) master或slave
SYNC_FREQUENCY 同步频率(秒) 60

部署步骤

1. 创建项目目录

1
2
mkdir new-api
cd new-api

2. 创建 docker-compose.yml

将上述完整配置保存为 docker-compose.yml 文件。

3. 启动服务

1
docker compose up -d

4. 检查服务状态

1
docker compose ps

确保 new-api、mysql 和 redis 三个容器都处于 running 状态。

配置单渠道多密钥

1. 创建渠道

进入 New API 管理界面，点击”添加渠道”：

  1. 类型：选择对应的 API 类型（如 OpenAI）
  2. 名称：为渠道命名
  3. 密钥：输入多个密钥，每行一个
  4. 勾选选项：
    • ✅ 批量创建
    • ✅ 密钥聚合模式
    • ✅ 密钥去重

2. 设置密钥聚合模式

在”密钥聚合模式”下拉框中选择：

  • 轮询：按顺序循环使用每个密钥（推荐）
  • 随机：随机选择一个密钥
  • 权重：根据权重分配请求

⚠️ 选择轮询模式时，系统会提示需要 Redis 支持。

3. 多密钥管理

创建渠道后，可以在”多密钥管理”界面：

  • 查看每个密钥的状态（已启用/手动禁用/自动禁用）
  • 单独禁用/启用某个密钥
  • 删除失效密钥
  • 查看密钥禁用原因和时间

常见问题

轮询功能不生效

  1. 检查 Redis 是否正常运行
  2. 确认 REDIS_CONN_STRING 配置正确
  3. 确认 MEMORY_CACHE_ENABLED 设置为 true
  4. 查看容器日志：docker logs new-api

数据库连接失败

  1. 检查 MySQL 容器是否正常运行
  2. 确认 SQL_DSN 中的密码与 MYSQL_ROOT_PASSWORD 一致
  3. 检查网络连接：docker network inspect new-api_newapi-network

密钥被自动禁用

当某个密钥返回错误（如余额不足、认证失败）时，系统会自动禁用该密钥。可以在”多密钥管理”中查看禁用原因，修复问题后手动重新启用。

  • Title: 02.New-Api单渠道多密钥
  • Author: 清夏晚风
  • Created at : 2026-04-01 18:56:33
  • Updated at : 2026-05-29 14:43:35
  • Link: https://blog.yuil.cn/2026/04/01/AI相关工具/API相关/API管理/New API/02.New-Api单渠道多密钥/
  • License: This work is licensed under CC BY-NC-SA 4.0.
Comments
On this page
02.New-Api单渠道多密钥
  1. 功能说明
  2. 前置要求
  3. 完整 Docker Compose 配置
  4. 关键环境变量说明
  5. 部署步骤
    1. 1. 创建项目目录
    2. 2. 创建 docker-compose.yml
    3. 3. 启动服务
    4. 4. 检查服务状态
  6. 配置单渠道多密钥
    1. 1. 创建渠道
    2. 2. 设置密钥聚合模式
    3. 3. 多密钥管理
  7. 常见问题
    1. 轮询功能不生效
    2. 数据库连接失败
    3. 密钥被自动禁用