ranxi2001/sub2api v2.13.1

Sub2API 2.13.1

on GitHub

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

本版新增 SIWC 套餐授权与账号协议切换、IP 风控面板，并修复 OpenAI 加密上下文恢复及 BPS 续轮工具错误处理。需要使用 SIWC 或治理认证入口访问的部署者，可在升级后按账号或规则逐步启用。

SIWC API 与已保存的 2FA 登录

• OpenAI OAuth 父账号的编辑页新增 Codex / SIWC API 选择。SIWC 使用独立授权令牌调用官方 api.openai.com/v1/responses，支持沿用现有 Responses、Chat Completions 和 Anthropic Messages 入口。原 Codex 与 Excel/BPS 凭据独立保留，切回 Codex 可恢复原路由配置。PR #485
• 授权可复用凭据守卫保存的密码与 TOTP/2FA；首次同意或额外验证仍可能需要浏览器，页面提供完整回调地址的绑定入口。后续保留客户端注册信息并自动刷新令牌，减少重复登录。绑定完成后仍须选择 SIWC 并保存账号，默认不会自动切换。
• SIWC 凭据加密独立保存，401 与刷新失败不会直接撤销主 Codex 凭据；影子账号继续使用原 Codex 路径。SIWC 当前采用 HTTP/SSE，不支持本实现中的 WebSocket、压缩、原生图片生成及部分 hosted tools；模型可用性与套餐用量仍由上游决定。使用与限制

IP 风控与认证访问记录

• 新增「系统设置 → 安全与认证 → IP 风控与访问记录」，支持 IPv4/IPv6/CIDR 黑白名单、国家允许/拒绝规则、认证入口 UA 规则、自动封禁，以及事件查看和解封清计数。PR #487
• 默认关闭；建议先在观察模式核对真实客户端 IP 与误报，再启用拦截。国家规则使用服务端 GeoJS 查询与缓存，启用后会向 GeoJS 发送公网客户端 IP；严格国家允许名单也会拒绝归属未知或查询超时的请求。
• 保留明确的支付、取图及内部 Worker 回调豁免，继续由各入口原有鉴权校验。IP_RISK_DISABLED=true 可在重启后应急关闭新模块，不会关闭原系统认证防护。配置、故障策略与恢复

请求恢复与期限控制

• OpenAI 流内的 invalid_encrypted_content 也记录失效密文来源；恢复时保留客户端压缩历史，并拒绝在多份候选密文之间猜测，减少上下文丢失和错误恢复。PR #481、PR #484
• BPS 在完整工具历史、未向客户端派发工具或可见内容等限定条件下，允许续轮未知工具进行一次修正；保留调用历史与用量，并区分本地桥接错误和上游拒绝。该机制不保证任意错误调用都能恢复。PR #483
• 新增 gateway.openai_upload_timeout_seconds 和 gateway.openai_pre_output_budget_seconds，默认均为 0（关闭）。启用后，同一请求的账号尝试共享截止时间，首输出之后的正常长 SSE 不受首输出预算限制；超时不因可能已执行的上传而自动补发。SIWC 同样保留这层 HTTP 保护，WS/BPS/Prism 等专属路径不由它统一设置。PR #486、配置说明
• 后台采票复用规范 Codex 客户端身份，保持 User-Agent、版本和 originator 的构造一致。PR #482

升级说明

• 使用 SIWC 需要持久凭据加密密钥，以及本版配套的托管登录 Worker；新增 292_openai_siwc.sql 迁移，旧账号默认保持原协议。回退前应切回 Codex 并排空 SIWC 授权任务，保留数据库与加密密钥备份；仅回退二进制不会撤销迁移。
• IP 风控与两个 HTTP 期限开关默认关闭。启用 IP 风控前核对可信代理配置；不要将代理/CDN 出口误当作最终客户端 IP。
• 本说明依据版本源码与 CI，不代表已完成真实 SIWC 登录、GeoJS 联调或生产部署，也不承诺性能、模型权限或额度提升。

完整差异 v2.13.0...v2.13.1

📥 Installation

Docker:

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

One-line install (Linux):

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