Works

RustDesk 官方版本的定制增强分支 v1.5.0.1,基准已同步升级至 官方 v1.5.0(2026-09-30 发布),完整保留官方全部功能(含会话录制)。在此基础上针对企业内部 Windows 批量部署与运维场景新增 2 项增强:CM 窗口隐藏,避免被误关闭断开连接;自动安装并启动服务,便于远程升级后重连,并支持自建中继服务器私有部署。

RustDesk

当前版本 客户端 v1.5.0.1(基于 RustDesk 官方 v1.5.0 的定制增强分支)
更新日期 2026-10-09
安装包大小 22.64 MB(23,735,296 字节)· rustdesk-1.5.0-install.exe(Windows 64 位安装包)
SHA256 校验 017df94213c7eed5fe64f615804b3e26ad3667d7abf0887d7a60d2c8262d42c5
系统要求 Windows 10/11、Windows Server 2016 及以上(64 位),macOS 10.14+ 与主流 Linux 桌面发行版(已在 Ubuntu / Fedora / Arch 验证)
中继服务 支持自建中继服务器(hbbs / hbbr)私有部署,也可使用上游公共中继;连接参数在客户端「设置 → 网络」中配置
授权方式 免费使用,禁止商业用途;上游 RustDesk 遵循 AGPL-3.0,二次分发须保留开源协议
界面语言 简体中文 / 英文(沿用上游多语言资源)
更新日志 v1.5.0.1 发行版说明 ↗;官方上游更新见 RustDesk 1.5.0 Release ↗;本仓库提交记录见 Gitee 提交历史 ↗
下载说明

Windows 64 位安装包 rustdesk-1.5.0-install.exe(22.64 MB)发布在 Gitee 发行版页面 ↗。下载前请核对版本号与安装包 SHA256,安装前建议先阅读下方《用户协议与免责声明》。

反馈与联系

使用中遇到问题或有改进建议,欢迎通过 联系页面 或邮件 lxdfox@qq.com 反馈,也可以在 Gitee 仓库提交 Issue。反馈时请附客户端版本号、操作系统版本与问题截图,便于定位。

软件介绍

RustDesk 是一款开源的远程桌面软件,可完全自建服务器、数据不出内网,是 TeamViewer / AnyDesk 等商业软件的可控自建替代方案。本仓库是 RustDesk 官方版本的定制增强分支(v1.5.0.1),基准已同步升级至 官方 v1.5.0(2026-09-30 发布),官方全部功能均完整保留(含会话录制等)。在此基础上,针对企业内部 Windows 批量部署与运维场景新增以下 2 项增强。下表为本分支独有功能,官方原版不具备。

#功能说明
1CM 窗口隐藏连接管理(CM)窗口默认不弹出、不抢焦点,避免被误操作关闭而导致连接断开,适合无人值守部署与长期在线的被控端
2自动安装并启动服务安装包完成安装/覆盖升级后自动安装并拉起系统服务,远程升级完成后即可自动恢复连接,无需人工在被控端干预
免责说明

本项目基于开源 RustDesk(AGPL-3.0)二次开发,本人为非职业开发者,仅在业余时间维护。客户端代码由 AI 与人工协同完成,使用过程中遇到问题欢迎反馈。

本次更新:跟随官方升级至 v1.5.0

本次发布的核心变化是上游基准从官方 1.4.x 升级到 1.5.0。RustDesk 官方未在这一版提供成文的变更清单(发布页仅给出下载矩阵),以下要点由本仓库 1.4.9 → 1.5.0 提交对比 ↗(共 250 项提交)整理,供升级前评估参考。

  • 会话录制增强录制可见性与服务端存储位置支持配置(#15662),适配合规留痕场景
  • 安全性与限流新增 ID 白名单与通配匹配(#15586)、登录重试 nonce 与失败反馈限流(#15759 / #15727);剪贴板数据补充 RGBA 维度、文件格式校验(#15672 / #15692 / #15693),远端音频补充通道数校验(#15673)
  • Windows 体验修复消除重复与残留的托盘图标(#15689);加固安装包临时命令脚本(#15634)
  • Linux Wayland新增 DRM/KMS 直接捕获路径,无需 portal 授权弹窗即可采集屏幕(#15420)
  • macOS支持静默自动更新并同步做安全加固(#15550)
  • 身份与合规OIDC 登录适配 API 域名、改为手动打开浏览器完成授权(#15710 / #15706);新增 SBOM 软件物料清单以对接欧盟 CRA(#15732)
  • 其他修复Web 客户端离线编解码、终端 SGR 鼠标滚轮报告、多显示器主屏选取、强行重绘白屏等若干问题修复
升级注意

v1.5.0.1 为覆盖升级安装包,安装后会自动安装并启动服务,可在远程会话中断的情况下自行恢复连接。若自行配置过 ID / 中继服务器,请确认客户端设置中的服务器地址与 Key 未被覆盖。

适用场景

面向企业内网远程运维、分支机构技术支持、无人值守设备远程协助,以及需要替代 TeamViewer / AnyDesk 等商业软件、寻求可控自建方案的团队。

核心定制点(本分支独有)

  • CM 窗口隐藏连接管理(CM)窗口默认不弹出、不抢焦点,避免误关闭导致连接断开,适合无人值守部署与长期在线的被控端
  • 自动安装并启动服务覆盖升级后自动安装并拉起系统服务,远程升级完成后即可自动重连,无需在被控端人工干预

自建中继服务端部署

RustDesk 的服务端分两个组件:hbbs(信令 / 注册)和 hbbr(中继转发)。以下是通用的自建部署教程,示例中的服务器地址均使用占位符,请替换为您自己的主机。自建后所有远程桌面流量均经由您自己的服务器转发,不经过任何第三方。

注意

本节为可选的通用部署教程。本客户端不预设任何服务端信息,是否需要自建、使用哪台主机、采用何种端口映射,完全由使用者自行决定并自行配置。

部署前准备

  • 服务端主机Linux 主机(Ubuntu / Debian / CentOS),已安装 Docker 27+ 与 docker-compose
  • 网络与端口对外暴露以下端口:hbbs 21115/tcp、21116/tcp+udp;hbbr 21117/tcp、21118/tcp+udp。外网映射端口可按需自行指定
  • 服务器地址建议客户端使用 <您的服务器 IP 或域名>:21116 形式填写,避免 DNS 解析问题
  • 加密密钥使用 openssl rand -base64 32 生成 32 字节密钥,所有客户端与服务端必须保持一致

Docker 启动示例

  1. 创建 docker-compose.yml 内容包含 hbbs 与 hbbr 两个服务,共享 -v ./data:/root,将密钥作为 -k 参数传入。
  2. 启动服务 在 docker-compose.yml 同目录下执行 docker compose up -d,服务以独立容器在后台运行。
  3. 提取服务端 Key 启动后查看 ./data/ 下的 id_ed25519.pub 或容器日志中的 key 字符串,保存供后续客户端使用。
  4. 配置客户端 打开 RustDesk 客户端 → 设置 → 网络 → ID/中继服务器,填入自建服务器的 ID 服务器和中继服务器地址,将密钥粘贴到「Key」字段。
  5. 验证互通 在两台客户端上填入相同的服务器信息,主控端输入被控端 ID 即可远程连接;如能直连,整个过程完全不经过中继服务器。
  6. 防火墙与白名单 在防火墙放行上述端口,并按需配置 IP 白名单,仅允许授权客户端接入。
提示

客户端配置文件位于 %APPDATA%\\RustDesk\\config\\RustDesk2.toml(Windows)或 ~/.config/rustdesk/RustDesk2.toml(Linux)。该文件中的 custom-rendezvous-server、relay-server 与 key 三项默认为空,由使用者按需填写;批量部署时可自行编写脚本下发自己的配置。

运行要求及测试结果

以下为客户端 v1.5.0.1 在实际使用中验证通过的运行环境与服务端要求,供部署前评估参考。

客户端(Client)

上游基准 官方 RustDesk 1.5.0(2026-09-30 发布),官方全部功能均保留(含会话录制)
操作系统 Windows 10/11、Windows Server 2016 及以上(64 位);macOS 10.14+;Linux 桌面发行版(Ubuntu / Fedora / Arch 验证通过)
处理器 双核 1.5 GHz 及以上;启用硬件编码(如 Intel QSV / NVIDIA NVENC)可显著降低远程端 CPU 占用
内存 最低 4 GB;分辨率与帧率越高,内存需求相应提高
网络与端口 客户端无需对外开放端口;通过中继服务与对端协商端口(可直连时流量不经中继)
授权方式 免费使用,禁止商业用途;二次分发须遵守上游 AGPL-3.0 条款

自建服务端(hbbs + hbbr)

部署方式 Docker 容器(lejianwen/rustdesk-server 镜像),也可用官方 rustdesk/rustdesk-server 镜像直接构建
网络与端口 hbbs:21115/tcp(信令)、21116/tcp+udp(注册与打洞);hbbr:21117/tcp(中继)、21118/tcp+udp(Web 客户端);外网映射端口由部署者自行指定
加密密钥 使用 openssl rand -base64 32 生成;全网络共享,服务端与所有客户端保持一致
数据存储 服务端 data/ 目录持久化设备注册信息;定期备份即可,无外部数据库依赖
日志验证 启动后查看容器日志或 data/ 日志文件,确认客户端注册成功
说明

如需最小化验证又不想搭服务端,RustDesk 客户端支持 IP 直连:<ID>@<IP>:<端口>?key=<密钥>,适合临时救急或同一内网内小规模场景;长期方案仍推荐完整自建。

已知限制

为避免使用预期与实际不符,现将当前版本的能力边界如实列出。以下限制会随上游与本项目的迭代逐步改善。

  • 依赖中继服务端可用性若使用自建 hbbs / hbbr 服务,需确保服务端可达并已放开对应端口;服务端不可达时需切换回公共中继或调整防火墙
  • 增强项面向 Windows 桌面端CM 窗口隐藏、自动安装并启动服务两项增强均针对 Windows 桌面端,macOS / Linux 与移动端暂未涉及
  • 剪贴板同步遵循 OS 权限Linux Wayland 环境下剪贴板受 Portal 限制,部分桌面需要先授权才能跨机同步
  • 维护节奏不固定作者非职业开发者,仅利用业余时间维护;问题响应、Bug 修复与版本发布周期无法承诺时效

界面与核心功能

一、连接管理与主控端

主控端在连接管理界面输入对端 ID 与(可选)临时密码即可建立远程会话。已配对设备会出现在设备列表中,点击即可一键连接;如需使用自建中继服务端,可在「设置 → 网络 → ID/中继服务器」中配置相应的 ID 服务器、中继服务器与 Key。

主控端连接管理 更多截图待补充

二、文件传输与远程复制

远程会话中可使用工具栏的文件传输按钮,在主控端与被控端之间上传 / 下载文件,并支持多文件批量操作;文字、图片等剪贴板内容同样可在会话两端同步,便于远程粘贴命令、日志与配置片段。本分支的定制增强请见「软件介绍」页签,官方其余功能(文件传输、TCP 隧道、终端、会话录制等)均完整保留。

远程文件传输 · 远程复制粘贴 更多截图待补充

三、TCP 隧道与终端

客户端内置 TCP 隧道能力,可在主控端访问被控端内网端口,相当于开了一条加密隧道;适合远程访问内网服务、调试隔离网络下的应用。基于 Flutter 的终端窗口可以在主控端内直接执行 cmd / bash / PowerShell 命令,输出即时回显。

四、静默安装与自动启动

使用者可根据自己的环境,在「设置 → 网络 → ID/中继服务器」中填写自建服务端信息,或直接使用上游公共中继。本分支的安装包会在安装 / 覆盖升级完成后自动安装并启动服务,远程升级后可自行恢复连接,适合无人值守设备的批量更新场景。

小贴士

如需通过配置文件而非 UI 填写,可编辑 %APPDATA%\\RustDesk\\config\\RustDesk2.toml 中的 custom-rendezvous-server 与 relay-server 项,密钥字段为 key;覆盖升级前建议先确认该文件中的自建服务器信息,避免被新版配置重置。