Repository navigation
Sub2API 0.2.18
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 价卡计费
构建与安全
- Docker 构建镜像对齐 Go 1.27.3,CI 版本校验同步
dompurify升级至 3.4.17,修复 GHSA-cg2g-xh64-v4q7(critical)与 GHSA-mrv2-3pqr-j5jr(high)
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 --noEmit0 错误、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