ranxi2001/sub2api v2.17.3

Sub2API 2.17.3

on GitHub

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

• IP 审计（#566）：认证访问与拦截记录支持过滤后分页、跳页及每页条数调整；手动黑名单采用规则表格与单条新增/修改表单；风控配置区块可独立折叠，校验失败时展开定位。黑名单“应用到配置草稿”后仍需保存 IP 风控配置才生效。

• 余额与额度监控（#564）：批量读取并复用同轮账号数据，减少无变化配置写入与空队列操作；修复有效分组失败通知被错误取消重试的问题；取得配置锁后刷新配置及账号列表，避免旧快照覆盖并发修改。保留原扫描、告警、恢复、租约与重试边界。

• 质量模板冲突与归属对账（#565）：范围冲突返回明确 409，并展示草稿、已保存范围及冲突差异；管理员可显式预览和确认旧模型归属对账，使用版本及状态 fence 防止过期确认。不自动解除隔离，不改变账号/模型/分组限制。同标记但内容变化的项保留、未知布局阻塞、分组仅预览；仍有受管条目时保留范围约束，不代表任意模板均可立即切换。

• 前端回归（#561）：修复既有关键前端测试失败，完善与现有交互一致的断言及模拟环境。

• IP 风控事件 API 新增 page/page_size 参数及 total/page/page_size/pages 字段；不传分页参数时默认返回 20 条（原最多 200 条），建议前后端同时升级。查询仍限最近最多 2000 条未过期事件，不扩大保留范围。

• 本次无数据库迁移；不包含仍未合并的 #562/#563。

• 质量归属对账不是永久豁免或自动解禁；本版本不宣称解决 401 恢复问题。

• 发布范围：v2.17.2..e6368c4。正式 Release 与构建产物发布不代表生产部署；本次不执行部署。

📥 Installation

Docker:

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

One-line install (Linux):

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

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

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