控制台手册

注册完成之后,日常要做的每一件事。这一页按真实界面写:提到的每个按钮名都能在控制台里找到,没有的我们会明说。

(下文里的 Agent 指装在你内网那台机器上的小程序;TRK 指你浏览器里那把授权钥匙。)

文档 / 控制台手册适用:公测版最后更新:2026-10-08

一、界面导览:六个入口与两种角色

登录后左侧(窄屏在抽屉菜单里)有六个入口:

入口谁可见放什么
仪表盘所有人组织当前状态:Agent 是否在线、设备分布、接入模式。
设备仅管理员全部设备的批准 / 吊销 / 取配置。
成员仅管理员邀请成员、禁用与启用。
密钥与信任仅管理员授权钥匙(TRK)的状态、轮换、找回;已注册的 Agent。
审计日志所有人组织里每个敏感动作的记录。
组织设置仅管理员组织名称、冻结 / 解冻等。

右上角显示你的身份(管理员 / 成员)。「我的设备」在页面左下角入口进入,是成员自己提交设备申请、取配置的地方——不需要打扰管理员,除了批准那一步。

二、设备:批准、吊销、取配置

批准一台新设备

  1. 「设备」页 →「添加设备」→ 填设备名、选系统、点「生成密钥」→ 点「提交申请」。新设备出现在列表里,状态「待批准」。
  2. 点该设备行内的「批准」,弹窗里把展示的指纹与设备注册页的「本机指纹」逐段核对,勾选「我已与设备注册页展示的「本机指纹」核对一致」后,「批准并签名」才会可点。
  3. 点「批准并签名」。浏览器用本机 TRK 私钥签发一条授权指令;Agent 在线时立即下发并生效,Agent 离线时指令入队、等它重连后自动生效(提示会写明这一点)。
批准时提示「签名验证失败」,说明当前浏览器的 TRK 和组织登记的公钥不是同一把——最常见于换浏览器或清除过站点数据。恢复办法见下面密钥与信任一节的「登记本机 TRK」。

取配置(二维码)

设备行内点「获取配置」,弹窗里是完整的 WireGuard 配置二维码与配置文本。用官方 WireGuard 客户端扫码导入,或复制文本发送过去。两点要知道:

  • 配置在你的浏览器本地拼装,私钥从本浏览器 IndexedDB 读出填入,不经过服务器。
  • 换了一台浏览器再点「获取配置」,弹窗会如实告诉你拿不到私钥(PrivateKey 一栏是占位符)——请在当初登记这台设备的那台浏览器上取,或重新登记一台设备。

吊销

设备行内点「吊销」并确认。吊销同样需要浏览器 TRK 签名。Agent 在下一次状态同步(默认 30 秒)内应用变更并断开该设备。

三、成员:邀请与禁用

  • 邀请成员:「成员」页 →「邀请成员」→ 填姓名与邮箱。邀请邮件发出后,对方从邮件里的链接进控制台。邮件没发出去时界面会提示你「复制链接」手工送达——邀请链接本身就是兜底方式。
  • 禁用 / 启用:成员列表里对单个成员操作。禁用后对方立即无法登录、无法刷新会话;其已批准设备也会随 Agent 状态同步断开。
  • 成员只有「仪表盘 / 审计日志 / 我的设备」三个入口,看不到管理页面。

四、我的设备(成员视角)

「我的设备」是成员自助页面,不需要管理员身份:

  • 添加设备:和设备页一样的流程——填名、选系统、「生成密钥」、「提交申请」。提交后等管理员批准;可以点「复制指纹」把指纹发给管理员核对。
  • 获取配置:批准后点「获取配置」拿二维码。私钥就在你自己这台设备的浏览器里,所以这里取到的配置永远是完整的。
  • 吊销:成员侧的吊销申请也需要管理员侧的 TRK 签名才能执行——界面上会提示你找管理员处理,这不是功能没做完。

五、密钥与信任:授权钥匙的保管、轮换与找回

授权钥匙(TRK)是组织里签发一切授权的根:批准、吊销、下发清单、冻结、解冻,全都要它签名。它只存在你的浏览器里,我们这边只有公钥——所以我们帮你找不回,也替你签不了任何一条授权。

三条必须知道的事

  • 它不可导出、不可备份。它是随机生成的密钥,不是助记词派生的,界面上没有也不该有「导出助记词」按钮。
  • 清除浏览器数据 = 钥匙消失。之后批准会报「签名验证失败」,需要走下面的找回流程。
  • 请固定在一台电脑的一个浏览器上做批准。这台浏览器就是你的「授权终端」。

轮换

「密钥与信任」页 →「轮换密钥」:浏览器生成新的钥匙对,并把新的公钥登记到组织(旧的作废)。已批准的设备不受影响——它们认的是设备自己的 WireGuard 密钥,不是你浏览器里这把授权钥匙。

找回:登记本机 TRK

换了浏览器、清了数据、或批准一直报「签名验证失败」时:「密钥与信任」页 →「登记本机 TRK」→ 确认。它把当前这台浏览器里 TRK 的公钥登记为组织的签名公钥(旧的被轮换),之后批准即可正常签名。注意:新浏览器里没有 TRK 时先点「生成 TRK」再登记。

这是信任根的转移,请慎重。登记后,旧浏览器里的 TRK 立即作废。如果你怀疑旧浏览器被不相关的人用过,更应该轮换而不是找回。

已注册的 Agent

同页下方展示已注册的 Agent(设备 UID 与版本)。Agent 用自己的证书维持与我们服务器的连接,轮换授权钥匙不影响已注册的 Agent。

六、审计日志

「审计日志」页记录组织里每个敏感动作:设备登记、批准、吊销、清单下发、成员增删、冻结解冻、签名密钥变更等。每条包含时间、动作、结果与操作者;被拒绝的操作也会留痕(比如签名验证失败会记录失败原因)。

  • 支持按时间翻页;右上角「导出 CSV」可下载全部记录留存。
  • 普通成员也能查看审计日志——组织里发生过什么,对所有人透明。
  • 加载失败时点「重试」;日志不会因为刷新丢失。

七、组织设置:改名与冻结

基本信息

修改组织名称后点「保存更改」,左下角的组织名会立即更新。

冻结与解冻

  • 冻结:设定时长(小时)后确认。冻结指令由浏览器 TRK 签名下发,Agent 在 ≤30 秒内应用——之后所有设备无法建立新连接,到时自动解除,或由管理员手动解冻。适用于「怀疑有设备失窃」这类紧急场景。
  • 解冻:同样需要签名下发,Agent 在 ≤30 秒内应用。
冻结与解冻都要 TRK 签名。浏览器里没有 TRK(或没有登记)时操作会被拦下并给出指路提示——先去「密钥与信任」处理。

到这里,控制台的日常操作就齐了。首次接入还没走完的,回快速开始;遇到具体报错,查常见问题。

← 安装 Agent 核心概念 →