sub2api

Sub2API

AI API 网关平台，用于订阅配额分发

English | 中文 | 日本語

⚠️ 重要声明

使用本项目前，请仔细阅读以下内容：

• 🚨 服务条款风险：使用本项目可能违反 Anthropic 及其他上游提供商的服务条款。使用前请仔细阅读相关提供商的用户协议；由此产生的所有风险均由使用者自行承担。
• ⚖️ 合规使用：请仅在遵守您所在国家或地区法律法规的前提下使用本项目。严禁任何非法使用行为。
• 📖 免责声明：本项目仅供技术学习和研究使用。作者对因使用本项目导致的账号封禁、服务中断、数据丢失或任何其他直接或间接损失不承担任何责任。
• 🚫 未授权商业用途：本项目开发者从未授权任何个人或组织基于本项目进行任何形式的商业运营。任何以本项目名义或基于本项目进行的商业活动均与本项目及其开发者无关，由此产生的所有纠纷、损失及法律责任由从事该活动的一方自行承担。

❤️ 赞助商

想在这里展示？

	感谢 CCTK.AI 赞助本项目！CCTK.AI 是一个专注于稳定性和性价比的 AI API 网关，为 Claude、OpenAI、Gemini 等热门模型提供高速转发服务。它与 Claude Code、Codex 及其他主流编程工具无缝协作，以官方价格的一小部分即可获得同等模型能力。通过 此链接 注册，享受更快、更稳定、更实惠的 AI API 接入。
	一个 API，尽享所有顶级模型！OpenModel 是一个生产级、高可用的 AI API 网关，让您的应用真正实现快速稳定：自动故障转移、智能路由到性能最佳的通道，以及生产级 SLA。其 SLA 远超任何单一提供商——让稳定性成为您的核心竞争力。可直接配合 Claude Code、Codex 和 Gemini CLI 使用。通过此链接注册即可开始使用。
	感谢 ETok.ai 赞助本项目！ETok.ai 致力于打造一站式 AI 编程工具服务平台。我们提供专业的 Claude Code 套餐和技术社区服务，同时支持 Google Gemini 和 OpenAI Codex。通过精心设计的套餐和专业技术社区，我们为开发者提供可靠的服务保障和持续的技术支持，让 AI 辅助编程成为真正的生产力工具。点击这里注册！
	感谢 APIKEY.FUN 赞助本项目！APIKEY.FUN 是 sub2api 开源项目的核心贡献者之一，致力于提供开放、稳定、高性价比的 AI API 接入服务。平台支持 Claude、OpenAI、Gemini 等热门模型的 API 转发服务，价格低至原价的 7%。通过专属链接注册：APIKEY，所有充值可享最高 95 折优惠。
	感谢 AIGoCode 赞助本项目！AIGoCode 是一个集成了 Claude Code、Codex 和最新 Gemini 模型的一体化平台，为您提供稳定、高效、高性价比的 AI 编程服务。平台提供灵活的订阅方案、零封号风险、无需 VPN 直连、响应极速。AIGoCode 为 sub2api 用户准备了专属福利：通过此链接注册，首次充值即可额外获得 10% 的赠送额度！
	非常感谢 BmoPlus 赞助本项目！BmoPlus 是一个专为重度 AI 用户和开发者打造的、高度可靠的 AI 账号提供商。他们提供稳定可靠、开箱即用的账号及官方充值服务，涵盖 ChatGPT Plus / ChatGPT Pro（全额质保）/ Claude Pro / Super Grok / Gemini Pro。通过BmoPlus - 优质 AI 账号与充值注册下单，用户可享受低至官方 GPT 订阅价格 10%（90% 折扣）的超值优惠。
	感谢 Bestproxy 赞助本项目！Bestproxy 提供高纯净度住宅 IP，支持一账号一 IP 专属服务。通过真实家庭网络与指纹隔离相结合，实现链路环境隔离，降低关联风控概率。
	感谢 PatewayAI 赞助本项目！PatewayAI 是一个专为重度 AI 开发者打造的优质 API 转发服务，提供全系列 Claude 和 Codex 模型，100% 源自官方提供商，支持透明的 token 级计费。企业套餐包含高并发、专属管理、合同和发票服务。立即注册可获 $3 试用额度，充值低至 6 折，推荐奖励最高 $150。
	感谢 PPToken.cc 赞助本项目！PPToken.cc 专注于 GPT 模型 API 转发服务，支持 Codex、Claude Code、OpenAI 兼容客户端和 Gemini CLI 集成。充值 1:1（¥1 = $1 额度）；GPT 模型最低 0.16 倍率起，整体成本约为官方价格的 2.2%，首 token 延迟约 1 秒——非常适合追求低成本、高速访问 GPT 模型能力的开发者。技术支持：7×24 小时真人响应（非机器人），群内 @tech 10 分钟内回复。赞助福利：前 200 名通过专属注册链接注册并输入优惠码 `SUB2API` 的用户，可免费领取 Codex / Claude Code 试用额度——无需最低消费，无需绑定银行卡。
	感谢 Veilx 赞助本项目！Veilx CDN 专为大规模 AI API 流量而设计，针对 OpenAI、Claude、Gemini 的转发服务及 chat、图像生成、embeddings、流式传输等调用链路做了深度优化——在高并发下提供更低延迟和更高稳定性。同时提供国内三网优化回源线路，非常适合全球 AI 转发平台、海外 AI SaaS 和跨境高并发部署。
	感谢 RoxyBrowser 赞助本项目！RoxyBrowser 是 Sub2API 的完美搭档：内置原生 Roxy AI Agent 和高质量原生住宅 IP，支持通过简单命令进行批量自动化操作，显著提升多账号管理的安全性和效率！点击此链接注册，即可获赠住宅 IP 体验包及终身 9 折优惠。
	感谢随想 AI 网关赞助本项目！随想 AI 网关 是一家可靠高效的 API 转发服务提供商，提供 Claude、Codex、Gemini 等模型的转发服务。这是一个注重隐私的转发服务——不转卖数据、不稀释模型；隐私、透明、闪电般的售后服务。新账号每日签到可获 ¥0.5 试用额度；充值 1:1，无需订阅，按量付费。多线路冗余、跨地域容灾、自动故障转移、长连接 SSE 不间断。99.9% 可用性——关键调用永不掉队。
	感谢 Proxy4Free 赞助本项目！Proxy4Free 是一家面向开发者和 AI 应用的数据代理服务提供商，提供住宅代理、静态住宅代理、ISP 代理和数据中心代理，适用于 Web 爬取、浏览器自动化和 AI Agent 等场景。凭借全球 IP 资源、稳定连接和灵活切换，帮助开发者提升数据采集成功率并降低 IP 封禁风险。通过此链接注册，轻松构建更稳定高效的自动化工作流。
	🎉 感谢 FastAIToken 赞助本项目！FastAIToken 是一个面向开发者的 AI API 聚合平台，支持 OpenAI、Claude、Gemini 等主流大模型。充值 1:1——1 元人民币 = 1 美元 API 额度——让开发者以更低成本、更便捷地使用全球领先的大模型服务。 🚀 平台提供多种通道可选：超低价 0.02 倍 OpenAI 促销组（限时）、低至 0.25 倍的 OpenAI 组、0.7 倍且 95% 固定缓存的 Claude 组，以及 1.2 倍 Claude Max 通道。同时提供公开状态页，实时展示各通道的可用性、延迟和运行状态，服务透明可靠，另有 7×24 小时人工技术支持（非机器人），快速响应开发者需求。
	感谢 Aimzoon 赞助本项目！Aimzoon 提供稳定、高性价比的 AI API 接入服务，帮助开发者将热门 AI 服务快速接入 Codex、Claude Code、Gemini CLI 等编程工具。无需复杂配置——更快的接入、更稳定的调用、更低的成本。持续推出 Codex 优惠价和特惠活动，注册即送免费试用额度，让 AI 编程融入您的日常工作流。点击这里注册体验！
	Nagora 是一个专为开发者和团队打造的多模型 AI API 网关。通过一个账号和一个 API Key，即可通过统一接口访问超过 26 款领先的文本和图像模型。它兼容 OpenAI、Anthropic 和 Gemini 协议，可无缝集成 Claude Code、Codex、Gemini CLI 等开发工具。平台提供智能路由、自动故障转移、透明定价和统一账单，并支持预算管理、速率限制和并发控制。这使得 AI 使用在个人开发、团队协作和生产环境中都更加可靠且易于管理。无需更改现有应用——只需替换 Base URL 和 API Key，最快一分钟即可完成集成。
	感谢 Novada 赞助本项目！Novada 为构建 AI 应用和自动化工作流的开发者提供住宅、ISP、数据中心和移动代理，以及 Web Unlocker 和 Scraper API。凭借全球 IP 覆盖、灵活的轮换和粘性会话以及精准的地理定位，Novada 帮助团队为 AI Agent 工作流、跨区域测试、网络研究和浏览器自动化可靠地获取网络数据。探索 Novada，构建更稳定、可扩展的 AI 工作流。
	感谢七牛 AI 赞助本项目！七牛 AI 是七牛云（02567.HK）旗下的企业级大模型 MaaS 平台，提供全球 150+ 主流模型的一站式接入，兼容全球主流模型厂商协议，覆盖文本、图像、音频、视频、文件处理等全模态能力，已服务超 169 万企业和开发者。七牛 AI 为 Sub2API 用户提供专属福利：通过此链接注册——企业用户免费获赠 1200 万 tokens，开发者免费获赠 300 万 tokens。
	感谢 FennoAI 赞助本项目！FennoAI 是一家面向企业研发团队和开发者的高稳定性、高性能 API 转发服务商，兼容 OpenAI 和 Anthropic 协议，可无缝集成 Codex、Claude Code、OpenCode 等主流 AI 编程工具。平台具备企业级稳定性，支持每日千亿 token 的调用量，并支持境内外主体的企业对公结算和开票，满足企业研发与采购需求。作为 Sub2API 用户的专属福利，通过专属链接购买订阅，仅需 $1.99 即可获得价值 $50 的 Coding Plan 额度。另有推荐奖励：邀请好友购买，最高可获 20% 佣金——邀得越多，赚得越多。
	感谢 LanoX AI 赞助本项目！LanoX AI 为开发者、团队和企业提供稳定、高性价比的全球模型接入服务。🎁 新用户福利——领取数百万免费 tokens，外加 500+ 免费模型，轻松低成本测试、验证和部署 🧠 全球领先模型——GPT · Claude · Gemini · Qwen · Grok... 🎬 多模态创作——Seedance 2.0 · GPT Image · Gemini Nano Banana 🛡️ 企业级可靠性——高可用 💎 原生能力输出 💎 无智能降级 💎 不混模型 💎 用量计费透明 💰 更低 API 成本——顶级模型低至官方价格 10%，文档清晰、集成简单、支持开票、企业级批量使用 🏢 企业之选——非常适合高用量模型调用的 AI 产品、Agent、内容平台和研发团队
	RapidProxy 是一个专为开发者打造的数据采集代理解决方案，提供稳定可靠的住宅代理服务。拥有 9000 万+ 全球住宅 IP、覆盖 200+ 国家和地区、智能轮换和精准地理定位，帮助网页爬取、AI 数据训练、SEO 监控、电商数据分析等项目突破访问限制，提升数据采集效率。支持 Playwright、Selenium、Puppeteer 等主流自动化框架，价格低至 $0.65/GB——立即开始免费测试。
	hao.ai 是一个面向开发者和团队的高速、稳定的大模型统一 API 网关。通过一个 API Key 和统一接口，即可访问 GPT、Claude、xAI Grok 等主流模型，兼容 OpenAI、Anthropic 等常见协议和 SDK。平台提供模型路由、故障转移、团队管理和完整请求日志，模型价格低至官方参考价的 15%，帮助用户更简单、更可靠、更低成本地构建 AI 应用。
	Swiftproxy 是一个专为开发者打造的高性能代理解决方案，提供稳定可靠的住宅和静态住宅代理服务。拥有 9000 万+ 纯净住宅 IP、全球覆盖、灵活轮换和精准地理定位，帮助网页爬取、AI 自动化、浏览器自动化、SEO 监控、多账号管理等项目突破访问限制，提升工作流效率。支持 HTTP(S) 和 SOCKS5 协议，可集成 Playwright、Selenium、Puppeteer 等流行自动化工具，动态代理流量不过期、按量计费，并提供免费测试——立即开始免费测试！
	DuckIP - 9000 万+ 全球住宅网络资源，覆盖 195+ 个国家和地区，支持轮换和粘性会话，适用于公开数据采集、RAG 更新、模型评估和多区域数据工作负载。🟢 住宅代理 - 8 折优惠；🟢 静态住宅代理 - 低至 ¥50.00/IP；🟢 不限量住宅代理 - 低至 ¥19.8/小时。✅ 免费领取 500M 试用流量。

概述

Sub2API 是一个 AI API 网关平台，用于分发和管理 AI 产品订阅的 API 配额。用户可以通过平台生成的 API Key 访问上游 AI 服务，而平台负责处理认证、计费、负载均衡和请求转发。

功能特性

• 多账号管理 - 支持多种上游账号类型（OAuth、API Key）
• API Key 分发 - 为用户生成和管理 API Key
• 精准计费 - token 级用量跟踪和费用计算
• 智能调度 - 智能账号选择，支持粘性会话
• 并发控制 - 用户级和账号级并发限制
• 速率限制 - 可配置的请求和 token 速率限制
• 内置支付系统 - 支持 EasyPay、支付宝、微信支付和 Stripe，用户可自助充值，无需额外部署支付服务（配置指南）
• 管理后台 - 用于监控和管理的 Web 界面
• 组合分组 - 管理员路由层，可解析请求模型到具体提供商，支持多提供商分组（操作指南）
• 外部系统集成 - 通过 iframe 嵌入外部系统（如工单系统）以扩展管理后台

生态项目

扩展或集成 Sub2API 的社区项目：

项目	描述	功能
Sub2ApiPay	自助支付系统	现已内置 — 支付功能已集成到 Sub2API 中，无需单独部署。参见支付配置指南
sub2api-mobile	移动管理控制台	跨平台应用（iOS/Android/Web），支持用户管理、账号管理、监控仪表盘和多后端切换；基于 Expo + React Native 构建

技术栈

组件	技术
后端	Go 1.26.5, Gin, Ent
前端	Vue 3.4+, Vite 5+, TailwindCSS
数据库	PostgreSQL 15+
缓存/队列	Redis 7+

---

Nginx 反向代理注意事项

当使用 Nginx 作为 Sub2API（或 CRS）配合 Codex CLI 的反向代理时，请在 Nginx 配置的 http 块中添加以下内容：

underscores_in_headers on;

Nginx 默认会丢弃包含下划线的请求头（如 session_id），这会破坏多账号配置中的粘性会话路由。

---

部署

方式一：脚本安装（推荐）

一键安装脚本，从 GitHub Releases 下载预编译二进制文件。

前提条件

• Linux 服务器（amd64 或 arm64）
• PostgreSQL 15+（已安装并运行）
• Redis 7+（已安装并运行）
• root 权限

安装步骤

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

该脚本将：

1. 检测您的系统架构
2. 下载最新版本
3. 安装二进制文件到 /opt/sub2api
4. 创建 systemd 服务
5. 配置系统用户和权限

安装后

# 1. 启动服务
sudo systemctl start sub2api

# 2. 设置开机自启
sudo systemctl enable sub2api

# 3. 在浏览器中打开安装向导
# http://YOUR_SERVER_IP:8080

安装向导将引导您完成：

• 数据库配置
• Redis 配置
• 管理员账号创建

升级

您可以直接在管理后台中点击左上角的检查更新按钮完成升级。

Web 界面将：

• 自动检查新版本
• 一键下载并应用更新
• 需要时支持回滚

常用命令

# 查看状态
sudo systemctl status sub2api

# 查看日志
sudo journalctl -u sub2api -f

# 重启服务
sudo systemctl restart sub2api

# 卸载
curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/install.sh | sudo bash -s -- uninstall -y

---

方式二：Docker Compose（推荐）

使用 Docker Compose 部署，包含 PostgreSQL 和 Redis 容器。

前提条件

• Docker 20.10+
• Docker Compose v2+

快速开始（一键部署）

使用自动化部署脚本轻松完成设置：

# 创建部署目录
mkdir -p sub2api-deploy && cd sub2api-deploy

# 下载并运行部署准备脚本
curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/docker-deploy.sh | bash

# 启动服务
docker compose up -d

# 查看日志
docker compose logs -f sub2api

脚本执行的操作：

• 下载 docker-compose.local.yml（保存为 docker-compose.yml）和 .env.example
• 生成安全凭据（JWT_SECRET、TOTP_ENCRYPTION_KEY、POSTGRES_PASSWORD）
• 创建包含自动生成密钥的 .env 文件
• 创建数据目录（使用本地目录便于备份/迁移）
• 显示生成的凭据供您参考

手动部署

如果您更喜欢手动设置：

# 1. 克隆仓库
git clone https://github.com/Wei-Shaw/sub2api.git
cd sub2api/deploy

# 2. 复制环境配置
cp .env.example .env
chmod 600 .env

# 3. 编辑配置（生成安全密码）
nano .env

.env 中的必需配置：

# PostgreSQL 密码（必填）
POSTGRES_PASSWORD=your_secure_password_here

# JWT 密钥（推荐 - 重启后保持用户登录状态）
JWT_SECRET=your_jwt_secret_here

# TOTP 加密密钥（推荐 - 重启后保留两步验证）
TOTP_ENCRYPTION_KEY=your_totp_key_here

# 可选：管理员账号
ADMIN_EMAIL=admin@example.com
ADMIN_PASSWORD=your_admin_password

# 可选：自定义端口
SERVER_PORT=8080

生成安全密钥：

# 生成 JWT_SECRET
openssl rand -hex 32

# 生成 TOTP_ENCRYPTION_KEY
openssl rand -hex 32

# 生成 POSTGRES_PASSWORD
openssl rand -hex 32

# 4. 创建数据目录（本地版本使用）
mkdir -p data postgres_data redis_data

# 5. 启动所有服务
# 选项 A：本地目录版本（推荐 - 便于迁移）
docker compose -f docker-compose.local.yml up -d

# 选项 B：命名卷版本（简单设置）
docker compose up -d

# 6. 检查状态
docker compose -f docker-compose.local.yml ps

# 7. 查看日志
docker compose -f docker-compose.local.yml logs -f sub2api

部署版本对比

版本	数据存储	迁移	适用场景
docker-compose.local.yml	本地目录	✅ 简单（直接打包整个目录）	生产环境、频繁备份
docker-compose.yml	命名卷	⚠️ 需要 docker 命令	简单设置

建议： 使用 docker-compose.local.yml（脚本部署的版本），数据管理更方便。

访问

在浏览器中打开 http://YOUR_SERVER_IP:8080。

如果管理员密码是自动生成的，请在日志中查找：

docker compose -f docker-compose.local.yml logs sub2api | grep "admin password"

升级

# 拉取最新镜像并重建容器
docker compose -f docker-compose.local.yml pull
docker compose -f docker-compose.local.yml up -d

轻松迁移（本地目录版本）

使用 docker-compose.local.yml 时，可以轻松迁移到新服务器：

# 在源服务器上
docker compose -f docker-compose.local.yml down
cd ..
tar czf sub2api-complete.tar.gz sub2api-deploy/

# 传输到新服务器
scp sub2api-complete.tar.gz user@new-server:/path/

# 在新服务器上
tar xzf sub2