RustDesk 迁移 常见问题与排查 202604：核心配置同步与中继服务器平滑切换实战

在进行远程办公环境升级或服务器机房调整时，RustDesk 的迁移往往涉及 ID 服务器（hbbs）与中继服务器（hbbr）的重新指向。如果操作不当，极易导致客户端 Key 校验失败或地址簿丢失。本指南聚焦 202604 周期下的主流版本，为您提供闭环的迁移方案。

配置文件物理定位与备份逻辑

在 RustDesk 迁移过程中，最常见的错误是仅安装了软件而忽略了原始配置文件的物理覆盖。对于 Windows 用户，核心配置存储在 `%AppData%\RustDesk\config` 目录下；而 Linux 用户则需关注 `/root/.config/rustdesk` 或 `~/.config/rustdesk`。迁移时，必须完整拷贝 `id_ed25519`（私钥）和 `id_ed25519.pub`（公钥）文件。这两个文件决定了您的设备在自建服务器上的身份唯一性。若丢失私钥，即便您在新服务器上配置了相同的 ID，客户端也会因为签名不匹配而弹出‘Key mismatch’警告，导致无法建立加密隧道。建议在迁移前，先通过命令行执行 `ls -al` 确认权限，确保新环境下的配置文件具备正确的读写权限。

Key 密钥一致性与强制加密校验

为了安全性，大多数自建用户会在启动 hbbs 时添加 `-k _` 参数。这意味着客户端必须持有正确的 Key 才能接入。在迁移场景下，如果新服务器生成了新的密钥对，而旧客户端仍保留旧 Key，连接将直接被阻断。排查细节在于：查看服务端运行目录下的 `id_ed25519.pub` 内容，并将其手动填入客户端‘设置-网络’中的 Key 栏位。若希望实现‘无感迁移’，最佳实践是直接将旧服务器的密钥对文件复制到新服务器的运行目录中，并确保文件所有者为运行 RustDesk 进程的用户。这种方式可以避免逐一通知终端用户更改 Key，极大地降低了运维成本，是企业级迁移中推荐的标准化流程。

自建 ID 服务器变更后的连接重置排查

当您将 hbbs 服务从旧 IP 迁移至新 IP（例如从 1.1.1.1 迁移至 2.2.2.2）时，客户端往往会出现长时间的‘正在连接’提示。此时需优先排查防火墙端口开放情况。RustDesk 依赖 21115 (TCP)、21116 (TCP/UDP)、21117 (TCP)、21118 (TCP) 以及 21119 (TCP) 端口。一个真实的排查案例是：用户在迁移至云服务器后，虽然在 OS 层面关闭了 iptables，但忽略了云厂商控制台的‘安全组’规则。此外，务必检查客户端设置中的‘ID 服务器’地址是否已更新。若使用了域名，需确认 DNS 解析已在全球范围内生效。可以通过 `telnet yourdomain.com 21116` 命令快速验证中继服务是否处于监听状态，这是解决迁移后连接超时的金标准。

地址簿与历史记录的无缝平替

对于新手用户，迁移后发现‘最近连接’列表变为空白是最直观的痛点。RustDesk 的连接历史记录存储在 `peers.json` 文件中。在 202604 版本的实操中，我们发现直接替换该文件即可恢复大部分非注册用户的本地列表。但如果您使用了 RustDesk 开源版或 Pro 版的 API 功能，则需要额外迁移 SQLite 数据库（通常名为 `rustdesk.db`）。在 Linux 服务端，该数据库记录了所有注册用户、标签及权限分配。迁移步骤应为：停止 docker 容器或系统服务 -> 导出 .db 文件 -> 在新服务器部署相同版本的镜像 -> 覆盖 .db 文件 -> 重启服务。注意，版本跨度不宜过大（如从 1.1.x 直接跳至 1.3.x 以上），否则可能触发数据库架构不兼容的异常。

常见问题

迁移后客户端显示‘Key 不匹配’，但我明明已经填了新 Key？

这种情况通常是因为本地缓存未刷新。请尝试先清空客户端设置中的 Key 栏位并保存，重启 RustDesk 进程，然后再重新填入新服务器的公钥。此外，检查服务端是否同时运行了多个 hbbs 实例，导致读取了错误的密钥文件。

我更换了服务器 IP，但想保留原来的 9 位数字 ID，能做到吗？

可以。RustDesk 的 ID 是基于硬件特征生成的，并存储在本地配置文件中。只要您保留了客户端原有的 `config` 文件夹（尤其是里面的设备标识文件），即便连接的服务器 IP 变了，您的 9 位 ID 依然会保持不变。

Linux 服务端迁移后，Docker 容器频繁重启且报错‘Address already in use’？

这是典型的端口冲突。请检查宿主机是否已安装了旧版的 RustDesk 服务或其它占用 21116 端口的程序。使用 `netstat -tunlp | grep 2111` 命令定位占用进程，杀掉冲突进程后再启动 Docker 容器即可解决。

总结

获取最新版 RustDesk 迁移工具包及服务端镜像，请访问官方下载页面或查阅 2026 版部署文档。

相关阅读：RustDesk 迁移 常见问题与排查 202604，RustDesk 迁移 常见问题与排查 202604使用技巧，RustDesk 迁移 常见问题与排查 202604：跨服务器数据同步与 ID 冲突深度避坑指南