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 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/ 等本地数据目录http://cdn.u1.huluxia.com/g4/M02/AC/3C/rBAAdmqNhveAaf5iAABc80-Vn4k981.png,1044,168然后启动服务：
docker compose -f docker-compose.local.yml up -d
查看运行日志：
docker compose -f docker-compose.local.yml logs -f sub2api
看到服务正常启动后，就说明部署基本完成。
http://cdn.u1.huluxia.com/g4/M02/AC/3C/rBAAdmqNhv6AW9k0AAW59LnM2So879.jpg,4096,1845
四、访问后台
浏览器打开：
http://你的服务器IP:8080
如果服务器有防火墙或云安全组，记得放行 8080 端口。
打开后可以看到 Sub2API 的前端界面：
http://cdn.u1.huluxia.com/g4/M02/AC/3C/rBAAdmqNhv-ANX_6AACr7OFgcw8960.jpg,1440,638
五、获取后台管理员密码
默认管理员账号是：
[email protected]
管理员密码会在首次启动时自动生成，可以在服务器上执行下面命令查看：
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/
页:
[1]