ranxi2001/sub2api v2.9.5 on GitHub

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

本版面向 OpenAI 文本请求优化账号选路：在满足模型、分组、协议和会话约束的前提下优先利用空闲容量，减少账号绑定多个分组造成的竞争与排队。同步补充 Kubernetes/K3s 多副本运行、Pelican 测试成本记录，以及多项 BPS、取消和网络边界修复。

优先调度与 OAuth 账号

优先调度总开关仍默认关闭；开启后先区分已知质量、错误和亏损风险，再按实时并发和预计占用分档，容量相近时结合体验、账号优先级与评分分流。同一风险档内更空闲的候选优先，保留后备候选和有界等待。
OAuth 账号的分流权重会考虑可用槽位、额度余量、延迟和绑定分组数量。绑定分组较少且有空闲容量的账号可承接更多请求，避免流量长期集中在少数账号。
兼容的 BPS 与原生账号默认允许在同一优先池均衡选择，仍按账号自身协议发送，不会自动启用 BPS；关闭 balance_protocols 后可恢复 BPS 优先、原生兜底。
OpenAI OAuth 支持将模型映射作为别名并保留默认模型范围。新账号的自动配置可使用别名模式；已有显式映射仍按旧白名单语义，升级后请按账号实际范围检查并有意开启别名模式，不会自动扩展存量账号权限。
多实例部署先升级所有网关及发布账号缓存的管理实例，再修改存量账号的别名模式；回退旧二进制后，非空映射会重新按白名单解释。
优先调度继续受模型权限、分组限制、订阅优先级、compact 能力、利润门槛、冷却和最终并发抢槽约束。调度本身无需数据库迁移。

Kubernetes/K3s 支持 gateway/full 角色、就绪探针、启动时保留其他副本的有效并发槽位和等待计数，以及可配置的优雅排空。默认 full 角色和关闭预算保持兼容。
提供 StatefulSet、PVC、Secret、资源预算、PDB、探针和升级/回退示例。接入第二个实例前先升级主实例；回退旧二进制前先排空请求副本。
仍需保留一个 full 主实例，后台任务没有实现全面多主选举；BPS 本地状态、WS 续接、本机代理及文件任务需要单独验证路由，详见多副本部署说明。
Pelican 分组测试记录按上游用量保存美元成本快照，并按分组和服务器日期累计；未知或部分计价保持明确标记，不补造历史费用，不扣用户余额。

修复 OAuth IP 401 连续失败判定、Claude 下游取消时的上游取消和已完成用量保留，以及 BPS 图片大小、附件、消息 ID、代理诊断和工具示例问题。
本版包含数据库迁移 261，用于 Pelican 分组测试成本字段和每日累计表；旧记录保持未记录，累计从升级后开始；回退旧二进制可保留新增列和表，但旧版本期间的测试不会自动补记。
版本发布包含代码和构建产物，不代表已经部署到生产服务。生产部署前请核对配置、迁移和多副本升级顺序。

Docker:

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

One-line install (Linux):

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

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