如果你手里有 Claude、OpenAI、Gemini 等 AI 产品订阅账号,想统一管理额度、分组、API Key 和调用入口,可以试试 Sub2API。
Sub2API 是一个开源 AI API 网关平台,作用是把上游 AI 账号或订阅能力统一接入到一个后台里,再通过平台生成的 API Key 对外提供调用。它可以负责鉴权、账号分组、负载均衡、请求转发、额度统计等工作,比较适合自用、多账号管理,或者团队内部统一接入。
提醒:本文仅用于管理自己合法持有的账号和订阅资源。请遵守对应平台的服务条款,不要用于违规共享、倒卖或滥用。
项目地址:
一、部署前准备
本文推荐使用 Docker Compose 部署,因为这种方式会自动拉起 Sub2API、PostgreSQL 和 Redis,配置最省心,也方便后续备份和迁移。
服务器建议:
系统:Ubuntu 20.04+ 服务器Docker:20.10+Docker Compose:v2+端口:默认使用 8080权限:建议使用 root 用户,或具备 sudo 权限的用户
如果你使用的是一键二进制脚本部署,则需要提前自行准备 PostgreSQL 和 Redis。新手建议直接走 Docker Compose。
二、安装 Docker 和 Docker Compose
如果你的服务器已经安装过 Docker,可以先检查版本:
docker --version
docker compose version
如果没有安装,可以按下面步骤安装 Docker 官方源和 Compose 插件。下面命令以 Ubuntu 为例,Debian 用户需要把 Docker 源地址换成 Debian 对应地址。
apt update
apt install -y ca-certificates curl gnupg
mkdir -p /etc/apt/keyrings
curl -fsSL 立即下载
| gpg --dearmor -o /etc/apt/keyrings/docker.gpg
echo
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] 立即下载
$(. /etc/os-release && echo $VERSION_CODENAME) stable"
| tee /etc/apt/sources.list.d/docker.list > /dev/null
apt update
apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin
启动 Docker,并设置开机自启:
systemctl start docker
systemctl enable docker
再次检查版本:
docker --version
docker compose version
三、部署 Sub2API
创建一个单独的部署目录:
mkdir -p sub2api-deploy
cd sub2api-deploy
运行官方 Docker 部署准备脚本:
curl -sSL 立即下载 | bash
这个脚本会自动完成几件事:
下载 docker-compose.local.yml生成 .env 配置文件自动生成数据库密码、JWT 密钥等必要配置创建 data/、postgres_data/、redis_data/ 等本地数据目录

然后启动服务:
docker compose -f docker-compose.local.yml up -d
查看运行日志:
docker compose -f docker-compose.local.yml logs -f sub2api
看到服务正常启动后,就说明部署基本完成。

四、访问后台
浏览器打开:
如果服务器有防火墙或云安全组,记得放行 8080 端口。
打开后可以看到 Sub2API 的前端界面:

五、获取后台管理员密码
默认管理员账号是:
admin@sub2api.local
管理员密码会在首次启动时自动生成,可以在服务器上执行下面命令查看:
docker compose -f docker-compose.local.yml logs sub2api | grep "admin password"
如果你的环境里没有使用 docker-compose.local.yml,也可以尝试:
docker logs sub2api | grep "admin password"
日志里出现的密码就是后台初始密码。
最后免费api模型包含,gpt5.6sol