ranxi2001/sub2api v2.17.5

Sub2API 2.17.5

on GitHub

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

修复池模式模型冷却级联

• 修复默认池模式的模型不存在错误绕过保护、写入本地 30 分钟负缓存的问题；管理员显式策略和非池模式的真实模型缺失保护继续保留。
• 历史未到期的模型拒绝记录仍约束调度，但不再被误判成分组配置不支持模型，避免返回 404 使下一层 Sub2API 再开始新的 30 分钟冷却。
• 临时容量错误跨网关层保留明确分类，真实模型 404 在响应提交前可尝试健康候选；保留配额、认证、安全拒绝及输出后的禁止重放边界。
• 包含两层 handler/转发回归、旧实现失败与修复实现通过的远端证据；不代表已验证生产恢复。不会自动清除已有冷却记录。

模型倍率支持按分组设置

• “模型计价”的每条规则增加适用分组多选；不勾选表示全部分组，旧规则维持全局行为。
• 按实际计费 API Key 的分组过滤规则，再按精确名称优先、最长前缀匹配，只应用一条倍率。只影响原有用户 token 附加收费，不改变模型基础价格、上游成本、按次或搜索费用。
• 保留旧客户端省略范围、分页加载失败及已失效分组 ID 的兼容与提示，避免意外扩大收费范围。
• 回退到不支持分组范围的旧版本前，应先停用受限倍率规则或明确调整策略；旧版本可能将其按全局规则处理。

新增用户流量记录与周期统计

• 用户和管理员可查看上传、下载、周期趋势与明细，支持日、周、月、年以及游标分页；仅统计，不改变 token 计费、余额或套餐。
• 使用有界后台队列、事件去重和批量入库；永久坏事件隔离后继续处理有效记录，暂时数据库故障保留重试。统计为尽力记录，异常退出、队列或存储预算耗尽时可能缺失，不能作为收费账本。
• 新增迁移 307、308，包括流量表和并发索引。升级需评估数据库资源及磁盘；回退二进制不会撤销表结构，应保留统计补偿目录。历史未采集流量无法补算。
• 统计不覆盖全部 WebSocket、Live/WebRTC 或外部媒体链路，应用层写入字节不等于客户端完整接收。

关联 PR：#569、#570、#567。
版本对比：v2.17.4...v2.17.5

本 Release 仅发布正式产物，不表示已部署生产。

📥 Installation

Docker:

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

One-line install (Linux):

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

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

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