自建进阶教程

One API / New API 自建中转指南：5分钟搭建私人 AI 中转站

2026-03-21 · 约 10 分钟阅读

---

title: "One API / New API 自建中转完整教程：Docker 部署 + 渠道配置"

description: "详细讲解 One API 和 New API 的 Docker 部署步骤、渠道配置、Key 生成和费用估算，帮开发者快速自建 AI API 中转服务。"

date: "2026-03-21"

tags: ["One API", "New API", "自建中转", "Docker部署"]

---

# One API / New API 自建中转完整教程：Docker 部署 + 渠道配置

One API 和 New API 是目前最流行的开源 AI API 聚合网关，能将 OpenAI、Anthropic、Google、DeepSeek 等多家模型统一成 OpenAI 兼容格式对外提供服务。如果你有一定的运维能力，自建中转不仅成本更低，还能完全掌控数据流向。

本文将详细讲解从零开始的 one api 部署和 new api 自建全流程。

---

一、One API vs New API：选哪个？

对比维度	One API	New API
开源地址	github.com/songquanpeng/one-api	github.com/Calcium-Ion/new-api
活跃程度	⭐⭐⭐ 较稳定	⭐⭐⭐⭐ 更新频繁
界面	简洁	更现代，支持暗色模式
模型支持	主流模型	更多模型，含 Midjourney
Rerank 支持	不支持	支持
数据统计	基础	更详细
适合场景	个人/小团队	商业化、功能丰富

建议：如果只是自用或小团队使用，One API 更稳定；如果要做对外服务或需要更多模型支持，选 New API。

本文以 New API 为主（部署步骤基本相同）。

---

二、前置准备

2.1 服务器选择

需求	推荐配置	参考价格
个人/测试	1核2G，10G硬盘	¥20-40/月（轻量云服务器）
小团队（<10人）	2核4G，20G硬盘	¥80-120/月
商用（>100 QPS）	4核8G + Redis	¥300+/月

地区选择：

个人使用：国内服务器即可（延迟低）
转发境外模型：推荐香港或新加坡（到 OpenAI/Google 更快）

2.2 必要软件

```bash

# 安装 Docker（Ubuntu/Debian）

curl -fsSL https://get.docker.com | sh

sudo systemctl enable docker && sudo systemctl start docker

# 安装 Docker Compose

sudo apt install docker-compose-plugin -y

# 验证安装

docker --version

docker compose version

```

---

三、Docker 部署 New API

3.1 创建目录结构

```bash

mkdir -p ~/new-api && cd ~/new-api

mkdir -p data logs

```

3.2 创建 docker-compose.yml

```yaml

# docker-compose.yml

version: '3.8'

services:

new-api:

image: calciumion/new-api:latest
container_name: new-api
restart: always
ports:
  - "3000:3000"
volumes:
  - ./data:/data
  - ./logs:/app/logs
environment:
  - TZ=Asia/Shanghai
  - ERROR_LOG_ENABLED=true
  # 生产环境务必修改以下密钥
  - SESSION_SECRET=your-random-secret-key-here
  - CRYPTO_SECRET=your-another-random-key
depends_on:
  - redis

redis:

image: redis:7-alpine
container_name: new-api-redis
restart: always
volumes:
  - ./data/redis:/data
command: redis-server --appendonly yes

```

3.3 启动服务

```bash

# 启动

docker compose up -d

# 查看日志

docker compose logs -f new-api

# 验证服务正常

curl http://localhost:3000/api/status

```

启动成功后，访问 `http://your-server-ip:3000` 即可看到管理界面。

默认登录凭据：

用户名：`root`
密码：`123456`（⚠️ 首次登录后务必立即修改！）

---

四、配置上游渠道

这是 one api 部署最核心的步骤：将实际的 AI 服务商配置为"渠道"。

4.1 添加 OpenAI 渠道

1. 登录管理后台 → 「渠道」→「添加渠道」

2. 填写配置：

```

类型：OpenAI

名称：OpenAI 官方

代理：（如果服务器在国内需填境外代理，如 http://127.0.0.1:7890）

密钥：sk-xxxxxxxxxxxxxxxx（你的 OpenAI API Key）

模型：gpt-4o, gpt-4o-mini, gpt-3.5-turbo（按需勾选）

```

3. 点击「测试」验证连通性，显示绿色则配置成功

4.2 添加 DeepSeek 渠道

```

类型：DeepSeek

名称：DeepSeek 官方

基础 URL：https://api.deepseek.com

密钥：your-deepseek-api-key

模型：deepseek-chat, deepseek-reasoner

```

> Tips: DeepSeek API 在国内部分服务器上延迟较高，可以配置多个渠道并开启负载均衡。

4.3 添加 Anthropic（Claude）渠道

```

类型：Anthropic

名称：Claude 官方

基础 URL：https://api.anthropic.com

密钥：sk-ant-xxxxxxxx

模型：claude-3-5-sonnet-20241022, claude-3-5-haiku-20241022

```

4.4 添加 Google Gemini 渠道

```

类型：Gemini

名称：Google Gemini

基础 URL：https://generativelanguage.googleapis.com

密钥：AIzaSy-xxxxxxxx（Google AI Studio 的 API Key）

模型：gemini-2.0-flash, gemini-1.5-pro

代理：（国内服务器必须配置境外代理）

```

---

五、生成对外 API Key

渠道配置完成后，为你的应用（或团队成员）创建独立的 API Key：

1. 后台 → 「令牌」→「添加令牌」

2. 配置：

```

名称：生产环境-App1

有效期：永久（或设置到期时间）

额度：1000000（即100万token，约¥2-20，根据模型不同）

模型限制：（可限制只能用哪些模型）

IP 限制：（可选，绑定特定 IP）

```

3. 复制生成的 Key（格式：`sk-xxxxxxxx`）

使用方式

```python

from openai import OpenAI

# 使用自建中转的 Key

client = OpenAI(

api_key="sk-your-generated-key",
base_url="http://your-server-ip:3000/v1"

)

response = client.chat.completions.create(

model="gpt-4o",
messages=[{"role": "user", "content": "Hello!"}]

)

```

---

六、高级配置

6.1 Nginx 反向代理（推荐生产使用）

```nginx

server {

listen 443 ssl;
server_name api.yourdomain.com;

ssl_certificate /path/to/cert.pem;
ssl_certificate_key /path/to/key.pem;

location / {
    proxy_pass http://127.0.0.1:3000;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_buffering off;  # 重要：流式输出需要关闭缓冲
    proxy_read_timeout 600s;  # 长对话需要更长超时
}

}

```

6.2 开启模型价格（计费追踪）

在「设置」→「运营设置」中，可以为每个模型配置倍率，系统会按照你设定的价格扣除用户额度，方便成本追踪。

6.3 配置告警

```bash

# 设置余额不足告警（通过 Telegram Bot）

NOTIFY_TOKEN=your-telegram-bot-token

NOTIFY_CHAT_ID=your-chat-id

```

---

七、费用估算

自建 new api 中转的综合成本：

成本项	月费用	备注
服务器（2核4G，香港）	¥100-150	阿里云/腾讯云轻量
域名	¥5	年费约¥60
SSL 证书	¥0	Let's Encrypt 免费
AI API 成本	按用量	直接向官方付费
固定运维成本	¥105-155/月

什么时候值得自建？

如果你的月 API 消耗超过 ¥500，自建中转可以：

省去中转加价（通常 15%-30%）
完全掌控日志和用户管理
支持多人共用、分配额度

若消耗不足 ¥200/月，直接使用成熟的第三方中转站更划算。

---

八、常见问题

Q: 服务器在国内，如何稳定访问 OpenAI？

A: 需要配置境外代理。可以在渠道配置中填写代理地址，或在服务器上配置系统级代理（Clash/V2Ray）。

Q: 如何防止 Key 被滥用？

A: 设置令牌的 IP 白名单和额度上限，并在后台监控用量异常。

Q: New API 支持 Midjourney 吗？

A: 支持，需要配置 Midjourney 代理服务作为上游渠道（如 midjourney-proxy 项目）。

Q: 数据安全怎么保证？

A: One API/New API 本身不存储请求内容，只记录 token 用量。日志级别可在设置中调整。

---

九、总结

one api 部署和 new api 自建为有运维能力的开发者提供了最大灵活度。核心步骤：

1. 准备香港/海外服务器

2. Docker Compose 一键启动

3. 添加上游 AI 服务商渠道

4. 生成对外 API Key

5. Nginx 配置 HTTPS

完整源码参考：

One API: https://github.com/songquanpeng/one-api
New API: https://github.com/Calcium-Ion/new-api

如果不想自己运维，也可以直接使用 [OpenAI Router](https://openairouter.net)——基于相同技术构建，稳定运行，开箱即用。