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