release-publish

管理面板

服务端在 /admin 提供一个网页管理面板,用来查看所有应用(包括已下架的),并对应用做下架 / 上架。同样的操作也可以通过 REST、JSON-RPC 和 relhub 命令行完成。

登录

打开 {服务器地址}/admin,输入管理员密码登录。密码只用于网页面板;API 和命令行仍然用管理员 token(Authorization: Bearer …)。

配置管理员密码

程序内置了一个默认管理员密码(源码里只有它的 PBKDF2 哈希,见 internal/adminauth),不做任何配置也能登录。要改密码,在服务端的环境变量里二选一(同时设置时明文优先):

变量 内容
RELHUB_ADMIN_PASSWORD_HASH 密码的哈希(推荐:配置文件里不出现明文;也可用 -admin-password-hash 参数)
RELHUB_ADMIN_PASSWORD 明文密码(启动时哈希;任何能读到配置文件或进程环境的人都能看到)

生成哈希:

relhub admin hash-password

按提示输入密码,把输出的哈希写进 RELHUB_ADMIN_PASSWORD_HASH,然后重启服务(容器部署改 deploy/env 后执行 deploy/container.sh up)。两个变量都没有配置时使用内置默认密码,启动日志会提示这一点。

登录后浏览器得到一个 12 小时有效的会话 cookie(HttpOnly、SameSite=Strict);服务重启或改密码后需要重新登录。同一客户端 15 分钟内输错 5 次密码会被暂时拒绝(429),直到时间窗口结束。

注意:

  • 不要把密码或哈希提交进仓库;deploy/env.example 里只放变量名和说明;
  • 选一个足够长的随机密码,面板应只在内网 / 反向代理后面开放;
  • 怀疑泄露时,生成新哈希替换旧值并重启即可。

下架与上架

下架(delist)意味着什么

下架是管理员对整个应用的开关(不区分平台和渠道)。下架后,对匿名调用者(不带 token 的请求,例如普通用户的浏览器和已安装的客户端):

  • 应用从公开列表(首页、GET /v1/apps、app.list)中消失;
  • 以下请求全部返回 403,错误码 app_delisted,消息形如 应用 "nightdesk" 已下架,请联系管理员上架:
    • 应用详情 GET /v1/apps/{app}(app.get)
    • 检查更新 GET /v1/apps/{app}/check(update.check)
    • 长轮询 GET /v1/apps/{app}/watch(update.wait)
    • 最新清单 GET /v1/apps/{app}/{platform}/latest(release.latest)
    • 版本列表与详情 GET …/releases、GET …/releases/{versionCode}(release.list、release.get)
    • 下载 GET …/releases/{code}/download 和 GET …/latest/download

对管理员 token 和这个应用自己的 token,一切照旧:仍然能看到应用、检查更新、下载,也仍然能发布、promote、改下限、撤回。所以下架不会打断 CI,你可以在下架状态下继续发布修复版,准备好了再上架。

下架不会删除任何数据:发行版本、渠道指针、统计、token 都保留。

已经安装的客户端会在下次检查更新时收到 app_delisted。客户端应当显示服务端给出的消息、不要循环重试,见 错误码。

上架(relist)

撤销下架,应用恢复到下架前的状态,匿名调用者又能看到和下载它。

怎么操作

网页:在 /admin 的应用列表里点对应应用的「下架」/「上架」按钮。

命令行(在服务器本机自动使用管理员 token;在其他机器上设置 RELHUB_URL 和管理员 RELHUB_TOKEN):

relhub app delist -id nightdesk
relhub app relist -id nightdesk

REST(需要管理员 token):

curl -fsS -X POST "$RELHUB_URL/v1/apps/nightdesk/delist" -H "Authorization: Bearer $ADMIN_TOKEN"
curl -fsS -X POST "$RELHUB_URL/v1/apps/nightdesk/relist" -H "Authorization: Bearer $ADMIN_TOKEN"

JSON-RPC(需要管理员 token):

curl -fsS "$RELHUB_URL/v1/rpc" -H "Authorization: Bearer $ADMIN_TOKEN" -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"app.delist","params":{"app":"nightdesk"}}'

上架把方法换成 app.relist。

应用 token 调用这些接口会得到 403 forbidden:下架和上架只有管理员能做。

下架、撤回、强制更新的区别

操作 作用范围 谁能做 效果
下架(delist) 整个应用 管理员 匿名调用者看不到、查不到更新、下载不了;数据全部保留,随时上架
撤回(yank) 某个平台的某个版本 管理员或应用 token 这个版本不能再被提供和下载;其他版本不受影响
强制更新(minVersionCode) 某个平台的某个渠道 管理员或应用 token 低于下限的客户端必须更新到渠道当前版本

想停止推送一个有问题的版本,用撤回 + promote 回旧版本(见 docs/USAGE.md 第 5 节);想让整个应用暂时对外不可见,才用下架。