ranxi2001/sub2api v2.21.1

Sub2API 2.21.1

on GitHub

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

本版新增「409 省略加密内容（Beta）」，为原账号不可用或路线变化导致的旧会话拒绝提供可选恢复路径。同时更新 API Key 上下文限制与来源风控、支付通道手续费，并修复 BPS 和账号运营中的兼容问题。

加密历史恢复

• 系统设置 → 网关设置 → 网关转发行为新增「409 省略加密内容（Beta）」，默认关闭。HTTP Responses 在首次选号阶段因原加密历史账号不可用或路线变化而拒绝时，可省略旧密文并重新选择合格账号；保留可读文本和工具调用关系，支持 JSON/SSE。#820
• 省略是有损恢复：模型无法读取被省略的上下文，不保证任务完整或上游接受。当前加密任务、服务端会话指针、压缩状态、WebSocket、交付未确认及存储故障不适用；不会把任意供应商 409 当作重试信号，也不会重放已发送的请求。详见Beta 使用说明。
• 另提供独立的部署配置 gateway.disable_encrypted_agent_owner_binding，默认 false。显式开启可让已完成交付的完整加密历史尝试其他合格账号，保留原密文和交付保护；上游是否接受由供应商决定。共享 Redis 的节点需统一配置、排空旧连接；它与上述历史省略开关用途不同。策略与切换说明，#807

Key、风控与支付

• 管理员可为单个 API Key 设置输入上下文 Token 上限。正整数优先于原长上下文开关及模型价卡阈值，留空或 0 沿用原策略；上游模型窗口仍有效。HTTP、SSE 和 WebSocket 使用标准上下文超限响应，避免泄露内部配置值。#808
• Key 风控改为关注单 Key 跨 IP，避免团队共享出口误报。默认 30 分钟内出现 2 个不同 IP 时记录风险；管理员核实并确认后可限制该 Key 的 IP/CIDR 来源，不自动猜测可信地址或封禁。自动风险邮件仍默认关闭。#811
• 支付手续费支持「支付方式 → 服务商 → 全局」逐级覆盖；显式 0 表示免手续费，未设置继续继承。报价与订单保存的费率保持一致，支持 Stripe 支付子类型。#813

兼容性与运营修复

• BPS 从本次实际 bearer 提取授权用户头，执行现有 Fast 策略并保留请求层级；缺省不会自动升级，未知层级明确拒绝。模型/推理强度与工具续轮保持一致，上游终态声明如实返回。此修复不代表真实账号质量或跨账号加密兼容已验证。#819
• Cyber program 对特定模型的授权拒绝不再触发整个账号的冷却或禁用计数；其他鉴权错误沿用原处理。#815
• 质量分组规则仅选「正常」时，自动定时检测跳过已知 5h/7d 额度耗尽账号；恢复后可再次参与。缺失或无效观测不推定耗尽，手动测试和其他明确状态选择保留原行为。#818
• 账号性能列新增按请求等权计算的平均缓存命中率；无样本与零命中分别展示。批量质量模板可在预览表选择字段，保存禁用原因更清楚；VIP 收款确认显示在所选账单旁；账号菜单可查看并复制站内用户 ID。#803、#814、#816、#810
• 鹈鹕定时测试阻止旧调度快照领取下一轮任务，保存实际发送提示词；补充手动测试隔离 E2E。支付 SDK 改为独立延迟加载，普通账号页不再因此请求外部支付脚本。千问平台标签同步修正。#804、#809、#806

升级说明

• 相对 v2.21.0 新增 API Key 上下文上限、单 Key 来源风控和支付通道费率迁移。升级前备份数据库；风控迁移会处理旧共享出口待处理事件、调整旧默认阈值及相关待发送队列，二进制回滚不会撤销这些数据变化。已有支付通道默认继续继承全局费率。
• 新增恢复开关默认关闭，发布和升级不会自动启用。生产部署、真实供应商恢复和真实支付需按各自流程验收；CI 通过不代表线上已部署。

完整变更

📥 Installation

Docker:

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

One-line install (Linux):

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

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.21.1/deploy/upgrade-k3s.sh | sudo bash -s -- --version v2.21.1

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

📚 Documentation

• GitHub Repository
• Installation Guide