Skip to content

Sub2API 0.2.18

Choose a tag to compare

@github-actions github-actions released this 23 Oct 14:35
435b5cf

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

Important

本版本为 0.2.18:在完整保留 Fork 自有功能的前提下追平上游 Wei-Shaw/sub2api 的 main
(v0.2.18,账号配额维度化 + 调度快照常驻内存 + 兼容流收尾对齐),版本号沿用上游编号 0.2.18。
latest 与 0.2.18 均指向本版本。

0.2.18 大于此前的 0.2.17 / 0.2.16 / 0.2.15,应用内「检查更新」可正常提示升级。

Note

本次为 0.2.18(2026-10-23):在 0.2.17 的基础上,合并上游 main 的 45 个提交
(b0a02a330 → 5c185c5c5)。发布产物为 Docker 镜像(GHCR + Docker Hub 双 registry),
Release 零附件。

移植来源

  • 来源一:上游 Wei-Shaw/sub2api 分支 main
    • 来源提交:5c185c5c5(v0.2.18,2026-10-23);上次移植基准 b0a02a330(v0.2.17)
    • 本次增量:45 个提交(含合并提交),114 个文件(+7482 / −566)
  • 新增迁移:246_enable_gemini_image_generation_groups.sql
  • 版本号:backend/cmd/server/VERSION 为 0.2.18

上游增量(v0.2.18)

账号与调度

  • Vertex 账号支持配额上限,与 API Key / 服务账号配额口径统一
  • 账号配额累加按已设置的周期维度选择语句(日/周/月维度不再写多份)
  • 调度快照解码结果常驻进程内存:只有在 ready、active 版本、全局修订号与平台修订号都与 Redis
    一致且未超最长复用时长时才复用;last_used 每次仍从 Redis 读取
  • 解码结果靠 EXISTS 校验元数据未删除,删除/撤销会使温缓存立即失效
  • 单 antigravity 账号的分组判定改为按需求值
  • 模型映射签名改为与遍历顺序无关、零分配
  • 模型限流快照写入改为写时复制,避免候选对象被跨 bucket 污染
  • 账号列表的平台与状态筛选可持久化

网关与协议

  • Anthropic 账号 chat/responses 兼容流式:客户端断开后读完上游再计费(不再漏计)
  • 兼容流上游未正常结束时按错误收尾,并与原生 SSE 收尾对齐
  • Codex overload:合并身份判定与空流安全重试修复,排队事件与 metadata 事件之后仍保留重试
  • 工具参数常量与注解归一化
  • Cloudflare 1010 拦截不再惩罚账号(按边缘拦截处理)

Gemini / 生图

  • 分组「允许当前分组生图」开关对 Gemini 系入口生效(含迁移 246)
  • Gemini prompt 被拦截、只报缓存命中时 input_tokens 不再为负
  • Gemini 流式中途客户端断开时按已收集用量计费
  • DeepSeek 图片输入避免重复载荷(按账号凭据选定单一 URL 字段)
  • 异步生图转存的图片下载与同步回填策略对齐

计费

  • Grok 4.7 Fast 按官方 Fast 价卡计费

构建与安全

Fork 侧保留与合并处理

本次上游合并冲突面很小(3 个文件),无逻辑冲突:

文件 处理
backend/cmd/server/VERSION 取上游 0.2.18(Fork 沿用上游编号)
frontend/package.json 并集:保留 Fork 的 nanoid 版本钉死,dompurify 取上游 3.4.17
frontend/pnpm-lock.yaml 同步上述 overrides,并去掉重复的 follow-redirects 键

Fork 自有实现(ProxyLane / ExcelBPS / PrismBrowser / DeepSeek 原生压缩 / GroupRoutes /
cyber 严格身份 / webSearchCalls 保护)全部保留,本次均未与上游改动区域重叠。

验证

  • 本地校验(Linux,Go 1.27.3 / Node 22):
    • 后端:go build ./...、go vet ./...、gofmt -l 全部通过;go test -tags=unit ./... 全绿
    • 前端:vue-tsc --noEmit 0 错误、eslint . 0 problem、25 个关键 vitest 用例全通过
  • 工作树检查:无残留冲突标记

升级说明

  • 升级方式:管理后台左上角「检查更新」一键升级;或
    curl -sSL https://raw.githubusercontent.com/ziyue67/sub2api/v0.2.18/deploy/install.sh | sudo bash -s -- upgrade
  • 回滚方式:install.sh rollback <version>
  • Docker:docker pull ghcr.io/ziyue67/sub2api:0.2.18
  • 镜像只提供 linux/amd64 单架构,标签 0.2.18 / 0.2.18-amd64 / latest
  • 数据库迁移:本版本新增 246_enable_gemini_image_generation_groups.sql;升级前请备份数据库
  • 安装脚本与在线更新服务的默认仓库为 ziyue67/sub2api

Fork 自有功能

  • Codex 292 门票(x-codex-turn-state)打票与注入、上游剩余额度探测、账号代理车道
  • 管理员请求采集、凭证守护、账号质量运维、Excel / BPS 协议
  • Mihomo 托管 / 动态代理区域、Pelican 定时演练、图片创作 / 画布 / Studio Bridge
  • 邮件广播、模型广场、Claude 重置额度查询、网站工单、账号运维告警、受控渠道实验
  • 发布流水线:双 registry 推送;latest 只由 Release 写;二进制归档停发

Docker 镜像(ziyue67/sub2api)

ziyue67/sub2api:latest
ziyue67/sub2api:0.2.18
ghcr.io/ziyue67/sub2api:latest
ghcr.io/ziyue67/sub2api:0.2.18

拉取示例:

docker pull ziyue67/sub2api:0.2.18
docker pull ghcr.io/ziyue67/sub2api:0.2.18

文档