ranxi2001/sub2api v2.9.8

Sub2API 2.9.8

on GitHub

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

本版将 Astra 网关借票加入公开版打票流程，并复用已有门票探针验收目标路由；同时补齐 Prism 专属模型选择、按上游域名配置地区出口，以及远程依赖的就绪检查超时配置。网关借票与地区出口默认关闭，升级后由管理员按需启用。

打票流程与网关借票

• 智能运维 → 打票流程新增独立的「网关借票」卡片，可分别选择来源与目标账号，配置来源代理亲和、节点轮换、失败冷却、WS 固定会话及可选调度接管。卡片默认折叠，借票功能默认关闭。#288
• 来源通过轻量请求获取路由 Cookie；目标使用自己的凭据，在借来的 Cookie 与同一出口上执行两轮短探针。两次请求完整成功，且续接没有返回新门票或返回原票时才可用；换票、缺票、请求或流失败、路由变化均不会标记为可用。此处复用 x-codex-turn-state 探针，不再以糖果测试作为借票验收。
• 保存启用后自动准备，手动复验会重新探测；路由过期后重新获取与验证，不因使用而延长有效期。Cookie 与探针门票只留在内存，管理接口及历史表不保存原值。单次探针结果不代表模型能力永久恢复。
• 请求采集和打票流程统一进入智能运维导航，原页面地址保持可用；旧 /admin/astra-gateway 入口转到打票流程。#286

Prism 模型范围与工具兼容

• 账号编辑页可单独勾选 Prism 模型：gpt-6.1-sol、gpt-5.6-sol、gpt-5.6-terra、gpt-6-luna。未选模型保留原生 / Excel 路由，全部取消表示不走 Prism；已开启 Prism 但没有范围字段的旧账号只默认这四个模型。#281
• 修复 Codex 可选推理参数导致普通文本被拒绝的问题。6.1 Sol 客户端工具桥在新版适配器中默认启用，可用 PRISM_ADAPTER_CLIENT_TOOLS_ENABLED=false 显式关闭；启动时检查工具验证依赖，不会生成上游未提供的加密推理。
• 修复适配器错误 JSON 后追加 SSE 的问题；已开始的流使用合法失败事件结束。Prism 的拒绝和限流不再影响原生账号自动并发升降档，适配器容量仍由独立配置控制。

上游连接与就绪检查

• 按上游域名选择地区出口：新增 gateway.upstream_routing，支持精确域名及后缀规则，覆盖共享 HTTP/HTTPS/SSE 客户端与 OpenAI 原生 WebSocket。账号专属代理优先；命中规则后的出口失败不会静默退回直连。功能默认关闭，代理地址由受限环境变量注入，配置变更需要重启。#287
• OpenAI API Key 出站身份统一：标准 OpenAI 协议路径默认使用与 OAuth 相同的 Codex 身份解析器，使 User-Agent、originator、version 保持一致并跟随当前版本设置。入站日志仍保留客户端真实 UA，供应商专用身份与管理员显式覆写保持优先级。#284
• 可配置 readiness 预算：新增 server.readiness_timeout_seconds / SERVER_READINESS_TIMEOUT_SECONDS，可为 PostgreSQL 和 Redis 的共享检查设置 1–60 秒预算；省略或 0 保持原来的 1 秒。使用 Kubernetes 时，readinessProbe.timeoutSeconds 需大于应用预算。#282

升级说明

• 新增 244_astra_gateway_history.sql、249_astra_scheduling_states.sql 两个迁移，用于借票历史与调度接管状态，保留原私有版本迁移文件名和内容。借票调度若已改变账号、模型或分组状态，回退旧二进制前应先恢复相关状态；关闭接管本身不会恢复这些变更。
• 托管 Mihomo 增加 Astra 独立回环监听 17925–17932。借票共享网关路由，不复制来源凭据或门票，也不替代普通打票范围和门票策略。启用后的来源获取及目标探针会消耗请求额度。
• Prism 修复需要同时更新 Go 网关与本 tag 的 prism-adapter/，安装其固定版本依赖并保留已有会话、pending 和工具状态。仅替换主程序不会升级外部适配器；回退旧网关前应关闭账号 Prism 总开关，避免恢复旧版全模型接管行为。
• 地区出口规则不覆盖 Codex 采票、BPS 专用 HTTP profile、Prism 浏览器及其他独立客户端；它也不减少入口总带宽。现有 gateway.disable_codex_identity_enforcement=true 可恢复 API Key 原有身份透传行为。readiness 预算不能替代对持续数据库、Redis 或调度缓存故障的排查。

完整版本对比 · 网关借票说明 · 地区出口配置 · Prism 升级说明

📥 Installation

Docker:

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

One-line install (Linux):

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

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

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