Wei-Shaw/sub2api

Sub2API 是面向持有多份 AI 产品订阅的团队的自托管网关：管理员登记上游账号、分组，再发放带配额的 Sub2API Key，由平台负责认证、按 token 计费、负载均衡、并发与速率限制以及请求转发 项目概览。

网关如何工作

上游凭据既可以是 OAuth 订阅账号，也可以是普通 API Key 功能列表。请求走兼容 OpenAI Chat Completions/Responses、Anthropic Messages、Antigravity 专用路径、Grok 的 Responses 与媒体端点以及 TypeSafe 原生 System One 等协议的端点，再转发到对应上游 Grok / xAI 支持。调度器在多个账号间做粘性会话选择，Composite Groups 则能把请求的模型解析到多上游中的具体提供方 Composite Groups。管理端提供 Web 面板、内置支付（EasyPay、支付宝、微信支付、Stripe）以及用 iframe 嵌入工单等外部系统的能力 支付指南。

一个具体流程

管理员先添加一个 Grok OAuth 账号或 xAI API Key 账号，创建 Grok 分组并把账号挂进去，再签发绑定该分组的用户 Key；用户把 Grok CLI 的 base URL 指向网关的 /v1 并填入该 Key 即可。用户页的 Use Key 弹窗会为 macOS/Linux 或 Windows 生成对应配置 Grok / xAI 支持。Claude Code 等客户端也按同样思路使用各自的端点 base URL。个人开发者或内部团队可设 RUN_MODE=simple 隐藏 SaaS 功能并跳过计费流程，但生产环境启动时还必须设 SIMPLE_MODE_CONFIRM=true。

依赖与部署方式

服务需要 PostgreSQL 15+ 和 Redis 7+ 技术栈。README 记录了四条路径：

• 安装脚本（Linux amd64/arm64）：下载预编译二进制、安装到 /opt/sub2api 并配置 systemd；需要 root、PostgreSQL 和 Redis。之后可在管理面板一键检查更新并支持回滚。
• Docker Compose：需要 Docker 20.10+ 与 Compose v2+。本地目录版把数据放在普通目录中，便于整包备份和迁移；命名卷版迁移则需要 Docker 命令。
• Apple container：适用于 macOS 26 的 Apple 芯片 Mac，需要 container 1.1.0+；文档将其定位为运维者自行管理的本机流程，而非推荐的生产路径 README。
• 源码构建：Go 1.21+、Node.js 18+、PostgreSQL 和 Redis。若已按步骤生成 config.yaml，首次启动会跳过设置向导，管理员账号不会被创建，登录会报 invalid email or password。README 给出的两条补救路径是让向导生成配置，或临时移走该文件让向导先跑完。

需要注意的限制

项目声明明确警告：使用本项目可能违反 Anthropic 等上游的服务条款，账号封禁、服务中断、数据丢失等风险由使用者承担；开发者从未授权任何个人或组织基于本项目进行商业运营 重要提示。运维上，关闭 URL 白名单后默认允许明文 HTTP，生产环境应显式限制为仅 HTTPS；旧的转发头接管逻辑默认开启以兼容升级，建议改为有限的可信代理列表 README。Anthropic 的 Claude 与 Antigravity 的 Claude 不能混在同一对话上下文中，需用分组隔离。许可证为 LGPL-3.0-or-later LICENSE。

HotRepo 点评

2026-10-29 该仓库有 45,081 stars，当日热榜记录 +80。现有热榜样本过少，无法据此判断上升或衰退趋势。