控制台手册
注册完成之后,日常要做的每一件事。这一页按真实界面写:提到的每个按钮名都能在控制台里找到,没有的我们会明说。
(下文里的 Agent 指装在你内网那台机器上的小程序;TRK 指你浏览器里那把授权钥匙。)
一、界面导览:六个入口与两种角色
登录后左侧(窄屏在抽屉菜单里)有六个入口:
| 入口 | 谁可见 | 放什么 |
|---|---|---|
| 仪表盘 | 所有人 | 组织当前状态:Agent 是否在线、设备分布、接入模式。 |
| 设备 | 仅管理员 | 全部设备的批准 / 吊销 / 取配置。 |
| 成员 | 仅管理员 | 邀请成员、禁用与启用。 |
| 密钥与信任 | 仅管理员 | 授权钥匙(TRK)的状态、轮换、找回;已注册的 Agent。 |
| 审计日志 | 所有人 | 组织里每个敏感动作的记录。 |
| 组织设置 | 仅管理员 | 组织名称、冻结 / 解冻等。 |
右上角显示你的身份(管理员 / 成员)。「我的设备」在页面左下角入口进入,是成员自己提交设备申请、取配置的地方——不需要打扰管理员,除了批准那一步。
二、设备:批准、吊销、取配置
批准一台新设备
- 「设备」页 →「添加设备」→ 填设备名、选系统、点「生成密钥」→ 点「提交申请」。新设备出现在列表里,状态「待批准」。
- 点该设备行内的「批准」,弹窗里把展示的指纹与设备注册页的「本机指纹」逐段核对,勾选「我已与设备注册页展示的「本机指纹」核对一致」后,「批准并签名」才会可点。
- 点「批准并签名」。浏览器用本机 TRK 私钥签发一条授权指令;Agent 在线时立即下发并生效,Agent 离线时指令入队、等它重连后自动生效(提示会写明这一点)。
取配置(二维码)
设备行内点「获取配置」,弹窗里是完整的 WireGuard 配置二维码与配置文本。用官方 WireGuard 客户端扫码导入,或复制文本发送过去。两点要知道:
- 配置在你的浏览器本地拼装,私钥从本浏览器 IndexedDB 读出填入,不经过服务器。
- 换了一台浏览器再点「获取配置」,弹窗会如实告诉你拿不到私钥(PrivateKey 一栏是占位符)——请在当初登记这台设备的那台浏览器上取,或重新登记一台设备。
吊销
设备行内点「吊销」并确认。吊销同样需要浏览器 TRK 签名。Agent 在下一次状态同步(默认 30 秒)内应用变更并断开该设备。
三、成员:邀请与禁用
- 邀请成员:「成员」页 →「邀请成员」→ 填姓名与邮箱。邀请邮件发出后,对方从邮件里的链接进控制台。邮件没发出去时界面会提示你「复制链接」手工送达——邀请链接本身就是兜底方式。
- 禁用 / 启用:成员列表里对单个成员操作。禁用后对方立即无法登录、无法刷新会话;其已批准设备也会随 Agent 状态同步断开。
- 成员只有「仪表盘 / 审计日志 / 我的设备」三个入口,看不到管理页面。
四、我的设备(成员视角)
「我的设备」是成员自助页面,不需要管理员身份:
- 添加设备:和设备页一样的流程——填名、选系统、「生成密钥」、「提交申请」。提交后等管理员批准;可以点「复制指纹」把指纹发给管理员核对。
- 获取配置:批准后点「获取配置」拿二维码。私钥就在你自己这台设备的浏览器里,所以这里取到的配置永远是完整的。
- 吊销:成员侧的吊销申请也需要管理员侧的 TRK 签名才能执行——界面上会提示你找管理员处理,这不是功能没做完。
五、密钥与信任:授权钥匙的保管、轮换与找回
授权钥匙(TRK)是组织里签发一切授权的根:批准、吊销、下发清单、冻结、解冻,全都要它签名。它只存在你的浏览器里,我们这边只有公钥——所以我们帮你找不回,也替你签不了任何一条授权。
三条必须知道的事
- 它不可导出、不可备份。它是随机生成的密钥,不是助记词派生的,界面上没有也不该有「导出助记词」按钮。
- 清除浏览器数据 = 钥匙消失。之后批准会报「签名验证失败」,需要走下面的找回流程。
- 请固定在一台电脑的一个浏览器上做批准。这台浏览器就是你的「授权终端」。
轮换
「密钥与信任」页 →「轮换密钥」:浏览器生成新的钥匙对,并把新的公钥登记到组织(旧的作废)。已批准的设备不受影响——它们认的是设备自己的 WireGuard 密钥,不是你浏览器里这把授权钥匙。
找回:登记本机 TRK
换了浏览器、清了数据、或批准一直报「签名验证失败」时:「密钥与信任」页 →「登记本机 TRK」→ 确认。它把当前这台浏览器里 TRK 的公钥登记为组织的签名公钥(旧的被轮换),之后批准即可正常签名。注意:新浏览器里没有 TRK 时先点「生成 TRK」再登记。
已注册的 Agent
同页下方展示已注册的 Agent(设备 UID 与版本)。Agent 用自己的证书维持与我们服务器的连接,轮换授权钥匙不影响已注册的 Agent。
六、审计日志
「审计日志」页记录组织里每个敏感动作:设备登记、批准、吊销、清单下发、成员增删、冻结解冻、签名密钥变更等。每条包含时间、动作、结果与操作者;被拒绝的操作也会留痕(比如签名验证失败会记录失败原因)。
- 支持按时间翻页;右上角「导出 CSV」可下载全部记录留存。
- 普通成员也能查看审计日志——组织里发生过什么,对所有人透明。
- 加载失败时点「重试」;日志不会因为刷新丢失。
七、组织设置:改名与冻结
基本信息
修改组织名称后点「保存更改」,左下角的组织名会立即更新。
冻结与解冻
- 冻结:设定时长(小时)后确认。冻结指令由浏览器 TRK 签名下发,Agent 在 ≤30 秒内应用——之后所有设备无法建立新连接,到时自动解除,或由管理员手动解冻。适用于「怀疑有设备失窃」这类紧急场景。
- 解冻:同样需要签名下发,Agent 在 ≤30 秒内应用。