github ranxi2001/sub2api v2.7.8
Sub2API 2.7.8

latest releases: v2.19.5, v2.19.4, v2.19.3...
one month ago

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

本版改进 Codex 打票管理,支持在网页调整自动采票参数和发起单账号手动采票;同时补充 OpenAI 建连失败恢复、代理回退和 DeepSeek 中转适配。

社区交流群

欢迎加入 QQ 群「中转技术交流」(群号 1004036018),交流部署实践、协议兼容、出口代理和功能改进。也欢迎参与问题复现、测试、文档补充和 Pull Request,一起维护这个独立分支。

二维码长期有效。需要长期留档、报告问题或讨论具体改动时,请使用 Issues。

打票管理

  • 自动采票的巡检周期、每轮探测上限、失败冷却、单次超时和提前刷新阈值可在页面保存并回读,无需修改配置文件后重启。默认值依次为 180 秒、6 次、180 秒、25 秒和 600 秒。
  • 采票设置变更、OpenAI 账号恢复调度或清除错误后,通知当前进程的后台循环重新检查。重复通知合并处理,其他实例仍按原周期轮询。
  • 增加单账号手动采票入口、进度与错误详情;限制为支持 Codex 票据的非影子 OpenAI OAuth/setup-token 账号,并限制手动请求的参数范围。
  • 流程日志、当前出口和节点列表显示订阅中的名称,例如“日本 东京 01”;修正停止后重启的任务状态覆盖。持久化失败会明确提示,只有写库成功才计入已入库数量或触发“出票即停”。节点轮换遵循采票代理配置。
  • 使用静态住宅或其他外部采票代理时,流程页不再误报“Sidecar 不可达”;外部出口不查询本地控制器,也不借用旧 Mihomo 节点标注探测结果。选择 Mihomo 时仍显示其实际健康状态。
  • 账号列表补充限流、过载、临时不可调度和到期状态;多个时间窗口并存时显示最晚结束时间。该展示不能替代按模型、分组及票据策略执行的完整调度判定。

请求转发

  • OpenAI 业务请求经代理访问 HTTPS 时,仅在确认 TLS 握手失败且 HTTP 尚未发出的情况下,在同一出口额外重试一次;保留证书校验,采票专用传输不采用该重试。
  • 符合条件的持久建连故障可使用已配置的备用代理或直连。每一跳单独确认请求尚未发送,共用最多四条备用记录的预算,健康和隔离状态归因到实际出口。
  • DeepSeek 模型映射到兼容中转服务时也能识别其协议语义,使用对应的 Responses Lite/chat 适配路径,并修正远程压缩的账号能力筛选。使用前需要正确配置模型映射。

发布流程

安装包编译拆为独立平台矩阵,随后集中组装发布产物;提供仅 Linux amd64 的 simple 模式。

升级提示

  • 现有非 none 的代理“到期回退”配置,在本版也会授权符合条件的运行时故障回退;升级前请核对各代理的备用出口及直连策略。直连使用 Sub2API 所在运行环境的网络。
  • 不重放已经发送的 HTTP 请求或已经开始输出的流;原生 WebSocket 不因此获得运行时回退能力。所有授权出口失败时仍执行既有失败处理。
  • 票据形态校验不保证模型质量,也不保证获得票据或绕过上游限流。独立采票出口与账号业务代理保持各自用途。
  • 本版范围未新增数据库迁移。Windows 原生拒连分类有已知兼容限制;Linux 验证不能视为 Windows 原生运行验收。
  • 升级前已导入的节点只保存了内部 ID,需在 Mihomo 设置中重新“保存并应用”已有订阅才能补回名称,无需重新输入订阅地址。内部 ID 保持稳定,名称不用于判定真实出口国家,地区过滤仍依据出口 IP 检测结果。

感谢 blackdm666 的 PR #12、PR #13、PR #14,以及 spake404 的 PR #15。TLS 重试与代理回退分别适配自上游 Wei-Shaw#7428、Wei-Shaw#7430,后者保留 Wei-Shaw#4362 的来源致谢。

节点名称展示和手动采票收尾修复见 PR #17,发布矩阵改造见 PR #11。

完整版本对比


📥 Installation

Docker:

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

One-line install (Linux):

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

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

📚 Documentation

Don't miss a new sub2api release

NewReleases is sending notifications on new releases.