核心概念
快速建立对各组成部分的心智模型。
角色
- 控制端(浏览器客户端)——发起远程控制的浏览器,同时承载管理控制台。
- Desk 服务(被控端)——采集并编码屏幕与音频、注入输入,并提供文件、剪贴板和终端功能。
- 信令服务——通过 WebSocket 在控制端与被控端之间交换 SDP 和 ICE 信息,内置于服务端程序。
- STUN / TURN——负责 NAT 穿透与流量中继,同样内置于服务端程序。
连接与媒体路径
浏览器与远端设备通过信令服务交换 SDP 和 ICE 信息,并使用 STUN/TURN 收集候选地址。连接会优先采用 WebRTC 点对点直连;只有 NAT 穿透失败时才改用 TURN 中继。信令与 TURN 均内置于服务端程序。
连接建立后,视频、Opus 音频及数据通道(输入、剪贴板、文件管理)都跑在 WebRTC 上。远程终端使用独立的鉴权 WebSocket,而不是 WebRTC 数据通道。
传输一览
| 通道 | 承载 |
|---|---|
| 视频轨 | 编码后的屏幕帧(AV1 / H.264 / VP8 / VP9) |
| 音频轨 | 经被控端授权、以 Opus 实时传输的系统音频 |
| 数据通道(输入) | 鼠标 / 键盘注入 |
| 数据通道(剪贴板) | 双向文本剪贴板 |
| 数据通道(文件) | 上传、下载、删除 |
| 鉴权 WebSocket(终端) | 专用的 xterm.js 命令行数据流 |
AI 作为控制端
除了浏览器,AI 模型也可以读取并分析设备状态。会话内诊断严格按照采集 → 脱敏 → 模型 → 展示的顺序执行。在设备所有者自己的设备上,诊断助手可以提出命令请求,但只有所有者确认完整命令后,被控端才会执行;MCP 服务始终保持只读。见 AI 诊断与 AI 安全模型。
下一步
默认模式在同一个操作系统进程内,通过进程内通道运行逻辑上的 daemon → 对等连接 → worker 流水线。采集安全界面(Windows UAC / 锁屏)时才需要跨权限边界拆分——见启动模式。