本文档面向机房管理员，说明如何通过 VHD Mounter 的 RustDesk 桥接功能，对机台进行受控、可审计的远程协助。 RustDesk 桥接涉及远程控制凭证的集中管理，属于高敏感功能。所有管理端操作均需要 OTP 二次验证，所有读取明文密码的行为均会写入审计日志。 VHD Mounter 机台端内建了一个命名管道桥接服务，与本地 RustDesk 受控端协作： 机台侧只接受来自本机 RustDesk 进程的连接请求 哪些主控端可以连接，由服务端统一下发“可信主控端快照” RustDesk 连接密码在机台端加密后上报服务端，管理员需要时通过管理客户端读取 共享密钥和主控端列表变更时，服务端会主动通知机台刷新 整体架构保证：没有服务端授权，机台不会接受任何远程控制；所有授权和读取行为都可被审计。 机台运行 VHDMounter.exe 或 VHDMounter_Maimoller.exe 服务端版本 ≥ 1.7.0，且已完成初始化 机台端 vhdmonter_config.ini 已启用 RustDesk 桥接 RustDesk 受控端（ RustDesk_Controlled ）已部署在机台上，并能连接到命名管道 RustDesk 桥接功能 仅兼容 Lannamokia/rustdesk 二次开发客户端。官方原版 RustDesk 或其他衍生版本均不在支持范围内。该项目的详细中文说明与编译部署指南请参见 README-ZH.md 。 该二次开发客户端与上游保持安全同步策略：无重大 CVE 时不同步上游更新，仅保留 基础远程控制 和 文件传输 两类核心功能，其余功能均裁剪移除。部署前请确认机台上安装的是该指定版本。 自建 RustDesk 中转服务器 ​ 二次开发客户端 不依赖 官方公共中继，需要管理员自行搭建 RustDesk 中转服务： 部署时请将 hbbs 与 hbbr 部署在可被机台访问的服务器上，并妥善保存 hbbs 生成的公钥。机台客户端需要内置这些连接信息才能上线和被控。 从源码编译受控端客户端时，必须通过 CI 的 Repository secrets 注入以下四个参数： 编译脚本会在构建受控端时读取上述 secrets，并将对应值硬编码到客户端中。请确保： 四个参数与生产环境实际部署的中转服务器、桥接密钥完全一致； VHD_BRIDGE_SECRET_HEX 与服务端录入的 active RustDeskClientSharedSecret 版本匹配； 不要将 secrets 随客户端分发给非授权人员。

编辑机台上的 vhdmonter_config.ini ： 配置完成后重启机台客户端生效。 全部管理操作均通过 Flutter 管理客户端完成；管理端页面位于 设置 → RustDesk 远程控制 （或根据客户端版本在导航中直接显示为“远程控制”）。 1. 录入 RustDeskClientSharedSecret ​ RustDeskClientSharedSecret 是服务端与机台共享的 32 字节密钥，用于验证握手和派生临时凭据。 首次启用前必须录入至少一个版本。 进入 RustDesk 远程控制 → 命名管道密钥 选择输入格式： Hex ：64 位小写十六进制字符串 Base64 ：32 字节的 base64 编码 二进制文件 ：直接选择包含 32 字节的文件 Hex ：64 位小写十六进制字符串 Base64 ：32 字节的 base64 编码 二进制文件 ：直接选择包含 32 字节的文件 填写审计备注（如 首次初始化 ） 服务端会自动激活新版本，并将旧版本置为失效；随后向所有已连接机台广播 secret_outdated 反向通知，触发机台重新拉取。 建议定期轮换共享密钥。轮换时新旧版本不会同时生效，请确保所有机台已升级到能拉取新版本的客户端版本后再录入新版本。 可信主控端决定哪些 RustDesk ID 被允许连接机台。 进入 RustDesk 远程控制 → 可信主控端，可执行： 编辑 / 删除： 点击列表中对应卡片的编辑或删除按钮。删除或编辑后，服务端会自动递增快照版本并通知相关机台刷新。 可信主控端列表变更后，机台会在下次快照拉取周期（默认 5 分钟）内更新；如需立即生效，可在服务端触发反向通知或重启机台客户端。 3. 查看上报记录与读取明文密码 ​ 机台成功上报 RustDesk ID 和密码后，管理员可在 RustDesk 远程控制 → 上报记录 查看。 密码类型（临时/永久/预设/无密码） 填写查询原因（如 远程排查无法启动问题 ） 读取行为会写入审计日志，包含操作者、时间、IP、原因。