Sub2API 搭建AI中转站喂饭教程

AI中转站都是开源的项目，从最开始比较常见的 One API、New API，到现在越来越多人开始研究 Sub2API。 说白了，就是把不同的 AI 上游服务统一接进来，通过自己的 API Key 进行管理和调用。

这篇文章主要记录一下我的完整过程：

服务器准备 → Docker 部署 → 域名反代 → 上游接入 → API 测试。

中间踩到的问题也一起记录下来。

如果你也想自己搭一套，可以参考一下。

项目地址：

GitHub - Wei-Shaw/sub2api: Sub2API 一站式开源中转服务，让 Claude、Openai 、Gemini、Grok订阅统一接入，支持拼车共享，更高效分摊成本，原生工具无缝使用。

Sub2API 一站式开源中转服务，让 Claude、Openai 、Gemini、Grok订阅统一接入，支持拼车共享，更高效分摊成本，原生工具无缝使用。 - Wei-Shaw/sub2api

github.com

访问链接

项目介绍

Sub2API 是一个 AI API 网关平台。

它不只是简单的接口转发，而是把一些中转站需要的功能整合在了一起。

主要包括：

• 多账号管理
• OAuth / API Key 上游接入
• API Key 分发
• Token 用量统计
• 成本计算
• 用户额度管理
• 请求限流
• 账号调度
• 粘性会话
• 管理后台
• 支付系统

简单理解：你负责接入合法拥有的 AI 上游资源，Sub2API 负责帮你统一管理和分发。

环境部署

我的部署环境：

• Ubuntu 服务器
• Docker 20.10+
• Docker Compose v2+

官方推荐 Docker Compose 部署。

包含：

• Sub2API
• PostgreSQL
• Redis

创建部署目录：

mkdir -p sub2api-deploy && cd sub2api-deploy

下载部署脚本：

curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/docker-deploy.sh | bash

启动：

docker compose up -d

查看日志：

docker compose logs -f sub2api

第一次启动后，日志里面会输出初始化信息。

登录后建议第一时间修改管理员密码。

配置域名反代

为了方便后续 HTTPS 访问，我这里使用宝塔配置域名的反代。 添加站点后：

反向代理到：

http://127.0.0.1:8080

官方推荐 Nginx 增加一些额外配置。

这里注意一下：

主要是为了保证 多账号环境下的粘性会话功能失效。

然后申请 SSL，开启 HTTPS。

然后在宝塔申请证书

登录后台初始化

第一次进入后台后，建议先做几个基础设置。

修改管理员密码

路径：

个人资料 → 修改密码

避免继续使用默认密码。

创建分组

Sub2API 里面需要先创建分组。

简单理解：

分组就是后续账号和用户之间的连接关系。

例如：

创建：

GPT账号组
Claude账号组

不同上游账号可以放到不同分组。

接入上游

进入：

账号管理 → 添加账号

填写：

• 账号名称
• API Key
• Base URL

前提是在别人上游创建的API Key

把上游创建的API Key 放在自己的账号管理的API KEY中

注意勾选下面的分组

开放注册

打开开放注册。

可以设置：

• 注册邮箱后缀白名单
• 注册赠送额度

创建测试账号。

登录用户后台后：创建 API Key。

顺便设置一下API 端点地址，在别人注册的创建密钥时候右上角能看到这个Base URL

测试登录会员

测试注册会员

创建 API Key。

然后配置客户端。这里使用 CC Switch 测试。

填入：API Base和 API Key

接着就可以测试了

如果正常返回：说明链路已经跑通。

测试几个点：

• 普通请求
• 流式输出
• Token 统计
• 额度扣除

基本就完成了。

总结

Sub2API 经过不断迭代，现在已经不只是一个简单的 API 转发项目。

它把很多原本需要自己开发的东西整合好了：

• 用户系统
• API 管理
• 用量统计
• 限流
• 账号调度
• 支付能力

不过我目前也只是把基础流程跑通，里面还有很多功能没有深入研究，比如：

• 多账号策略
• 成本优化
• 风控限制
• 支付接入
• 更稳定的运营方式