RustDesk 迁移 常见问题与排查 202604：新手零基础避坑指南

迁移RustDesk自建中继服务器或更换控制端设备，往往让不少新手感到头疼。明明输入了新的IP，却始终提示“未就绪”？别慌，这通常是由于缓存残留或端口放行不彻底导致的。接下来，我们将直击迁移过程中的核心卡点，提供切实可行的排查方案。

核心配置文件与设备列表无损迁移

很多新手在更换控制端电脑后，最头疼的就是曾经保存的上百台设备列表全部消失。其实，RustDesk的设备记录主要存储在本地的配置文件中。在Windows环境下，您只需在旧电脑的资源管理器地址栏输入 %appdata%\RustDesk\config，找到 RustDesk.toml 和 peers 文件夹，将其完整复制到新电脑的同名路径下即可。如果在迁移后发现列表未更新，请尝试在任务管理器中彻底结束 RustDesk.exe 进程后重新覆盖文件，这样就能完美继承所有历史连接记录，免去手动重新输入的烦恼。

自建服务器IP变更后的“未就绪”排查

当您将RustDesk的hbbs/hbbr服务端迁移至新云主机（如2026年4月新采购的节点）后，客户端经常会一直显示“正在连接网络”或“未就绪”。此时，第一步排查绝不是重装软件，而是检查公钥（Key）是否匹配。服务端在首次启动时会自动生成 id_ed25519.pub 文件。如果您在新服务器上是全新安装，务必用文本编辑器打开该文件，将其中的字符串复制，并填入所有客户端的“ID/中继服务器 -> Key”设置框中。若新旧服务器Key不一致且未更新客户端配置，连接将被直接拒绝。

端口放行盲区与连通性深度验证

迁移到新服务器环境时，防火墙规则遗漏是导致连接失败的重灾区。RustDesk的正常运行依赖多个特定端口，新手常常只记得放行TCP，却忽略了UDP。请务必登录您的云服务商控制台，检查安全组规则：21115到21119端口必须全部放行TCP，同时 21116端口必须额外放行UDP（用于打洞直连）。如果您的客户端提示“无法连接至中继服务器”，可以使用命令行工具 telnet 新服务器IP 21116 测试TCP连通性。若端口不通，请优先检查系统自带防火墙（如ufw或firewalld）是否已同步放行这些端口。

跨版本迁移的协议兼容性考量

随着软件迭代，跨大版本迁移可能会引入意料之外的连接阻碍。例如，从早期的 1.1.9 版本直接迁移至最新的 1.2.x 或 1.3.x 架构时，由于底层加密协议的强化，旧版客户端可能无法与新版服务端顺利握手。在进行 202604 批次的系统迁移时，强烈建议将所有受控端与主控端的 RustDesk 统一升级至官方最新稳定版。如果您发现部分老旧设备在迁移后频繁掉线，请检查客户端网络设置中的“强制走中继”选项是否被意外勾选，适当调整直连策略往往能迅速恢复稳定。

常见问题

换了新电脑，原来收藏的几十个被控端密码怎么一键导过来？

密码和设备信息都保存在本地配置里。请在旧电脑按 Win+R 键，输入 %appdata%\RustDesk\config，把里面的所有文件打包拷贝到新电脑的相同目录。注意操作前必须先退出新电脑右下角的RustDesk托盘图标。

新搭建的服务器明明IP填对了，为什么主控端还是红字提示“Key不匹配”？

这是因为新服务器生成了全新的加密密钥。您需要登录新服务器，找到 hbbs 运行目录下的 id_ed25519.pub 文件，用记事本打开复制里面的代码，然后粘贴到主控端网络设置的“Key”一栏里。

局域网内两台机器迁移后可以秒连，但外网连进来就卡在“等待图像”，怎么破？

这种“能连上但无画面”的现象，绝大多数是因为新服务器的 21117 端口（负责中继传输）没有在防火墙中放行TCP流量，或者 21116 的UDP打洞失败。请重点检查云服务器的安全组出入站规则是否完全开放了这两个关键端口。

总结

准备好体验更流畅的远程桌面了吗？立即访问RustDesk官方下载页获取最新版本，或查阅官方文档获取更详尽的部署教程，让您的迁移之旅稳妥无忧！

相关阅读：RustDesk 迁移 常见问题与排查 202604，RustDesk 迁移 常见问题与排查 202604使用技巧，掌握核心RustDesk功能：新手从零开始的跨平台远控配置与实战指南