Sub2API 商业级多模型中转系统部署教程

1. 准备环境与安装

推荐使用海外云服务器（如美区或日区 Debian 12 / Ubuntu 22.04+），确保能稳定访问各大 AI 官方接口。

方式一：科技lion一键脚本安装（视频演示方案）

1. SSH 连接到 VPS 后，运行管理脚本：

   bash <(curl -sL kejilion.sh)

2. 在终端菜单中选择 11 (应用市场)，找到 Sub2API 序号回车。
3. 选择安装，端口可使用默认或自定义（例如默认监听端口），脚本会自动安装 Docker、Docker Compose 等环境依赖并拉取镜像启动。
4. 安装完成后，控制台会输出初始访问地址、管理员账号及随机初始密码，请及时记录保存。

方式二：标准 Docker Compose 手动部署

# 创建工作目录
mkdir -p /opt/sub2api && cd /opt/sub2api

# 编写 compose.yaml 并拉取官方镜像
# 映射主服务端口（以 1330 为例）与持久化数据目录
docker compose up -d

2. 域名解析与 HTTPS 反向代理（生产安全实践）

直接通过 IP+端口 暴露 HTTP 面板存在被扫描和明文泄漏风险，建议配置域名与 SSL 证书：

1. 在域名 DNS 控制台（如 Cloudflare）添加一条 A 记录，将子域名（如 api.yourdomain.com）解析至当前 VPS 公网 IP（建议先关闭 CDN 代理模式）。
2. 在服务器上通过 Nginx 或 Caddy 配置反向代理，反代至 Sub2API 的监听端口。
3. 申请 Let’s Encrypt SSL 证书，开启强制 HTTPS 加密访问。
4. 安全收尾：在系统防火墙中屏蔽外部直接访问原始监听端口，仅保留 80/443 端口，确保流量全部经过加密反代。

3. 访问与初始化配置

1. 在浏览器中输入域名访问后台：https://api.yourdomain.com。
2. 使用初始管理员账号密码登录系统，首次进入按提示签署合规使用承诺。
3. 进入 用户管理，立即修改默认管理员用户名与密码。

4. 核心功能配置与使用

4.1 创建模型分类与分组

进入 分组/分类管理，新建分类（例如命名为 codex 或 openai），并选择对应的底层协议类型（如 OpenAI 规范），后续所有上游账号与分发 API 都将在此分组下进行调度关联。

4.2 添加上游 AI 账号 / API

1. 进入 账号管理，点击添加账号。
2. 选择上游服务商类型（如 OpenAI / Claude 等），关联刚才创建的分组。
3. 填入官方 API Key 或使用支持的凭据格式，保存并进行最小化连通性测试。
4. 如需做高可用与负载均衡，可在同一分组下添加多个同规格账号，系统将自动进行流量轮询。

4.3 创建下游分发令牌（API Key）

1. 进入 API 管理，新建一个调用令牌。
2. 关联对应的分组，并为该 Key 预设调用额度或无限额度。
3. 保存后复制生成的专属令牌（例如 sk-...）。

4.4 客户端与 Agent 对接

任何兼容 OpenAI 协议的开发工具（Codex 插件、Chatbox、NextChat、OpenClaw / 龙虾 Agent 等）均可直接接入：

• API 端点 (Base URL)：https://api.yourdomain.com/v1
• API 密钥 (API Key)：在 4.3 步生成的下游分发令牌
• 模型名称：根据所挂载的账号选择对应模型（例如 gpt-4o、claude-3-5-sonnet 等）

5. 卸载与清理

使用科技lion脚本一键卸载

运行脚本管理菜单：

bash <(curl -sL kejilion.sh)

进入应用市场，选择 Sub2API 对应的管理项，选择“卸载并清理数据”即可。

手动 Docker 清理

cd /opt/sub2api
docker compose down -v
cd .. && rm -rf /opt/sub2api
docker rmi $(docker images | grep -i sub2api | awk '{print $3}')

6. 项目与教程来源

• 教程来源： YouTube 频道「科技lion」——《Sub2API：一键搭建商业级 AI API 中转站，统一接入 Codex、Claude、Gemini，低门槛开启 API 变现》
• 视频源地址： https://www.youtube.com/watch?v=c2wHUgU2kxs
• 运维辅助工具： 科技lion Linux 一键管理脚本 (kejilion.sh)