2026-06-05 常见问题

RustDesk 迁移常见问题与排查 202606：自建服务器与客户端配置无缝迁移指南

针对截至2026年06月最新的RustDesk稳定版，本文详细梳理了在服务器迁移和客户端配置迁移过程中的常见问题与排查方法。无论您是从旧服务器迁移到新IP，还是在Windows与macOS系统间迁移客户端配置，本文都提供了具体的配置文件路径与密钥迁移步骤，帮助新手用户快速实现跨终端的平滑过渡，避免迁移后连接失败或ID变更。

随着业务调整或设备更新，将 RustDesk 客户端配置及自建 ID/Relay 服务器迁移到新环境是常见需求。为了确保迁移后远程连接不中断、设备ID不丢失，本文将针对截至2026年06月的最新稳定版，为您提供详尽的迁移步骤与排查方案。

一、客户端配置文件与设备ID的备份与迁移

在迁移 RustDesk 客户端时，用户最关心的是如何保留原有的设备 ID 和安全设置。在 Windows 系统中，RustDesk 的核心配置文件通常存放在 AppData 目录下的 Roaming\RustDesk\config 中，主要包括 RustDesk2.toml 以及用于身份验证的私钥文件 id_ed25519。迁移时，您只需在新电脑上安装好官方客户端，然后将这些备份文件覆盖到对应的目录下即可。对于 macOS 用户，该路径则位于 Library/Application Support/com.carriez.rustdesk/config。导入后重启 RustDesk 服务，即可无缝继承原有的设备 ID 和历史连接记录。

二、自建 ID 与 Relay 服务器的平滑迁移步骤

迁移自建的 RustDesk Server（hbbs 和 hbbr）时，最关键的是保持公钥（Key）的一致性。如果在新服务器上重新生成了 Key，所有未更新配置的客户端将无法连接。具体操作中，您需要将旧服务器运行目录下的 id_ed25519.pub（公钥）和 id_ed25519（私钥）完整复制到新服务器的对应目录下。启动新服务时，确保携带密钥校验参数。截至2026年06月，最新版服务端依然严格依赖这对密钥来加密通信。完成文件复制后，再将域名的 DNS 解析指向新服务器 IP，即可实现客户端无需修改设置的无缝过渡。

三、迁移后“未就绪，请检查网络设置”故障排查

迁移完成后，最常见的故障是客户端状态栏显示“未就绪，请检查网络设置”。这通常由两个原因引起：一是防火墙端口未开放，二是客户端缓存了旧的 IP 解析。自建服务器迁移需要确保新服务器防火墙已放行 TCP 端口 21115、21116、21117、21118、21119，以及 UDP 端口 21116。您可以使用端口扫描工具测试连通性。如果使用了域名解析，由于 DNS 缓存延迟，客户端可能仍在尝试连接旧 IP。此时可以在客户端的“网络”设置中，临时将域名直接替换为新服务器的公网 IP 进行测试，以快速定位是网络问题还是解析延迟。

四、跨平台迁移中的权限与服务启动问题

从 Windows 7 或更高版本迁移到 macOS 等其他平台时，新手用户常遇到服务未运行或无法控制的问题。在 macOS 上完成配置迁移后，必须在“系统设置”的“安全性与隐私”中，为 RustDesk 授予“辅助功能”和“屏幕录制”权限，否则主控端连接后将只能观看而无法操作。此外，如果迁移后发现 RustDesk 服务无法随系统自启，Windows 用户可以通过任务管理器或运行 services.msc，检查 RustDesk Service 是否处于自动运行状态。确保客户端版本与服务器版本兼容，建议直接前往官网下载中心获取最新稳定版客户端，以获得最佳的跨平台协同体验。

常见问题

迁移到新服务器后，为什么客户端输入正确的ID和密码却一直显示“正在连接”？

这通常是因为新旧服务器的 id_ed25519.pub 密钥不一致。如果新服务器自动生成了新的密钥，而客户端的“网络设置”中仍填写的旧 Key，或者根本没有填写 Key，就会导致握手失败。请检查新服务器上的公钥内容，并同步更新客户端的 Key 配置，或者直接将旧服务器的密钥文件迁移至新服务器。

我只想迁移受控端列表和历史连接记录，需要拷贝哪些特定文件？

您只需要备份并迁移 peers 文件夹以及 RustDesk_local.toml 配置文件。这些文件记录了您的常用设备列表、别名以及历史连接的临时密码。将其覆盖到新设备的 RustDesk 配置目录下，重新运行软件即可看到原有的设备列表。

自建服务器 IP 变了，但我不想逐个修改几百台客户端的配置，有什么简便方法？

最佳实践是在首次配置时就使用域名（例如 rustdesk.yourdomain.com）代替 IP 填写在客户端的“ID服务器”栏中。这样在迁移服务器时，您只需要在域名解析商处将该域名指向新的服务器 IP，客户端无需做任何修改，等待 DNS 解析生效后即可自动连接到新服务器。

总结

立即访问 [RustDesk官网](/) 获取跨终端全平台远程协同方案。若需部署或更新客户端，请前往 [RustDesk下载中心](/download/) 获取支持 Windows 7 及以上版本的最新稳定版客户端。您也可以查看 [RustDesk功能特性](/features/) 与 [功能场景矩阵](/matrix/)，快速了解最新版的核心能力与配置方向。

RustDesk 迁移 常见问题与排查 202606：自建服务器与客户端配置无缝迁移指南