GPTZZZgptzzz.ai
TOPIC

自建 API 中转站：源码选型、部署与架构

中转站怎么做？分三步：先选开源源码（New API、Sub2API、One API、LiteLLM），再用 Docker 部署跑起来，最后补齐鉴权、协议适配、模型路由、流式转发、计量、限流熔断、密钥管理和可观测性。只加一层反向代理撑不起长期运行。

本专题按这个顺序组织：源码对比、New API Docker 部署教程、自建网关架构，再连接多模型路由、安全、重试、监控与成本文章。

自建 AI API 网关路线包含拆分控制面、构建数据面、适配协议路由和接入计量观测
自建网关先拆分控制面与数据面，再完成协议适配和模型路由，最后接入计量与可观测性。
START HERE

建议阅读顺序

按顺序读完这四篇，再按具体问题查看本专题全部文章。

  1. 选开源中转站源码

    对比 New API、Sub2API、One API、LiteLLM 的许可证、技术栈与维护状态。

  2. 用 Docker 部署 New API

    按步骤在服务器上跑起开源中转站。

  3. 设计自建网关架构

    拆分控制面、数据面与核心运行组件。

  4. 扩展为多模型 API 网关

    加入路由、熔断、计费和可观测性。

DEPLOYMENT TERMS

API 中转站源码与部署：先分清三件事

选源码、部署、架构是三个层次的问题。能启动不等于能长期运行。

Docker 搭建 API 中转站

Docker 只是交付方式。New API 官方 README 给出单容器（SQLite）和 Docker Compose（PostgreSQL + Redis）两种部署方式，Sub2API 的 Compose 部署同样依赖 PostgreSQL 和 Redis。部署时仍要检查配置与密钥注入、数据库和日志持久化、健康检查、端口暴露、备份恢复及镜像升级回滚。分步操作见New API Docker 部署教程，组件边界见自建 API 中转站架构。

New API、Sub2API、One API 与 LiteLLM 怎么选

New API（AGPL-3.0）在 One API 基础上二次开发并持续发布；One API（MIT）最近一次发布在 2025-02-02；Sub2API（LGPL-3.0）面向订阅额度分发，README 提示使用它可能违反上游服务条款；LiteLLM（主体 MIT）适合团队内部统一网关。许可证、技术栈与维护状态对比见API 中转站源码对比，不要只看 Star、截图或旧教程。

API 反向代理与生产级网关

反向代理主要解决连接和转发；生产级多模型 API 网关还要处理鉴权、协议适配、模型路由、流式事件、限流熔断、用量计费与可观测性。继续阅读多模型 API 网关设计。

RELEASE CHECKLIST

自建 API 中转站的上线验收清单

部署完成只代表进程能启动。正式承接调用前，还要把安全、可靠性和恢复路径变成可重复的验收步骤。

配置与密钥边界

为开发、预发布和正式环境分别创建密钥，入口只接受 HTTPS，并把上游凭据保存在服务端密钥存储中。逐项核对请求体大小、允许的模型、单用户限额、管理接口访问控制和日志脱敏；浏览器代码、镜像层、示例仓库与错误页面都不应出现完整密钥。

协议与故障验证

使用固定的小请求验证非流式、流式、工具调用、错误码和用量字段，再模拟上游超时、429 与 5xx。重试必须受次数、总时长和幂等边界约束；发生持续失败时应触发熔断或明确降级，而不是无限重放可能计费的请求。

发布、观测与回滚

发布前记录配置版本、数据库备份点和镜像摘要，发布后从外部入口执行健康检查与低强度基线。可直接下载 API Relay Benchmark Kit v1 留存逐请求结果；指标异常时按预先写好的步骤回滚，再核对鉴权、模型路由、计量和日志链路是否恢复。

TOPIC GUIDES

本专题 3 篇指南

自建 AI API 网关路线包含拆分控制面、构建数据面、适配协议路由和接入计量观测自建部署
约 15 分钟

New API Docker 部署教程：自建 AI API 中转站

New API 用 Docker Compose 部署：克隆官方仓库，改掉 compose 示例密码并设置 SESSION_SECRET，执行 docker compose up -d，再用 Caddy 或 Nginx 配 HTTPS。附初始化、渠道、令牌、curl 验证、升级备份与排错。

New APIDocker 部署中转站搭建
API 中转站搭建架构图，展示鉴权反向代理、路由流式转发、计量限流熔断与可观测性自建部署
约 12 分钟

API 中转站搭建教程：从反向代理到 AI API 网关架构

API 中转站搭建有两条路：直接部署 New API、LiteLLM 等开源源码，或按控制面与数据面自研网关。本文讲清反向代理、鉴权、路由、流式转发、Token 计量、限流熔断与运维检查。

API 中转站搭建API 中转站搭建教程自建 API 中转站
FAQ

自建 API 中转站与开源 AI 网关常见问题

反向代理和生产级 AI API 网关有什么区别？

反向代理解决基础转发，生产级网关还要处理鉴权、协议适配、模型路由、流式、计量、限流熔断和观测。查看：自建网关架构指南。

API 中转站源码应该怎么选？

先按场景和许可证排除：New API（AGPL-3.0）适合带用户与额度后台的多模型中转站；One API（MIT）最近一次发布在 2025-02-02；Sub2API（LGPL-3.0）面向订阅额度分发；LiteLLM 适合团队内部网关。再核对协议覆盖、计量准确性、安全边界和维护活跃度。对比见：API 中转站源码对比。

API 中转站怎么搭建？

省事的做法是用 Docker 部署开源源码，例如 New API 官方提供单容器和 Docker Compose 两种方式；之后再补齐反向代理与 HTTPS、数据库备份、鉴权、计量、限流和监控。步骤见：New API Docker 部署教程。

自建中转站最少需要哪些组件？

至少需要入口鉴权、协议适配、模型路由、流式转发、用量计量、限流、日志追踪和密钥管理，并为故障准备回滚。参考：多模型 API 网关设计。