管理面板
服务端在 /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 节);想让整个应用暂时对外不可见,才用下架。