自建 Sub2API 中转站（6 步教程笔记）

lishihuan大约 9 分钟

自建 Sub2API 中转站（6 步教程笔记）

来源：B 站视频 BV1oK7A62EK2open in new window · UP 主：方鑫三个金 · 合集：AI 讲座
相关：AI 中转站网站汇总

视频元信息

项目内容
标题如何搭建自用 AI 中转站 6 步教程，小白也能看懂
时长约 11 分钟（655 秒）
核心工具Sub2APIopen in new window（开源 AI API 网关）
定位自用 / 小团队，不是「卖 Key 赚钱」向

一、为啥搭建中转站（值不值得）

1.1 先分清三层：客户端 → 网关 → 上游

层级是什么例子
客户端Cursor、Claude Code、自研程序改 Base URL + Key
网关层中转站：鉴权、限流、子 Key、计费Sub2API / NewAPI / apapi
上游网关后面真正调模型的那一端OpenAI 官方 API、Claude 订阅、或另一家中转站
官方模型厂商OpenAI、Anthropic、Google

第三方中转站 = 别人帮你管 网关 + 往往也包上游（你只充钱拿 Key）。

自建中转站 = 网关你自己管，但 上游仍要你自己找——并没有消灭上游。

1.2 上游 vs 第三方：不是同一层

第三方中转站（直接买 Key）上游（自建时要接的那一端）
角色既是网关，又是供应商只是网关后面的一环
你得到什么一个 Key，开箱即用在 Sub2API 后台配置渠道 / 账号
谁管子 Key、限流商家你
数据经过谁商家服务器（黑盒）你的 VPS + 上游
上游从哪来不可见、不可选你自己选（官方 API、订阅、或再买一家中转）

三种常见链路：

直接买第三方：  你 → [别人网关 + 别人上游] → 官方

自建 + 官方上游：你 → [你的网关] → 官方 API

自建 + 第三方上游：你 → [你的网关] → [某第三方] → 官方

第三种只是多一层自己的管控（子 Key、限流），并没有彻底摆脱第三方；上游挂了，你这边照样挂。

1.3 自建相对买第三方，多出来的价值

维度买第三方 Key自建 Sub2API
可控性站点关站、换模型、改倍率，你说了不算上游、限流、子 Key 在自己后台
隐私提示词 / 代码过陌生服务器只过自己的 VPS（仍会上游官方）
团队一人一号，难统一管配额子 Key、分人限流、用量统计
成本含中间商利润VPS + 上游，省中间商差价
运维几乎为零Docker、数据库、证书、备份自己管

自建解决的是「网关这一层谁说了算」；上游解决的是「模型从哪来、多少钱、稳不稳」。 两者串联，不是二选一。

1.4 视频里的动机（UP 主观点）

第三方常见问题：

  • 模型时有时无、突然下架
  • 速度波动大
  • 站点跑路、关站、余额清零
  • 数据经过他人服务器，隐私不可控

自建的优势：

  • 自己掌控上游账号和 Key
  • 可给团队发「子 Key」，统一计费 / 限流
  • 比买第三方 Key 更可控（但仍有运维成本）

1.5 什么时候值得 / 不值得

值得考虑：

  • 已有 Claude / GPT / Gemini 订阅或 API，想统一接 Claude Code、Codex 等
  • 2～10 人小团队，需要分 Key、限流、看用量
  • 被第三方关站、换模型折腾过，愿意用运维换可控
  • 介意代码 / 提示词经过未知小站

个人用：多数情况不值得（直接买号 / 买 Key 更划算）：

对比项直接买 Key / 订阅自建
上手注册充值改 Base URL，约 10 分钟VPS + Docker + 上游 + HTTPS，半天起
月成本10～50 元随用随充VPS 30～80 元/月 + 上游 + 时间
子 Key / 团队管理用不上网关核心价值对个人浪费

个人就一人用时，Sub2API 最值钱的能力基本用不上，等于 多付一层 VPS 和精力。

命中下面 2 条以上，个人才略值得考虑：

  • 已有 GPT / Claude 订阅，只想给 Claude Code 接自己的入口
  • 非常介意代码经过陌生小站
  • 喜欢折腾、当学习
  • 被第三方坑过，愿意用 30 元/月 VPS 换可控

默认建议（个人 + Cursor 日常开发）： 一家靠谱中转小额充值 + 国内 API 备用，不必搭 Sub2API。

二、服务器要求

Sub2API 是 HTTP 转发网关，不跑模型、不需要 GPU。配置要求不高，网络位置往往比 CPU 更重要。

2.1 推荐配置（按场景）

场景CPU内存磁盘带宽月费参考
个人自用（1 人）2 核4G40G SSD5～10Mbps约 30～80 元
小团队（2～10 人）2～4 核4～8G40～80G SSD10Mbps+视并发而定
对外高并发4 核+8G+80G+50Mbps+另需监控与备份

个人起步：2 核 4G、40G 盘 即可（教程常见配置）。

2.2 为啥这么配（Docker 栈占用）

部署后会同时运行：

Sub2API（Go） + PostgreSQL 15+ + Redis 7+ + 系统 / Docker
组件大致内存
Sub2API100～300MB
PostgreSQL200～500MB+（随用量涨）
Redis50～200MB
系统 + Docker500MB～1G
  • 2G 内存：能跑，偏紧，易 swap 卡顿
  • 4G 内存：✅ 个人 / 小团队舒适区
  • 1 核 CPU：能试，不建议长期用；2 核 对个人够用

瓶颈多在 到上游的网络延迟 和 上游限流，不在 CPU。

2.3 地域与线路

上游类型服务器放哪更合适
OpenAI / Claude / Gemini 官方美国、日本、新加坡、香港等 海外
国内官方 API（DeepSeek、火山等）国内 机房
上游仍是某第三方中转靠近该中转推荐节点

国内访问你的网关若在海外，可能略慢；但 网关 → 上游 往往更快。生产环境建议 HTTPS 域名 + 反代，8080 不裸暴露公网。

2.4 系统与环境

  • 系统：Linux（Ubuntu 22.04 / Debian 12 常见）
  • 架构：amd64 或 arm64（Sub2API 均支持）
  • 依赖：Docker 20.10+、Docker Compose v2+
  • 端口：8080（Sub2API 默认，仅内网 / 反代）；443（对外 HTTPS）；22（SSH，建议密钥登录）

2.5 常见误区

误区说明
需要 GPU❌ 只做转发，不推理
1G 内存够用❌ PG + Redis + Docker 易 OOM
堆高配就更稳⚠️ 稳不稳主要看 上游 + 网络
自建省掉上游费用❌ 上游仍是成本大头；自建主要省 中间商 和换 可控性

2.6 成本粗算

项目大致成本
VPS 2C4G30～80 元/月
域名（可选）50～80 元/年
上游 API / 订阅另算，往往才是大头

三、6 步流程（视频主线）

步骤内容要点
① 服务器准备见 二、服务器要求
② Docker 环境安装 Docker + Docker Compose；Sub2API 官方推荐 Docker 部署
③ Sub2API 一键部署用官方脚本拉 compose + 生成 .env 密钥；默认 Web 端口 8080
④ 账号接入在后台配置上游：Claude / OpenAI / Gemini 等订阅或 API 账号
⑤ 生成子 Key给本人或团队成员发独立 Key，便于配额与权限隔离
⑥ 测试 + 域名 + 监控curl / 客户端验证；HTTPS 域名；日常看日志、用量、上游是否正常

四、Sub2API 核心知识

4.1 它是什么

Sub2API 是开源 AI API 网关，把多种上游统一成一个入口：

  • 支持：OpenAI、Claude、Gemini、DeepSeek、OpenRouter、Azure OpenAI 等
  • 兼容 OpenAI 格式：客户端只需改 base_url + api_key
  • 典型场景：Claude Code、Codex CLI、Gemini CLI、Cursor、VS Code 插件

技术栈：

  • 后端：Go + Gin + Ent
  • 前端：Vue 3 + Vite
  • 存储：PostgreSQL 15+
  • 缓存 / 限流：Redis 7+

4.2 一键部署命令（官方推荐）

mkdir -p sub2api-deploy && cd sub2api-deploy

curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/docker-deploy.sh | bash

mkdir -p data postgres_data redis_data
docker compose -f docker-compose.local.yml up -d

# 查看初始管理员信息
docker compose -f docker-compose.local.yml logs sub2api | grep -Ei "admin|password"

脚本会自动：

  • 下载 docker-compose.local.yml 和 .env.example
  • 生成 JWT_SECRET、TOTP_ENCRYPTION_KEY、POSTGRES_PASSWORD
  • 创建数据目录（便于备份迁移）

4.3 部署后典型配置

配置项说明
默认管理邮箱admin@sub2api.local（可在 .env 修改）
默认端口8080
生产环境不要裸暴露 8080，应走 Nginx / Caddy + HTTPS
客户端调用https://你的域名/v1/chat/completions + 子 Key

修改管理员密码示例：

cd sub2api-deploy
nano .env
# ADMIN_EMAIL=admin@example.com
# ADMIN_PASSWORD=your_admin_password
docker compose down && docker compose up -d

4.4 核心功能（自用场景）

  • 账号分组 / 负载均衡：多上游账号轮询，降低单号限流
  • 统一鉴权：对外只暴露你自己的 Key
  • 用量统计 / 计费：按 token 记录消耗
  • 限流策略：防止团队某人刷爆配额
  • Sticky Session：多账号场景下会话粘滞（Nginx 需开 underscores_in_headers on）

五、与 NewAPI 类教程的对比

维度NewAPI 类（如 BV1YTG16EEan）本视频（Sub2API）
工具NewAPISub2API
目标token 自由、可能含副业自用 / 小团队
风险强调较少明确讲第三方不稳定
运维一键 + 上游渠道Docker + 账号 + 子 Key + 监控

六、风险与边界

视频虽强调「自用更可控」，但仍有这些风险（Sub2API 官方 README 也写明）：

  1. 违反上游 ToS：把 Claude / OpenAI 订阅转成 API relay，可能违反服务条款，存在 封号 风险
  2. 合规：国内对外提供大模型聚合服务有政策灰色地带；仅自用 与 对外售卖 风险差异很大
  3. 安全：管理后台、数据库、Redis 需设强密码；生产必须 HTTPS；勿把管理端口暴露公网
  4. 上游依赖：自建只是「自己当中转」，上游账号仍可能限流、变更、失效
  5. 运维成本：PostgreSQL / Redis / 备份 / 升级都要自己管

实用原则：

  • 自用：小额测试、不传敏感代码 / 密码
  • 团队：子 Key + 限流 + 日志审计
  • 勿一开始就对外卖 Key、收款、注册开放

更多第三方中转站消费端风险见 AI 中转站网站汇总 · 风险提示。

七、部署检查清单

□ VPS 已就绪（2C4G 起，见第二节）
□ Docker + Compose 已安装
□ sub2api-deploy 目录已创建，脚本执行成功
□ docker compose ps 全部 healthy
□ 已登录 Web 后台并修改默认密码
□ 上游账号 / 渠道已配置且测试通过
□ 已生成自用 / 团队子 Key
□ 客户端 base_url 指向自己的域名（HTTPS）
□ 反向代理 + 证书已配置
□ 日志 / 用量监控习惯已建立（定期 docker compose logs）
□ 数据目录 backup 策略（data/ postgres_data/ redis_data/）

八、客户端调用示例

curl https://你的域名/v1/chat/completions \
  -H "Authorization: Bearer sk-你的子Key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "你好"}]
  }'

Claude Code / Codex CLI 等工具：将 Base URL 改为 https://你的域名，API Key 填子 Key 即可。

九、一句话总结

个人用：直接买 Key / 订阅更省事，自建多数不划算。
小团队 / 要控网关：用 Sub2API + Docker（2C4G 起）搭自用网关，核心价值是 网关可控，代价是 运维 + 上游 + 合规风险。
上游仍要自备；自建 不能 替代上游，只是 不必把网关和数据完全交给陌生小站。