AI中转站都是开源的项目，从最开始比较常见的 One API、New API，到现在越来越多人开始研究 Sub2API。 说白了，就是把不同的 AI 上游服务统一接进来，通过自己的 API Key 进行管理和调用。
这篇文章主要记录一下我的完整过程：
服务器准备 → Docker 部署 → 域名反代 → 上游接入 → API 测试。
中间踩到的问题也一起记录下来。
如果你也想自己搭一套，可以参考一下。
项目地址：
项目介绍
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 管理 用量统计 限流 账号调度 支付能力
不过我目前也只是把基础流程跑通，里面还有很多功能没有深入研究，比如：
多账号策略 成本优化 风控限制 支付接入 更稳定的运营方式
评论(0)