Repository navigation
Releases
Sub2API 0.2.21.1
AI API 网关平台 - 订阅配额分发管理
- 累计同步 v0.2.18 至 v0.2.21 的正式更新，新增 GPT-6.1 Terra、Claude Fable 5.2 / Mythos 5.2 支持及 30 分钟 / 12 小时缓存写入计费。
- 接入细粒度管理员 API Key、可选管理 MCP、注册邮箱黑名单与图片按张计费功能。
- 合入流式用量计费、Responses / WebSocket 会话、请求体内存预算、读写超时、账号配额与模型冷却修复。
- 保留 OKPay、TRC20、动态汇率、工单、社区、批量邮件、插件、模型检测及 Codex 透支等定制能力。
- 兼容上游连通性测试提示词与输出预算，同时保留模型能力检测的单次请求、4096 输出预算和完整回答校验。
- 重新生成数据库模型与服务依赖，保留两侧新增字段、索引和服务；统一 Go 1.27.4 构建环境以修复标准库安全漏洞，保留图片解码依赖的安全修复。
升级注意：
- 启动时自动执行新增数据库迁移。usage_logs 的并发覆盖索引在数据量较大时可能延长首次启动时间。
- 现有 Gemini / Antigravity 分组会自动开启生图；混合分组需按实际需求手动开启「允许当前分组生图」。
- 管理 MCP 默认关闭，需要时设置 MCP_PUBLIC_URL；请求体内存预算配置键为 gateway.request_body_memory_budget_bytes。
- Gemini 默认模型列表已移除 2.x，仍需使用时请配置白名单或模型映射；部分模型计费与推理参数规则随上游更新。
安装
docker pull ghcr.io/nieten/sub2api:0.2.21.1也可以在本页面下载与操作系统对应的压缩包。
Sub2API 0.2.17.1
AI API 网关平台 - 订阅配额分发管理
- 支持 Gemini 4 Argon，合入模型目录、兼容协议与账号调度修复。
- 合入支付回调查单确认、退款处理及 Stripe 密钥传递修复，保留 OKPay、TRC20 和动态汇率等定制能力。
- 保留模型检测的单次请求、完整回答校验和思考内容过滤，同时兼容上游图片测试。
- 修复可用账号筛选误排除缺少透支信息的正常账号。
- 修复数据模型生成代码的字段与数据库索引列错位，补齐部署配置，并升级存在已知漏洞的图片解码依赖。
升级注意：ChatGPT OAuth / SetupToken 账号不再支持 GPT-5.5，API Key 账号不受影响。使用订阅账号的站点请调整模型映射。
安装
docker pull ghcr.io/nieten/sub2api:0.2.17.1也可以在本页面下载与操作系统对应的压缩包。
Sub2API 0.2.14.1
AI API 网关平台 - 订阅配额分发管理
本版合入上游 v0.2.14 的安全更新与依赖审计修复。
-
全新自动安装不再使用可猜测的默认管理员账号；未设置
ADMIN_EMAIL时生成随机登录邮箱，并在首次启动日志中输出。 -
自动安装时校验显式设置的管理员邮箱和密码长度，已有管理员或用户的部署不会因此阻断启动。
-
修复 EasyPay 支付回调可被伪造到账的安全漏洞：回调验签拒绝非标准通知参数，支付返回地址不再保留客户端查询参数。
-
修复远程 Codex 模型目录的“使用密钥”配置缺少
api_key_model_discovery的问题。 -
更新前端依赖以合入上游安全审计修复。
-
已有实例可直接升级；若仍使用旧默认管理员邮箱或弱密码，建议在后台修改管理员邮箱与密码。
-
全新自动安装时，
ADMIN_PASSWORD必须为 8 至 72 字节，ADMIN_EMAIL必须是合法登录邮箱。 -
前端已完成语言检查、类型检查及生产构建；管理员安装与 EasyPay 回调相关后端回归通过。发布流水线将再次构建前端和各平台程序。
安装
docker pull ghcr.io/nieten/sub2api:0.2.14.1也可以在本页面下载与操作系统对应的压缩包。
Sub2API 0.2.13.3
AI API 网关平台 - 订阅配额分发管理
本次基于已同步的上游正式版 v0.2.13，合入已完成的 UI 审查修正。
-
质量检测：完善模型加载提示、长名称布局、计划和手动检测弹窗的固定操作区。
-
机器人与群发、邮件群发：统一分段导航、配置卡片、收件模式、按钮的选中与加载反馈。
-
工单：对话历史独立滚动，回复区域保持在页面内，完善图片预览、发送状态与失败重试。
-
社群与 VIP、成员绑定：优化设置分组、依赖禁用、筛选与清除、成员详情和群聊布局，修正小桌面窗口表格过矮问题。
-
共用按钮、下拉框和弹窗：改善键盘焦点、清除、Escape 和 Tab 行为，限制下拉框边缘溢出并支持窗口变化后重新定位。
-
支付、账户、登录、首页及 API 接入页面：修正移动端溢出、长标题、暗色显示和菜单高亮，保持现有业务流程。
-
六个后台模块完成 1024、1440、1920 宽度检查，以及所列按钮、下拉框和错误恢复的本地模拟 API 验收。
-
相关模块、共用下拉框与弹窗的定向测试通过；76 个前端变更文件 ESLint 通过。
-
前端语言检查、类型检查和生产构建通过；本地嵌入前端资源的程序构建及 0.2.13.3 版本输出验证通过；发布流程再次构建前端与五个平台程序。
-
中文审查清单和修改前后截图已归档到 docs/UI缺陷审查与前后对照.md、docs/桌面端控件审查与前后对照.md。
-
本版主要修复 UI，不涉及数据库迁移。
-
邮件富文本编辑与模板、按筛选条件直接群发、成员默认仅显示已入群、充值与并发变动记录及独立禁入管理等历史业务缺口，本版未新增。
-
本地模拟发送不代表真实邮件、Telegram、支付或生产环境业务完成。已有 Codex 接入指南 /v1 基线断言失败仍保留，未据定向验证宣称全项目测试通过。
安装
docker pull ghcr.io/nieten/sub2api:0.2.13.3也可以在本页面下载与操作系统对应的压缩包。
Sub2API 0.2.13.2
AI API 网关平台 - 订阅配额分发管理
选择 Claude Desktop 后，旧流程实际生成 Claude Code 导入链接，并依赖仅在 Desktop 空列表显示的迁移按钮，已有供应商时无法按指引完成。
本版本将两个入口改为 Desktop 专用配置向导，支持供应商名称、请求地址、API Key 和模型字段复制；根据所选模型提示直连或模型映射、本地路由及重启步骤。旧式 [1M] 后缀与实际模型 ID 分开处理，避免将上下文标记发送上游。
CC Switch v3.20.4 尚不支持网页直接导入 Desktop，本版本不把 CLI 导入或字段复制表示为 Desktop 导入成功。保留 CLI 及其他客户端现有导入功能。
验证：245 项相关回归测试、i18n、类型检查、生产前端构建通过；本地浏览器验证密钥遮罩与复制、明暗主题及响应式布局。未使用真实密钥进行 Desktop 对话，未产生模型调用费用。
仍基于已合并的上游正式版本 v0.2.13。
安装
docker pull ghcr.io/nieten/sub2api:0.2.13.2也可以在本页面下载与操作系统对应的压缩包。
Sub2API 0.2.13.1
AI API 网关平台 - 订阅配额分发管理
本次仅合并 Wei-Shaw/sub2api 已发布标签 v0.2.13，源提交为 3040209，不包含该标签之后的未发布提交。
- 同步 TypeSafe / Jev System One、充值赠金与折扣阶梯、按分组排序密钥、账户优先级快捷调整，以及邮件验证码、密码重置、匿名订单查询与计费修复。
- OKPay 支持后台配置自定义图标，充值及订阅入口同步展示；未设置或加载失败时使用默认图标。
- 按实际参考页面重做一键接入，提供客户端、密钥、系统和模型选择，以及安装说明、CC Switch 导入、原生配置复制和下载。
- Claude Code 与 Claude Desktop 分开选择；配置预览默认隐藏密钥，保留旧版使用密钥入口和 Codex 高级选项。
- TypeSafe 使用独立的 System One 原生配置入口，禁止误生成 Claude 或 CCS 配置。
- 充值优惠与 USDT / OKPay 报价统一：先计算人民币优惠与手续费，再按订单锁定费率换汇；保留两位 USDT 应到账金额、兜底费率标记和报价历史。
- 保留邮件群发、工单、TG 社群绑定、成员管理，以及此前 OKPay 签名、返回地址和订单恢复修复。
验证覆盖配置读写、敏感字段隔离、客户端导入参数、模型与密钥切换、Shell 转义、支付优惠、少付拒绝、重复回调、恢复令牌及新旧迁移兼容；发布构建包含 Linux、macOS、Windows 五种平台压缩包和双架构 Linux 镜像。
Claude Desktop 目前仍需按页面说明在 CC Switch 内迁移供应商。本次未执行真实客户端导入或真实资金支付，不能将自动化回归等同于这些操作已经成功。
安装
docker pull ghcr.io/nieten/sub2api:0.2.13.1也可以在本页面下载与操作系统对应的压缩包。
Sub2API 0.2.11.9
AI API 网关平台 - 订阅配额分发管理
用户真实对照确认：322 字节的返回链接在发送或省略 status 时均创建失败，32 字节的短链接在两种情况下均创建成功。此次保留 status=0，缩短 OKPay 支付恢复凭据。
-
OKPay 新订单使用固定 102 字符的专属版本令牌，保留完整 HMAC-SHA256 签名以及订单、用户、实例和有效期校验。
-
不再在该令牌中重复存储返回地址和可由专属版本确定的字段；返回地址仍在签发前验证。
-
保留已配置的 HTTPS 目标、子路径、普通参数、订单编号、恢复失败兜底及旧令牌兼容；沿用原有密钥轮换机制。
-
补充本机 PHP 下单对照工具，默认不联网。显式启用后最多创建四笔未支付测试订单，不发起付款。
-
覆盖令牌长度、完整签名、防篡改、整数与过期边界、旧令牌、密钥轮换、跨域恢复和订单归属匹配。
-
支付服务商与日志脱敏测试、恢复服务及处理器回归测试通过；支付结果页和下单流程 46 项前端测试通过。
-
本机对照工具在 PHP 7.3.4、7.4.3 通过离线自检，旧只读认证工具回归通过。
固定长度指令牌本身。完整返回 URL 还取决于站点路径、查询参数和订单编号长度。此次对照没有确认 OKPay 的官方长度上限，也未单独排除查询内容影响；不能将 255 字节当作已确认限制。缩短后的正式链接及实际付款、回调和入账仍需在商户环境验证。
安装
docker pull ghcr.io/nieten/sub2api:0.2.11.9也可以在本页面下载与操作系统对应的压缩包。
Sub2API 0.2.11.8
AI API 网关平台 - 订阅配额分发管理
-
修复从 HTTP/IP 充值页面下单时，浏览器返回地址覆盖后台 HTTPS 同步跳转配置，导致 OKPay 本地校验失败的问题。
-
原生 OKPay 优先采用本次选中实例保存的返回地址，并在签发支付恢复令牌前确定最终地址；保留反代子路径及普通参数，重新生成当前订单参数和恢复令牌。
-
非空但无效的后台地址明确返回配置错误；未配置地址及其他支付方式继续沿用原有返回地址校验。
-
补充后台提示及排查文档，区分浏览器请求、服务层最终请求与实例配置。
-
模拟 OKPay 下单验证 HTTP/IP 页面、HTTPS 后台配置、反代子路径、恢复令牌一致性和无效配置拦截。
-
支付服务商、日志脱敏、支付恢复及相关服务与处理器回归测试；前端构建与后端嵌入资源构建。
-
本次未使用真实商户凭据创建订单；实际付款和入账仍需部署后验证。
安装
docker pull ghcr.io/nieten/sub2api:0.2.11.8也可以在本页面下载与操作系统对应的压缩包。
Sub2API 0.2.11.7
AI API 网关平台 - 订阅配额分发管理
修复上一版调试日志只覆盖网关请求、遗漏下单前本地校验的问题。「OKPay 返回或回调地址须为 HTTPS 地址」发生在签名与 HTTP 请求之前；本版会明确区分返回地址、回调地址及固定失败原因。
- 开启实例「调试日志」后，本地失败也生成一条「OKPay debug」日志，包含失败字段、中文说明、地址来源、协议与格式检查结果，以及 request_sent=false。
- 后台「运维监控 → 系统日志」可展开、复制新增诊断字段；日志保持脱敏，不输出完整 URL、查询值、恢复令牌、密钥或签名。
- OKPay 配置表单保存时分别检查异步通知和同步跳转基础地址，支持 HTTPS 子路径，拒绝 HTTP、相对地址、账号密码、损坏的转义和其他不合格输入。
- 下单返回地址优先使用充值页面传入的地址；回调通常使用实例配置。不会自动修改协议、放宽 HTTPS 校验、重复下单或修改支付签名。
使用方法：更新后，在实际下单的 OKPay 实例中临时开启调试，重新发起一次正常充值，在系统日志搜索「OKPay debug」，选择 warn 或全部级别，复制 operation=payLink 的详情。stage=validation 时重点查看 validation_field、validation_reason、validation_message 和两个地址的 source。
验证：支付模块和日志脱敏测试、返回地址拼接及 OKPay 查单回调回归通过；前端配置、日志详情、类型检查、静态检查及完整构建通过。已通过本地模拟上游验证 https://zzzai.pro/ 拼接的标准返回和回调地址；尚未读取服务器实际失败地址或完成真实付款验证。
安装
docker pull ghcr.io/nieten/sub2api:0.2.11.7也可以在本页面下载与操作系统对应的压缩包。
Sub2API 0.2.11.6
AI API 网关平台 - 订阅配额分发管理
OKPay 余额认证通过但下单返回业务代码 400 时，旧版提示无法显示未识别的上游原因。本版增加每个 OKPay 实例独立的「调试日志」开关，默认关闭，保存后下一次请求生效。
- 开启入口：系统设置 → 支付设置 → 管理服务商 → 编辑 OKPay → 调试日志 → 临时开启。
- 重新发起一次正常支付后，在运维监控 → 系统日志搜索「OKPay debug」，展开并复制「OKPay 调试详情」。桌面和手机均可使用。
- 详情包含请求 ID、实例、协议、HTTP 状态、业务代码、实际 USDT 金额、URL 长度及脱敏上游原因；不记录 Token、签名值、完整返回地址、余额或响应 data。
- 默认全局 info 级别即可使用。失败日志为 Warn，可在后台查看；成功日志为 Info，可在容器或文件日志查看。排查后关闭实例调试日志。
- 调试不会额外下单、自动重试或切换签名算法。现有 HMAC-SHA256、旧订单协议快照、两位 USDT 金额和入账校验继续沿用。
余额认证通过仅证明余额接口认证有效。本版本补齐诊断能力，实际业务 400 的原因仍需通过新日志确认，不能据此宣称真实付款已恢复。
验证：支付模块、日志脱敏、查单和回调相关测试通过；前端配置保存、桌面/手机日志详情、复制及文本安全测试通过；类型检查、静态检查及前后端构建通过。
安装
docker pull ghcr.io/nieten/sub2api:0.2.11.6也可以在本页面下载与操作系统对应的压缩包。