RustDesk 迁移 常见问题与排查 202604：从旧版 ID 服务器平滑过渡到新环境的实战指南

在进行自建 RustDesk 服务器迁移时，许多用户往往简单地认为只需在新服务器上运行 hbbs 和 hbbr 即可。然而，实际操作中经常遇到‘连接始终在尝试’或‘Key 不匹配’等阻碍。本文将针对 202604 周期内用户反馈最多的迁移故障，提供一套标准化的排查流程。

身份凭证的“血缘”延续：密钥对迁移细节

迁移 RustDesk 最核心的步骤并非重装软件，而是对身份密钥对（id_ed25519 和 id_ed25519.pub）的完整保留。在 2026 年的生产环境中，若您直接在新服务器生成新密钥，所有旧客户端将因公钥指纹不一致而拒绝连接，弹出‘Key Mismatch’警告。排查细节：请务必进入旧服务器执行路径（通常为 /var/lib/rustdesk-server 或 Docker 挂载目录），将这两个文件以二进制模式复制到新环境。若您在启动参数中使用了 ‘-k _’，则必须确保新旧服务器的公钥字符串完全一致。实操建议：在迁移后，通过 cat 命令对比新旧环境的 .pub 文件 MD5 值，这是确认身份一致性的最快手段。

网络拓扑重构：端口映射与防火墙深度扫描

很多新手在迁移后发现客户端显示‘Ready’但无法连接，这通常是由于中继服务器（hbbr）的端口未正确开放。RustDesk 依赖五个关键端口：TCP 21115-21119 以及 UDP 21116。特别是在 202604 版本的部署逻辑中，UDP 21116 承载了心跳包和 P2P 打洞的关键任务。真实场景排查：若迁移到了阿里云或腾讯云等环境，除了系统内部的 ufw/iptables，还需在云控制台的安全组中手动放行。一个典型的排查技巧是使用 ‘nc -uvz [新IP] 21116’ 测试 UDP 连通性，如果该端口不通，客户端将永远卡在‘正在连接’状态，无法获取中继授权。

配置同步策略：避免数百台客户端手动重填

大规模迁移中最头疼的是更新受控端指向的新 IP。对于 Windows 用户，可以利用 RustDesk 的‘程序名自动配置’特性。具体操作是将下载的安装包重命名为 `rustdesk-host=ID服务器地址,key=密钥.exe`。在迁移场景下，如果旧 IP 已失效，您可以通过修改内网 DNS 解析，将旧域名指向新 IP，实现‘无感迁移’。如果必须更改地址，建议利用注册表路径 `HKEY_LOCAL_MACHINE\SOFTWARE\RustDesk` 进行批量下发。验证信息：在 1.3.x 及后续版本中，客户端配置文件通常存储在 AppData\Roaming\RustDesk\config 目录下，迁移时可通过脚本替换其中的 'id-server' 字段，效率远高于手动输入。

数据库平滑挂载：保留地址簿与权限记录

如果您使用了 Pro 版本或自建了带数据库的开源管理后台，db.sqlite3 文件的迁移决定了您的地址簿是否会丢失。在迁移过程中，必须先停止 hbbs 服务，再进行数据库拷贝，否则极易导致 SQLite 文件损坏。排查细节：迁移后若发现登录报错，请检查文件所属用户组，确保运行 RustDesk 服务的账号（如 root 或 rustdesk 用户）拥有对数据库文件的读写权限（chmod 644）。此外，检查新服务器的时间同步（NTP）是否正常，若服务器时间与客户端偏差超过 60 秒，可能会导致 OIDC 登录或 Token 校验失效，这是 202604 周期内不少跨时区迁移用户遇到的隐蔽问题。

常见问题

搬迁后客户端提示‘Key 不匹配’，但我已经把新 Key 发给用户了，为什么还是连不上？

这是因为旧的连接记录缓存了旧服务器的指纹。最彻底的解决方法是在客户端设置中点击‘解锁网络设置’，清空旧的 Key 并重新输入。为了避免这种麻烦，迁移时应始终保留并物理移动原有的 id_ed25519 密钥文件，而不是生成新的。

新服务器部署完毕，状态显示 Ready，但远程画面卡在‘等待图像’怎么排查？

这种情况 90% 是由于 TCP 21117 端口（中继端口）被拦截。请检查新服务器的防火墙，并确认 hbbs 启动参数中指定的 ‘-r’ 地址是否为公网可达的 IP 或域名。如果该参数写成了 127.0.0.1，客户端将无法找到中继路径。

迁移后发现 Linux 受控端无法被唤醒，这和服务器迁移有关吗？

通常无关，这多半是由于 Wayland 桌面环境的兼容性问题。但在迁移背景下，请检查新服务器是否开启了强制加密。如果新服务器强制要求 Key 而旧客户端未配置，连接请求会被直接丢弃。建议先在服务器端临时去掉 ‘-k’ 参数进行交叉测试。

总结

遇到复杂的迁移故障？立即访问 RustDesk 官方下载页面获取最新版服务端工具，或查阅开发者文档获取更多技术支持。

相关阅读：RustDesk 迁移 常见问题与排查 202604，RustDesk 迁移 常见问题与排查 202604使用技巧，RustDesk 迁移 常见问题与排查 202604：跨服务器平滑过渡与连接异常深度修复