Repository navigation
Sub2API 0.1.202
AI API Gateway Platform - 将 AI 订阅配额分发和管理
同步 上游 Sub2API v0.2.14 中适用于本分支的安全修复,沿用本仓库的独立版本序列。
Bug 修复
- 修复全新安装使用固定管理员邮箱的问题:未指定
ADMIN_EMAIL时生成随机登录邮箱,自动生成的凭据在首次启动日志中显示。一键部署脚本同步生成随机邮箱并保存到.env。 - 统一自动安装、CLI 和 Web 安装的管理员凭据校验:邮箱必须能通过登录接口校验,显式密码必须为 8-72 字节,符合 bcrypt 的输入上限。
- 修复 EasyPay 下单签名被重放为支付成功回调的问题:清除客户端
return_url查询参数,回调验签拒绝非标准通知字段;保留服务端生成的订单和支付恢复参数。 - 同步 Compose 模板、部署示例及中英日文安装说明,补充管理员初始化和 EasyPay 回调的回归测试。
兼容性说明
- 已有管理员或已有用户的数据库会跳过首次管理员创建及凭据校验,升级不会因为旧环境变量中的凭据而阻断启动。
- 全新自动安装若显式提供不合法的邮箱或长度不合要求的密码,将直接报错;未指定邮箱时,请从首次启动日志或一键部署生成的
.env获取登录邮箱。 - 本分支 Codex 配置使用本地
model_catalog_json,没有上游远程模型目录的受影响路径;现有 Codex 配置测试全部通过。 - 上游依赖修复要求的 Vue/server-renderer 3.5.42 和 source-map-js 1.2.2 下限,本分支已满足。
验证
- 后端单元测试、集成测试、golangci-lint,以及带嵌入前端的发布构建。
govulncheck未发现应用可调用路径中的已知漏洞。- 前端 ESLint、TypeScript 检查、239 个文件中的 1684 项测试及生产构建。
- Codex 模型目录导出的 16 项 Python 测试,以及部署脚本语法、Compose 安全、资源限制、镜像地址、GitHub Token 和 Caddy 缓存测试。
- GitHub CI 六个任务全部通过,包含 macOS 部署生命周期测试;安全扫描 通过。
已知依赖例外
xlsx 的两项既有高危公告继续按仓库规则记录临时例外,有效期至 2027-01-06。当前功能仅用于管理员导出,不提供工作簿导入或解析路径;此项为例外续期,不表示底层依赖漏洞已经修复。
安装
Docker Hub(amd64 / arm64):
docker pull forever94yu/sub2api:0.1.202Linux 一键安装:
curl -sSL https://raw.githubusercontent.com/forever94yu/sub2api/main/deploy/install.sh | sudo bash手动下载: 从下方附件选择对应平台的安装包,使用 checksums.txt 核对 SHA-256。