Sub2API 部署与账号导入教程：把订阅账号统一转换成 API

如果你手里有 Claude、OpenAI、Gemini 等 AI 产品订阅账号，想统一管理额度、分组、API Key 和调用入口，可以试试 Sub2API。

Sub2API 是一个开源 AI API 网关平台，作用是把上游 AI 账号或订阅能力统一接入到一个后台里，再通过平台生成的 API Key 对外提供调用。它可以负责鉴权、账号分组、负载均衡、请求转发、额度统计等工作，比较适合自用、多账号管理，或者团队内部统一接入。

> 提醒：本文仅用于管理自己合法持有的账号和订阅资源。请遵守对应平台的服务条款，不要用于违规共享、倒卖或滥用。

项目地址：

https://github.com/Wei-Shaw/sub2api

一、部署前准备

本文推荐使用 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 https://download.docker.com/linux/ubuntu/gpg \
| gpg –dearmor -o /etc/apt/keyrings/docker.gpg

echo \
“deb [arch=$(dpkg –print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
$(. /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 https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/docker-deploy.sh | 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

看到服务正常启动后，就说明部署基本完成。

四、访问后台

浏览器打开：

http://你的服务器IP:8080

如果服务器有防火墙或云安全组，记得放行 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

https://urapi.yunxzi.cn/