RustDesk 迁移 常见问题与排查 202604：解决自建 ID/Relay 服务器搬迁中的连接超时与密钥失效

服务器迁移不仅仅是更换一个 IP 地址，更是对 RustDesk 安全信任链的重新构建。如果您正处于更换云服务商或升级硬件的过程中，本指南将帮您避开那些导致“无法连接到网络”的隐形坑洞。

核心资产转移：密钥文件 id_ed25519 的决定性作用

在 RustDesk 迁移过程中，最常见的错误是仅安装了新服务而忽略了原始密钥。自建服务器在首次启动时会生成一对关键文件：id_ed25519 和 id_ed25519.pub。这对文件位于服务器的运行目录（通常是 /var/lib/rustdesk-server 或 Docker 挂载卷中）。如果您直接在新服务器上重新生成 Key，所有旧客户端将因为公钥不匹配而弹出“Key Mismatch”警告。正确的操作步骤是：先停止旧服务器进程，将这两个文件完整复制到新服务器的相同位置。202604 版本的服务端对安全性校验更加严格，若未同步密钥，您必须手动修改每一个受控端电脑上的 Key 配置，这在拥有数十台设备的场景下将是一场灾难。

网络层对齐：21115-21119 端口段的联通性验证

迁移后客户端显示“就绪”但无法发起连接，通常与防火墙策略有关。RustDesk 依赖五个关键端口：21115 (TCP) 用于心跳，21116 (TCP/UDP) 用于 ID 注册与打洞，21117 (TCP) 用于中继，21118/21119 则用于支持 Web 端的 WebSocket 协议。在 2026 年的云服务环境中，许多厂商默认关闭了 UDP 21116 端口。排查细节建议：使用命令 `nc -zuv 21116` 检查 UDP 是否通畅。如果您的迁移涉及从公网 IP 转向内网穿透环境，请务必在客户端的“ID/中继服务器”设置中，将 IP 地址后明确标注非标准端口，例如 `1.2.3.4:21116`，否则客户端会尝试默认端口导致连接超时。

Docker 容器环境下的数据卷无损搬迁实操

对于使用 Docker Compose 部署的新手，迁移的核心在于 `docker-compose.yml` 中的 volumes 映射。一个典型的错误场景是：在新服务器上直接执行 `docker-compose up -d`，这会创建一个空的数据库。真实排查案例显示，若不迁移 `db.sqlite3` 文件，虽然远程连接能通，但您之前设置的所有设备别名、标签和访问控制列表（ACL）都会消失。操作建议：在旧环境执行 `docker-compose down`，将整个挂载目录（如 ./data）打包压缩，传输至新服务器后再解压启动。请注意检查文件权限，确保容器内的 rustdesk 用户有权读取这些被迁移的文件，否则 hbbs 进程可能会因无法写入日志而反复重启。

客户端批量更新策略与 202604 版本兼容性

当服务端 IP 变更后，手动更新几十台受控端的配置显然不现实。针对 202604 期间的迁移，建议利用 RustDesk 的“配置导入”功能或修改配置文件。在 Windows 平台上，配置存储在 `AppData\Roaming\RustDesk\config\RustDesk.toml` 中。通过简单的脚本替换该文件中的 `id-server` 和 `relay-server` 字段，即可实现静默迁移。此外，需注意版本跨度问题，如果服务端升级到了 1.3.x 以上版本，而客户端仍停留在 1.1.x，可能会因为加密协议重构导致连接后黑屏。务必保持主控端与受控端的次要版本号一致，以获得最佳的流媒体传输效率。

常见问题

迁移服务器后，为什么客户端一直显示“正在连接到 RustDesk 网络”？

这通常是因为客户端仍在尝试连接旧 IP。请检查客户端设置中的“ID 服务器”地址是否已更新。如果使用了域名，请确认 DNS 解析已在全球范围内生效（TTL 可能导致延迟）。另外，请确认服务器端的 21116 UDP 端口已在安全组中开放，这是注册 ID 的关键通道。

我丢失了旧服务器的 id_ed25519 密钥，现在所有设备都连不上了怎么办？

如果密钥丢失且无法找回，您必须在新服务器生成新的 Key，并手动更新所有客户端。为了简化操作，您可以将新生成的 id_ed25519.pub 内容提取出来，重新分发给用户。建议未来开启“强制 Key 校验”前，先做好密钥的离线备份。

搬迁到新服务器后，远程操作明显感觉到延迟增加，如何排查？

首先检查新服务器的带宽上行限制。其次，利用 `ping` 命令测试客户端到新服务器的延迟。如果延迟正常但操作卡顿，可能是因为中继服务器（hbbr）未正常工作，导致连接被迫走低速中继。请检查客户端配置中“中继服务器”一栏是否正确填写了新服务器的地址或域名。

总结

获取最新版 RustDesk 官方工具及详细迁移文档，请访问我们的官方下载频道。

相关阅读：RustDesk 迁移 常见问题与排查 202604，RustDesk 迁移 常见问题与排查 202604使用技巧，RustDesk 迁移 常见问题与排查 202604：自建中继与配置同步实操手册