Skip to content

连接第一台电脑(接入指南)

本页介绍如何把一台电脑接入 Manager,成为可被远程控制的被控端。被控端连接 Manager 依赖 API 令牌manager_api_token)——这与「用设备码连接一台已上线的设备」是两件不同的事。

步骤一:下载并安装被控端

在你想远程控制的电脑上下载并安装被控端程序。发行版可在 GitHub Releases 获取:

步骤二:创建 API 令牌

被控端需要一个 API 令牌才能连接到本服务。

  1. 登录 Manager 控制台。
  2. 打开右上角头像菜单 →「API 令牌」(或访问 /console/settings/tokens)。
  3. 新建一个令牌并复制它——令牌只在创建时完整显示一次,请妥善保存。

在控制台首页「连接你的第一台电脑」引导中,若你还没有令牌,会有「去创建 API 令牌」的直达入口。

步骤三:在被控端填入令牌并保存

打开被控端设置,把上一步创建的 API 令牌填入「Manager 令牌 / manager_api_token」字段,保存。被控端会用该令牌连接到 Manager。

保存成功后,设备会自动上线,出现在控制台首页的设备网格我的设备列表中。

步骤四:输入访问码连接

设备上线后会显示一个 6 位设备码。在控制台首页的连接框中输入即可发起连接;也可以直接点击首页设备网格中的设备。这个连接框同时接受设备码和短期协助码,服务端会自动识别。

连接你自有或组织授权的设备时拥有完整控制权;临时协助其他电脑时,请使用对方提供的短期协助码,会话会受到该设备权限上限的约束。协助码在有效期内可用于重连,每次兑换都会审计。详见临时协助

显示分辨率不受编码器支持时

远程桌面会明确展示「视频已阻塞」,不再只留下空白播放器。请打开连接设置,选择可用的兼容编码器;或者调整被控端显示分辨率后点击「重试视频」。显式选择的编码器不会被静默替换,被控端也不会使用 CPU 帧缩放。

远程桌面设置与系统音频

连接对话框中的设备设置保存在当前浏览器,作用域是“当前登录账号 + 目标设备”;个人视图和组织视图访问同一设备时会复用。它们不会写入被控端或 Manager 数据库,也不会同步到其他浏览器;清除站点数据会删除这些偏好。短期协助码会话不持久化设置。

具备系统音频能力时,“捕获系统音频”默认请求开启,但被控端仍按独立的允许/询问/拒绝权限裁决。拒绝只关闭系统音频,不影响视频和控制。连接中修改设置无需刷新页面;界面会说明是原地应用、媒体管线重建还是页面内自动重连。

下一步