Skip to content

Sub2API 2.9.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 28 Sep 09:37
· 2781 commits to production since this release
v2.9.0
030c1fd

AI API Gateway Platform - 将 AI 订阅配额分发和管理

本版新增质量规则自动启停 BPS、按分组运行鹈鹕测智和 OpenAI OAuth RPM 控制，并同步上游 v0.2.9 的协议兼容、计费与额度恢复修复。保留 fork 的 ticket、DeepSeek compaction/SSE、分组模型限制和独立更新源。

质量运维：按规则启停 BPS

质量规则可选择「开启 BPS」，按连续降智次数、5h/7d 用量阈值，或两者组合触发；支持配置适用模型和 BPS 参数。启用自动恢复后，可在连续恢复指定次数后关闭 BPS，也可在用量仍高于阈值时保持开启。#174

恢复时保留人工修改的保护逻辑，识别未显式填写的 false 选项和默认代理来源，避免等价配置阻止恢复；账号已有质量规则接管时，会阻止重复开启账号级自动 BPS，并引导到规则管理。

鹈鹕测智：按分组测试，记录实际作答账号

「智能运维 → 鹈鹕测智」集中管理展示设置、分组测试计划和测试记录。每份测试由对应分组的网关调度器选择账号，支持定时或立即运行；结果记录实际作答账号及此前失败的尝试，成功的 HTML/SVG 作品进入该分组的用户展示页。#176

  • 账号级定时测试继续保留，供管理员排查，但其新结果不再发布到用户展示页。
  • 展示页每个分组单独一行，最新作品在左侧，支持横向浏览。#171
  • 迁移后的计划默认暂停；详情与回滚说明见下方升级提示及鹈鹕测试文档。

账号与代理管理

  • OpenAI OAuth RPM 控制：可在账号设置中启用每分钟请求上限，调度考虑 RPM 余量，重试和后续 WebSocket turn 按实际发送计数，账号列表显示限流暂停状态。未配置上限时不启用该限制。#173
  • 2FA 导入与凭证守护衔接：登录成功后，按邮箱自动保存或更新密码和 2FA 密钥，供后续重登使用；不会自动开启巡检。凭据保存失败时不报告登录任务成功。#178
  • 上游余额查询：「上游声明」列可展示兼容上游 /v1/usage 返回的余额、额度窗口等信息，查询沿用账号已有的 API Key；不支持该接口的上游不会被当作余额为零。#169
  • Mihomo 节点检查：动态代理和节点页支持逐项、批量连接测试与质量检查，复用质量报告弹窗；检查使用独立单节点内核，不改写正在运行的轮换配置、节点状态或地区规则。#166
  • 账号运维和凭证守护页面使用可用窗口宽度，改善宽屏下的表格与配置区域展示。#177

同步上游 v0.2.9

本次按提交引入 Wei-Shaw/sub2api v0.2.9，并在 fork 中完成兼容适配与回归修复。#179

  • 模型白名单支持任意位置的 *；透传账号与普通映射账号共存时保留映射模型，并只补充该账号分组限制允许的默认模型，包括通配限制。
  • WebSocket 检测到客户端上下文窗口切换时删除旧 previous_response_id；检测使用元数据规范化前的帧窗口 ID，避免握手 header 覆盖导致断链失效，同时保留原有握手身份处理。
  • 保留 Anthropic 结构化输出 beta 和 OpenAI Responses 多智能体 beta；桥接尊重客户端禁用 thinking，修复空最终消息的流式文本恢复、工具初始参数保留和消息类型标记。
  • 补充 OpenCode Zen/Go 的 DeepSeek reasoning 占位兼容，同时延续 fork 按实际出站模型识别 DeepSeek 聚合网关的路径；修复 Antigravity PDF、工具 schema 和部分空流 failover 行为。
  • 修正 OpenRouter Claude Opus 5.5 别名、长上下文门控、目录图片价继承、独立视频倍率展示，以及 Free Fast 缺定价时的零成本用量记录。
  • 配额暂停保留到已知重置时间；自动额度恢复跳过已确认无额度的账号并对查询失败退避。客户端断开按 499 归因，避免误计为上游故障。
  • 修复 ccswitch 端点与重复 /v1 路径、Windows Codex 模型目录路径、空闲用量窗口倒计时和分组弹窗清理；Redis 容器启动改用 exec 参数列表。

升级提示

  • 本版新增迁移 253_pelican_group_tests.sql，创建分组测试计划及结果表。旧展示分组会转为已暂停的分组测试，模型取最近作品；没有作品时模型留空，需要管理员补齐后再启用。回滚到旧二进制后，需在系统设置重新选择展示分组。
  • 2FA 凭据保存行为发生变化：成功登录使用的密码和 2FA 密钥现在会持久保存到凭证守护配置，便于后续重登；守护巡检仍需按需开启。v2.8.20 的“仅用于本次登录、不保存到守护配置”说明不再适用于本版。
  • 新建质量规则选择「开启 BPS」时，表单默认勾选恢复后关闭；请结合模型范围、用量保持条件和现有 BPS 设置确认规则。未配置规则的账号不会自动启用 BPS。
  • Mihomo 节点检查结果保存在内存，重启后不保留。本版发布包可用于升级，线上实际版本仍以部署验收为准。

完整版本对比

📥 Installation

Docker:

# GitHub Container Registry
docker pull ghcr.io/ranxi2001/sub2api:2.9.0

One-line install (Linux):

curl -fsSL https://raw.githubusercontent.com/ranxi2001/sub2api/v2.9.0/deploy/install.sh | sudo bash -s -- install -v v2.9.0

Manual download:
Download the appropriate archive for your platform from the assets below.

📚 Documentation

Assets 8
Loading