RustDesk自定义客户端编译与配置指南：打造自己的品牌远程工具

给家人装 RustDesk，每次都要手把手填服务器地址；给公司批量部署，每台机器都要改一遍配置——这些重复劳动有个一劳永逸的解法：编译一个预置了全部配置的自定义客户端。装上就能用，服务器、加密 Key、ID 前缀全部内置。本文讲解完整流程。

自定义客户端能预置什么

RustDesk 是开源软件，允许基于源码生成定制版本。可在编译阶段固定的内容包括：

• ID/中继服务器地址：填好你自建的 hbbs/hbbr 服务器
• 公共 Key：预置服务器密钥，装完即加密通信
• ID 前缀：自定义的设备 ID 命名前缀，便于区分设备来源
• 应用名称与图标：替换为自己的品牌名称，白标化交付
• 默认设置：如默认开启无人值守、关闭远端鼠标显示等

方案一：GitHub Actions 云端编译（推荐，本地零环境）

不需要本地配置任何编译环境，全程用 GitHub 的服务器干活，也是官方文档推荐的方式。

操作步骤

1. 注册 GitHub 账号，打开 RustDesk 官方仓库，使用 Fork 将源码复制到自己账号下
2. 进入自己 Fork 的仓库 → Settings → Secrets and variables → Actions
3. 添加名为 RENDEZVOUS_SERVER 的 Secret，值为你的服务器地址；添加 RS_PUB_KEY，值为服务器公钥
4. 进入 Actions 页签，启用工作流，手动触发 Flutter Nightly Build 或对应的发布构建
5. 等待构建完成（约数十分钟），在 Artifacts 中下载各平台安装包

优势与注意

• 不占用本地资源，Windows/macOS/Linux/安卓包一次全出
• GitHub 免费额度对个人足够
• 注意 Fork 的仓库要与上游保持同步更新，定期从上游拉取安全补丁
• 公司环境建议自己维护私有仓库分支，记录定制内容

方案二：本地编译（进阶用户）

需要 Flutter、Rust、NDK 等完整工具链，适合有开发背景、想深度修改界面的用户：

• 按 RustDesk 官方仓库文档搭建 Flutter + Rust 环境
• 修改 libs/hbb_common 中的默认服务器配置
• 执行对应平台的构建命令产出安装包

如果你只是想预置服务器配置，方案一完全够用，不必碰本地编译。

编译前必须准备的三样东西

尚未自建服务器的用户，先完成服务端部署再回来做客户端定制，顺序不能反。

编译完成后：验证与分发

上线前验证清单

• 安装到一台测试机，启动后检查 ID 是否带上了自定义前缀
• 确认无需任何手动配置，即可通过你的服务器完成远程连接
• 检查通信是否显示为加密状态（服务器端日志可确认 Key 生效）
• 安卓包额外测试电池优化白名单引导是否正常

分发建议

• 团队内部通过内部网盘或文件服务器分发，记录每个批次版本
• 给家人用的设备，直接发安装包并远程协助装好
• 升级时重新走一遍编译流程，替换分发版本

常见问题

编译出的客户端能连官方服务器吗？

能。预置配置只是默认值，用户仍可在设置中改回官方服务器，这是开源许可允许的范围。

用了自定义客户端，ID 前缀是随机的吗？

自定义前缀基于你设置的字符串生成，同类设备前缀一致，配合后缀数字可快速识别设备来源。

客户端自定义违反 RustDesk 许可吗？

RustDesk 采用 AGPL 开源许可，修改和再分发是许可明确允许的，注意保留开源声明并遵守相应义务。

总结

自定义客户端是 RustDesk 从「个人工具」升级为「专属基础设施」的临门一脚：配置预置消灭了每台设备的手动设置，品牌定制让交付更专业。借助 GitHub Actions，整个过程零本地环境、零费用，一个下午就能产出全家平台的定制安装包。部署的那一刻你会明白——之前每次手动填服务器地址的时间，都是可以省下来的。