RustDesk 1.5.0 升级安装故障处理笔记

故障现象：旧版本可正常安装运行，升级1.5.0版本，点击安装出现进度条后直接消失，无报错，系统服务RustDesk未注册，sc query RustDesk返回【指定的服务未安装 1060】

根因：1.5.0自带的 usbmmidd 虚拟显示驱动兼容性/签名问题 ，安装程序尝试部署该驱动时直接整体退出，服务注册流程被中断。

环境：Windows RDP远程被控机器

一、关键知识点

普通exe安装包不存在 --no‑virtual‑display 参数，该参数无效。
exe安装包有效静默参数：--silent‑install。
rustdesk.exe --install‑service：仅注册后台服务，不会安装usbmmidd虚拟显示驱动，用于绕开驱动崩溃问题。
Windows【内存完整性(内核隔离)】开启时，1.5.0的usbmmidd驱动会被系统直接拦截。
便携版"不安装直接运行"：仅当前RDP会话有效，关闭RDP程序退出，不能作为真正被控端。
安装包闪退不一定是杀毒拦截，优先排查旧驱动残留占用。

二、完整处理步骤（升级失败修复流程）

1. 彻底清理旧版本残留（管理员CMD执行）

cmd 复制代码

net stop RustDesk
sc delete RustDesk
sc delete usbmmidd

rd /s /q "%APPDATA%\RustDesk"
rd /s /q "C:\Program Files\RustDesk"

⚠️ 清理完成必须重启Windows，释放被占用、锁定的驱动文件，不可省略。

2. 重启后尝试exe静默安装

cmd 复制代码

rustdesk‑1.5.0‑x86_64.exe --silent-install

检查服务：

cmd 复制代码

sc query RustDesk

✅ 返回STATE:4 RUNNING：安装成功，直接跳转到【4、配置自建服务器】
❌ 服务依旧不存在：进入兜底方案

3. 兜底方案：绕开安装包驱动流程，手动注册服务

运行rustdesk‑1.5.0‑x86_64.exe，选择【不安装直接运行】，让安装包释放程序文件到C:\Program Files\RustDesk，随后关闭GUI窗口。
管理员CMD，进入程序目录，手动注册后台服务（不安装虚拟显示驱动）

cmd 复制代码

cd /d "C:\Program Files\RustDesk"
rustdesk.exe --install-service

校验并启动服务

cmd 复制代码

sc query RustDesk
net start RustDesk

代价：无虚拟显示器功能，普通远程控制、文件传输不受影响。

4、配置自建服务器（服务启动前修改配置）

cmd 复制代码

cd /d "%APPDATA%\RustDesk\config"

编辑 RustDesk2.toml（注意不是旧的RustDesk.toml）

toml 复制代码

[options]
custom-rendezvous-server = '<服务器IP>:21116'
relay-server = '<服务器IP>:21117'
key = '<服务器公钥字符串>'

保存配置，重启服务生效

cmd 复制代码

net stop RustDesk
net start RustDesk

5、最终验证

cmd 复制代码

sc query RustDesk

状态必须为 STATE:4 RUNNING。

打开RustDesk，右下角状态显示【就绪】，代表被控端正常，可以关闭RDP做远程测试。

三、备选方案（最稳妥）

如果业务需要虚拟显示器功能，1.5.0版本在开启内存完整性的机器无法使用，直接降级回之前正常工作的旧版本安装包。

四、排查检查清单

Windows安全中心→保护历史记录，确认是否拦截usbmmidd驱动
设置‑隐私和安全性‑Windows安全中心‑设备安全性‑内核隔离详细信息，查看【内存完整性】是否开启
服务器端口：21115、21116、21117、21118安全组与防火墙放行
客户端toml内IP、端口、公钥key无多余空格、字符完全匹配
必须修改RustDesk2.toml，旧配置文件不生效

五、避坑要点

清理旧驱动后一定要重启机器，驱动文件被占用会导致无论怎么装都失败。
不要使用PowerShell执行rd删除命令，符号容易出错，全程用CMD。
不要在便携模式没有配置好服务器的情况下点击GUI内紫色【安装】，会生成默认配置连上官方服务器。
rustdesk.exe --install‑service只注册服务，跳过usbmmidd驱动，牺牲虚拟显示换取安装成功。

配套笔记可以结合之前RustDesk自建服务器Key强校验笔记一起保存使用。

网址：https://blog.csdn.net/weixin_44858074/article/details/167466831?spm=1011.2415.3001.5331