RustDesk 迁移 常见问题与排查 202604：自建服务器与客户端数据无缝转移指南

随着2026年4月RustDesk底层协议的优化升级，不少用户开始将旧设备或旧版自建服务器的数据转移至新环境。然而，迁移并非简单的“复制粘贴”，公钥不匹配、服务无法注册等报错时常让新手一筹莫展。本文将直接切入实际操作中的高频报错场景，为您提供精准的排查路径。

自建服务器(hbbs/hbbr)迁移：公钥不匹配报错

当您将自建的中继服务器从一台云主机迁移到另一台时，客户端经常会弹出“Key mismatch”或“连接网络被拒绝”的警告。这通常是因为在打包迁移Docker容器或二进制文件时，遗漏了 id_ed25519.pub 和 id_ed25519 这对密钥对。202604版本及后续更新的安全校验更加严格，如果新服务器生成了新的密钥，旧客户端将无法接入。排查方法：检查新服务器hbbs运行目录下的公钥字符串，是否与客户端“网络设置”中填写的Key完全一致。若不一致，需手动覆盖服务器密钥文件并执行 systemctl restart hbbs 重启服务。

端口冲突导致中继服务(hbbr)启动失败

迁移到全新的Linux服务器后，新手常遇到hbbs（ID服务器）正常运行，但hbbr（中继服务器）死活连不上的情况。通过 netstat -tulnp | grep 21119 命令排查，往往会发现21117或21119端口被系统其他进程（如某些防火墙自带的监控服务）占用。RustDesk的默认通讯高度依赖21115-21119这几个TCP/UDP端口。解决此问题，需在云服务商的安全组中放行上述端口，并在服务器内部使用 kill -9 结束占用进程。若必须修改默认端口，请务必在启动命令中加上 -r : 参数同步调整。

客户端迁移后ID变更与通讯录丢失排查

在更换办公电脑并重新安装RustDesk 1.2.4及以上版本时，新手常发现原有的设备ID变了，且收藏的通讯录全部清空。这是因为本地配置数据未同步。排查与解决步骤很简单：在旧电脑的 %appdata%\RustDesk\config 目录下，找到 RustDesk.toml 和 RustDesk2.toml 两个核心文件。将它们直接拷贝到新电脑的同级目录中并重启软件。注意，如果新旧电脑的操作系统跨平台（如Windows迁至macOS），需将配置文件放置于 ~/.config/rustdesk/ 路径下，否则软件将无法读取旧ID，导致连接请求被拒。

局域网迁移后的IP直连失效问题处理

部分用户在封闭的局域网环境内完成RustDesk迁移后，发现原本好用的“IP直连”功能失效，输入目标IP后一直显示“正在连接”。排查此类问题，首先需确认新设备的系统防火墙是否拦截了RustDesk的入站请求。在Windows高级安全防火墙中，需手动添加允许RustDesk.exe通过的规则。其次，检查软件设置中的“允许IP直接访问”选项是否在迁移后被默认重置为关闭状态。进入“设置”->“安全”->“允许IP直接访问”，勾选该选项并应用设置，通常即可恢复局域网内的毫秒级无延迟远控体验。

常见问题

为什么把旧电脑的配置文件复制到新设备后，软件一直提示“服务未运行”？

这通常是因为权限不足或后台服务卡死。请先在任务管理器中彻底结束所有RustDesk进程，右键以管理员身份运行软件。如果仍未解决，点击软件底部的“安装”按钮将其注册为系统级服务，即可正常加载旧配置。

迁移自建服务器时，Docker Compose一键部署后客户端显示“就绪”但无法远控，怎么排查？

重点检查您的中继服务器(hbbr)映射地址。在docker-compose.yml文件中，确保 RELAY 参数或启动命令填写的是新服务器的公网IP，而不是内网IP或旧IP。客户端虽然能连上hbbs获取状态，但打洞失败时必须依赖hbbr的公网地址进行流量转发。

2026年4月更新后，原有的自定义API服务器地址在迁移后失效了怎么办？

新版本对API接口的SSL证书校验更加严格。请检查您迁移后的Web服务器（如Nginx）是否正确配置了HTTPS证书，且证书未过期。如果使用自签证书，需在客户端的高级设置中暂时开启“忽略证书错误”进行排查测试。

总结

顺利完成迁移是稳定远控的第一步。如果您在排查过程中仍遇到难以解决的网络环境问题，或希望体验最新版本的流畅穿透能力，请立即前往RustDesk官网下载最新客户端，获取官方技术文档与社区支持！

相关阅读：RustDesk 迁移 常见问题与排查 202604，RustDesk 迁移 常见问题与排查 202604使用技巧，RustDesk 迁移 常见问题与排查 202604：跨设备平滑过渡全指南