一天一个开源项目(第109篇):Sub2API - 一站式 Claude/OpenAI/Gemini 订阅转 API 中转服务
引言“让 AI 订阅配额流动起来让每一分成本都发挥最大价值。”这是一天一个开源项目系列的第109篇文章。今天带你了解的项目是Sub2API(也称为 CRS2)。随着 Claude Code、GitHub Copilot 等原生工具的兴起很多开发者手中都有多份 AI 订阅如 Claude Pro、OpenAI Plus但这些订阅往往有频率限制或配额闲置。如何把这些分散的订阅资源整合起来并在不同工具、不同用户之间高效分摊成本Sub2API提供了一个完美的开源方案。它不仅仅是一个简单的转发器而是一个功能齐备的 API 代理平台支持从账号管理、额度分摊到自动化计费、内置支付的全流程特别适合团队共享、拼车或个人多账号整合。你将学到什么Sub2API 的核心定位与解决的痛点支持的主流模型与订阅类型核心功能特性多账号管理、智能调度、Token 计费快速部署方式脚本安装与 Docker Compose如何利用 Sub2API 搭建自己的 API 中转服务前置知识了解常见 AI 模型的 API 使用OpenAI, Claude, Gemini 等具备基础的 Linux 操作经验了解 Docker 或容器化部署概念项目背景项目简介Sub2API 是一个基于 Go 语言开发的 AI API 网关平台。它的核心逻辑是将来自各种渠道的 AI 订阅包括 OAuth 认证账号、Session Key 或标准 API Key进行“池化”管理。通过 Sub2API你可以聚合资源将多个 Claude Pro 或 OpenAI 账号接入统一对外输出 standard API。分摊成本支持拼车共享机制通过内置的计费系统按量收费。无缝使用生成的 API 与原生工具如 Claude Code, OpenClaw 等无缝衔接无需复杂的客户端配置。作者/团队介绍维护方Wei-Shaw生态项目该项目拥有活跃的社区支持包括移动端管理后台sub2api-mobile等周边生态。项目数据核心仓库: Wei-Shaw/sub2api️技术栈: Go (Gin, Ent), Vue 3, PostgreSQL, RedisLicense: LGPL-3.0Stats: GitHub 22k Stars (注可能包含历史库数据或高度关注度)主要功能核心作用Sub2API 解决了 AI 资源利用中的“孤岛问题”上游账号池 (Claude, OpenAI, Gemini) ↓ 接入接入 Sub2API 平台层 (鉴权、计费、负载均衡、连接保持) ↓ 统一分发 下游应用 (IDE, Chat客户端, 脚本工具)核心特性多账号管理支持多种上游账号类型自动处理 Session 保持。精确计费Token 级使用跟踪和成本计算支持自定义费率。智能调度支持粘性会话Sticky Sessions和负载均衡确保长对话的连贯性。内置支付系统内置支持支付宝、微信、Stripe 等支付方式支持用户自助充值。并发控制与频率限制针对用户和上游账号分别设置并发数和请求限制。管理面板提供直观的 Web UI 进行监控和管理。快速开始方式一一键脚本安装推荐适用于干净的 Ubuntu/Debian 系统curl-sSLhttps://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/install.sh|sudobash注意事项需要预装 PostgreSQL 15 和 Redis 7。脚本会自动创建 systemd 服务并安装二进制文件到/opt/sub2api。方式二Docker Compose 部署# 创建部署目录mkdir-psub2api-deploycdsub2api-deploy# 下载并执行配置准备脚本curl-sSLhttps://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/docker-deploy.sh|bash# 启动服务dockercompose up-d安装完成后通过浏览器访问http://YOUR_SERVER_IP:8080即可进入管理后台。项目详细剖析架构设计为什么这不仅仅是反向代理Sub2API 的设计重心在于“账号状态管理”。传统的反代工具如 Nginx不具备理解应用层会话的能力。粘性会话 (Sticky Sessions)对于 Claude Code 等需要保持上下文连续性的工具Sub2API 会通过 Header 中的session_id将请求锁定在特定的上游账号上避免因切换账号导致的对话中断。注意使用 Nginx 反向代理时需开启underscores_in_headers on;以支持 session 标头。配额与池化逻辑系统会将多个账号抽象为一个“资源池”。当一个账号达到频率限制Rate Limit时调度器会自动避开该账号最大化提升整体可用率。内置支付与用户体系大部分中转工具需要配合外部支付网关。Sub2API 选择了内置集成极大地降低了中小团队或“拼车头子”运维系统的复杂度。技术栈选型后端: 使用 Go 语言保证了高并发处理能力及其部署的便捷性。数据库: 选用 PostgreSQL 处理复杂的关联关系和计费记录。缓存: Redis 用于请求频率限制和实时状态同步。项目地址与资源官方资源GitHub: Wei-Shaw/sub2api官方文档: 项目仓库中包含详细的部署、支付配置及 API 使用指南。️演示地址: https://demo.sub2api.org/适用人群AI 拼车主希望分摊 Claude/OpenAI Plus 成本的组织者。开发者/重度用户希望整合多个账号配额供日常原生工具使用的个人。企业内测团队需要在内部统一分发和审计 AI 资源使用情况的团队。总结与展望核心要点回顾定位明确专注于将订阅制配额转化为标准 API 服务。一体化集成管理、调度、计费、支付全流程闭环。部署友好支持脚本、Docker 等多种一键部署方案。性能可靠Go 语言后端配合 Redis/PostgreSQL性能足以支撑中大规模分发。一句话评价Sub2API 是目前市面上将“资源聚合”与“商业化模型”结合得最紧密的开源 API 中转方案是实现 “订阅自由” 的强力工具。欢迎来我的个人主页找到更多有用的知识和有趣的产品