云端更新中心

一、客户端接入（Auth Pro 服务器）

在 auth_pro 服务器上配置以下环境变量，重启服务即可自动接入本更新中心：

AUTO_PRO_UPDATE_URL=https://你的域名/latest.json

• 客户端启动时请求 /latest.json，获取最新版本清单。
• 客户端校验 os / arch 是否匹配，再校验包内 sha256 与 size。
• 校验通过后下载更新包并解压，校验 manifest.json 包结构，最后执行更新动作（更新前端 / 后端 / 重启 / 备份数据库）。
• 更新失败时自动回滚，不影响当前运行版本。

二、更新清单格式（latest.json）

{
  "version": "1.2.3",
  "channel": "stable",
  "minVersion": "1.0.0",
  "force": false,
  "releasedAt": "2026-08-13T10:00:00+00:00",
  "releasesUrl": "https://你的域名/releases.json",
  "package": {
    "os": "linux",
    "arch": "amd64",
    "fileName": "auth_pro-full-v1.2.3.tar.gz",
    "url": "https://你的域名/packages/auth_pro-full-v1.2.3.tar.gz",
    "sha256": "64位十六进制哈希",
    "size": 12345678,
    "signature": ""
  },
  "actions": {
    "updateFrontend": true,
    "updateBackend": true,
    "restartBackend": true,
    "backupDatabase": true
  },
  "notes": ["修复了 XX 问题", "新增 XX 功能"]
}

字段含义与校验规则：

• version：版本号，比较时提取所有数字段逐段比较（与 auth_pro 一致）。
• minVersion：最低可升级版本，低于该版本时强制下载完整包。
• package.sha256：必须为 64 位十六进制字符串，否则校验失败。
• package.size：更新包字节数，下载完成后比对，不一致则放弃。

三、公开接口

接口	方法	说明
/latest.json	GET	最新版本清单（客户端主入口）
/releases.json	GET	全部已发布版本历史
/packages/{文件名}	GET	下载更新包
/api/ping	GET	健康检查

四、管理接口（需 Bearer Token）

接口	方法	说明
/api/login	POST	登录，返回 token
/api/me	GET	当前管理员信息
/api/change-password	POST	修改密码
/api/config	GET/PUT	站点配置（如 publicBaseUrl）
/api/upload	POST	上传并发布新版本
/api/versions	GET	版本列表
/api/versions/{v}	PUT/DELETE	编辑 / 删除版本

五、默认账号与安全

• 默认账号：白墨渊 / 12345678qQ!，首次登录后请立即修改密码。
• 上传大小上限：512MB（与 auth_pro 客户端一致）。
• 管理接口均需 Authorization: Bearer {token}，token 默认 7 天有效。