ranxi2001/sub2api v2.18.1

Sub2API 2.18.1

on GitHub

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

新增与修复

• 新增独立 OpenAI 授权连接，支持连接级调度、用量归属与亲和性，并同步 BPS 用量快照及调度阈值（#591、#595）。
• 新增独立上游 URL 渠道实体、账号绑定与利润归属，完善渠道运维信息（#593）。
• 修复质量模型输入、状态探针及持续冷却所有权，强化冷却保护并更新安全依赖（#596）。
• 新增流式阶段计时，修复 SSE 上下文与取消处理，便于区分请求各阶段耗时（#599，替代 #597）。
• 新增优先级调度延迟分析、重算差异及 sticky 清理诊断（#598）。

升级与迁移风险

• 本版本包含 OpenAI 独立连接及上游渠道相关数据库迁移（312–319，含同号不同名迁移文件）；升级前备份数据库并在隔离环境验证旧数据、渠道绑定和连接归属。
• 数据库迁移不会随二进制回滚自动撤销；回滚前评估 schema 与新增数据兼容性，必要时使用已验证的备份恢复方案。
• 涉及共享 Redis 的实例应协调版本与调度状态，避免混用版本造成行为差异。

验证边界

• 冻结目标：eb68bc4fd38e6b91ba8a14cf1c66d5fc837141d9。合并后该精确提交的 CI、Security Scan、Request timing 及 multi-host 检查已通过；发布产物由远端 Release workflow 构建。
• 回归及 UI 证据包含合成/mock/隔离环境验证，不代表真实 OpenAI consent 流程或生产业务已验收；真实 consent 与生产场景尚未验证。
• 本次仅发布 Release 与产物，不启动服务、不执行生产部署。

📥 Installation

Docker:

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

One-line install (Linux):

curl -fsSL https://raw.githubusercontent.com/ranxi2001/sub2api/v2.18.1/deploy/install.sh | sudo bash -s -- install -v v2.18.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.18.1/deploy/upgrade-k3s.sh | sudo bash -s -- --version v2.18.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