RustDesk 迁移 常见问题与排查 202604：自建服务器 ID/Relay 搬迁实战指南

在进行 RustDesk 自建环境迁移时，许多用户会发现仅仅复制二进制文件并不能保证服务的一致性。无论是更换了云服务商，还是从物理机迁移至 Docker 容器，环境的变迁往往伴随着网络拓扑和权限校验的变化。本指南将聚焦 202604 版本的核心逻辑，手把手教你如何规避迁移陷阱。

密钥对一致性：规避“Key Mismatch”连接拒绝

在 RustDesk 的安全架构中，`id_ed25519` 和 `id_ed25519.pub` 这对密钥是自建服务器的“身份证”。许多新手在迁移时只关注了 hbbs 程序的运行，却忽略了这两个隐藏文件。若新服务器启动时未检测到旧密钥，它会自动生成一组新密钥，导致所有已配置旧 Key 的客户端弹出“密钥不匹配”错误。排查细节：请务必在停止旧服务后，将运行目录下的所有 `.pub` 和无后缀密钥文件完整传输至新服务器对应的 `/root` 或 Docker 挂载目录中。通过命令 `cat id_ed25519.pub` 确认字符串是否与客户端设置中的 Key 完全一致，这是确保迁移后无需逐个修改客户端配置的关键步骤。

网络拓扑重构：ID 服务器与中继参数的精准修正

迁移往往伴随着公网 IP 的变更。在 202604 版本的生产环境中，若你使用了 `-r` 参数指定中继服务器地址，必须同步更新 hbbs 的启动指令。真实场景：某用户从阿里云迁移至腾讯云后，虽然修改了客户端的 ID 服务器地址，但由于 hbbs 启动脚本中硬编码了旧的 `-r 1.2.3.4`（旧 IP），导致客户端在尝试打洞失败转中继时彻底断连。正确的做法是：在新环境下使用域名替代固定 IP，或者在启动命令中动态指定 `-r :21117`。同时，利用 `netstat -tunlp` 检查 21115-21119 端口是否已在防火墙和安全组中全量放行，尤其是 UDP 21116 端口的连通性直接决定了 ID 解析的成败。

Docker 挂载权限陷阱：解决重启后配置丢失问题

对于偏好 Docker 部署的新手，迁移中最常见的排查点在于数据卷（Volume）的读写权限。RustDesk 容器在启动时需要向挂载目录写入 `db.sqlite3` 数据库文件以记录设备 ID。如果迁移后的目标目录权限为 root 且容器以非 root 用户运行，会导致服务看似启动成功，但无法保存任何新连接记录。可验证信息：检查容器日志，若出现 `database is locked` 或 `permission denied` 报错，请执行 `chmod 777` 临时测试或 `chown -R 1000:1000`（对应容器内用户 UID）进行修复。确保 Docker Compose 文件中的 `volumes` 路径指向的是包含旧密钥文件的绝对路径，否则每次容器重启都会导致 ID 刷新，令迁移失去意义。

连接质量评估：迁移后的延迟抖动与路由追踪

迁移完成后，不能仅以“能连上”作为标准。建议通过 RustDesk 客户端右下角的“连接信息”查看当前状态。如果显示为“中继连接（Relay）”而非“直接连接（Direct）”，且延迟明显高于迁移前，需排查新服务器的 MTU 值或运营商对 UDP 包的 QOS 限制。针对 2026 年复杂的跨网环境，建议在 hbbs 启动参数中加入 `-m` 强制开启多路径探测。若发现特定地区连接缓慢，可通过 `mtr -u ` 追踪数据包在哪个节点出现丢包。通常情况下，迁移至 BGP 线路的机房能显著改善电信与联通用户之间的互联体验，解决迁移后偶发的画面撕裂问题。

常见问题

搬迁服务器后，为什么我的设备 ID 列表全部变为空白了？

这是因为你没有迁移 `db.sqlite3` 数据库文件。RustDesk 的设备别名和历史记录存储在该 SQLite 文件中。请将旧服务器运行目录下的数据库文件覆盖至新服务器同名位置，并重启 hbbs 服务即可找回列表。

我已经放行了所有 TCP 端口，为什么迁移后客户端依然提示‘未就绪’？

RustDesk 的心跳检测和打洞主要依赖 UDP 21116 端口。很多新手只记得开启 TCP 端口，请务必在云控面板和系统防火墙（如 ufw 或 iptables）中双向放行 21116 的 UDP 协议。

迁移到新服务器后，如果不配置 Key 密钥会有什么安全风险？

如果不配置 Key（即不使用加密访问），任何知道你服务器 IP 的人都可以通过你的 ID 服务器进行中转，这会消耗你的带宽并存在中间人攻击风险。建议迁移后立即在客户端填入新生成的 `id_ed25519.pub` 内容，强制开启加密连接。

总结

若在迁移过程中遇到更复杂的网络环境问题，请访问 RustDesk 官方下载页面获取 2026 最新版排错工具，或查阅官方中文文档获取更多技术支持。

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