Skip to content

Sub2API 2.10.0

Choose a tag to compare

@github-actions github-actions released this 07 Oct 06:07
· 3817 commits to production since this release

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

本版完善 OpenAI 流式 WS 加速的发送前保护,让大请求和不兼容的搜索工具回到 HTTP/SSE;账号智商测试支持按模型选择思考强度。同时引入上游 v0.2.14 的管理员初始化与 EasyPay 安全修复,使用易支付的部署建议升级。

OpenAI 流式 WS 加速保护

  • 大请求与搜索工具自动回退:普通 OpenAI OAuth 的 HTTP 流式 Responses 请求启用 WS 加速时,发送前检查编码后的请求大小及上游托管搜索工具。超过默认 15 MiB,或包含 web_search、web_search_preview 等不兼容工具时,改走 HTTP/SSE;原生 WS 请求不受该阈值影响。
  • 创建账号时可配置加速:在新增 OpenAI OAuth 账号表单中补上“HTTP 流式 WS 加速”开关,默认关闭。加速仍受全局和账号 WS 设置约束,需关闭自动透传;已绑定的传输插件优先。#321
  • 限制回退时机:除上述本地发送前检查外,仅符合条件的握手失败可回退 HTTP。请求发送后不会因认证/权限错误、429、取消或上游中断而通过切换传输自动重放。
  • HTTP 回退沿用普通 HTTP 的工具 namespace 处理,并清理未使用的 WS 握手状态头。可通过 gateway.openai_ws.sse_acceleration_max_payload_bytes 调整发送前阈值,值必须为正数。

账号智商测试

  • 模型输入改为可搜索、可手动填写的下拉选择,优先加载账号对应的模型目录,减少手工填写模型名。
  • 思考强度(reasoning.effort)选项随所选模型变化;目录包含能力信息时,使用该模型支持的选项和默认值。新增账号级模型思考强度查询接口,复用账号模型目录缓存;未知模型不主动声明支持 reasoning。#323

协议兼容与凭证运营修复

  • 修复 Chat Completions 转 Responses 时嵌套 reasoning.effort 未转发的问题,并保留旧 messages 兼容入口中的原生 reasoning.summary。
  • 凭证运营定时任务会清理已软删除账号和历史孤立记录,覆盖暂停或尚未到下次探测时间的条目;仅依据数据库中的账号删除状态清理,不把探测失败或缺少登录配置视为删除。#318

上游安全修复与依赖更新

以下三项来自上游 v0.2.14,已整合至本 fork。整合 PR #324 · 上游版本

  • 管理员初始化:自动初始化全新实例时,留空的管理员邮箱和密码分别生成随机值;显式邮箱须符合登录校验,密码限制为 8–72 字节。已有管理员或已有用户的升级不会因旧初始化配置被阻断。
  • EasyPay 支付回调:拒绝非标准通知字段,并移除客户端 return_url 查询参数,修复订单创建签名可被重放为支付成功通知的问题。
  • Codex 远程模型发现:生成的 API Key 配置在远程模型目录模式下加入 api_key_model_discovery = true;本地文件目录模式保持原行为。

本 fork 将前端 xlsx 升级到官方 0.20.3 tarball,移除旧版 xlsx 安全例外;延续上一版的 Vue 3.5.43 与 source-map-js 安全覆盖。

升级说明

  • 无新增数据库 schema 迁移,已有管理员凭据保持不变。
  • 自动初始化的新安装如留空管理员凭据,从首次启动日志中的 Generated admin 获取生成的登录邮箱和密码并立即保存。
  • WS 加速默认关闭;已启用的账号沿用设置并应用新保护。15 MiB 是本服务的发送前阈值,不代表上游公布的容量上限。
  • 使用 EasyPay 的自定义接入需检查回调字段,以及对客户端 return_url 查询参数的依赖;非标准回调可能被拒绝,已付款订单仍沿用上游查单补偿路径。

完整版本差异


📥 Installation

Docker:

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

One-line install (Linux):

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

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

K3s gateway upgrade (on each existing single-node host):

curl -fsSL https://raw.githubusercontent.com/ranxi2001/sub2api/v2.10.0/deploy/upgrade-k3s.sh | sudo bash -s -- --version v2.10.0

Defaults: namespace tosky-canary, Deployment tosky-nerd; override with --namespace NAME --deployment NAME.
Upgrade every instance sharing Redis to this release.

📚 Documentation