RustDesk 迁移 常见问题与排查 202604：自建服务器数据无缝转移实操

随着业务扩展或服务器到期，更换RustDesk自建服务器是许多用户必须面对的操作。然而，迁移并非简单的“复制粘贴”，稍有不慎就会导致客户端集体掉线。针对2026年4月最新版本的特性，我们梳理了新手在迁移过程中最容易踩坑的环节，并提供直接有效的排查方案。

核心数据迁移：如何保留原有设备ID与密码

迁移RustDesk服务器时，新手最怕的就是所有客户端的设备ID发生变化，导致需要重新记录连接信息。要保持ID不变，关键在于完整迁移旧服务器上的数据库文件。在Linux环境下，默认路径通常为 /opt/rustdesk/。你必须将 db_v2.sqlite（存储设备ID信息）和 id_ed25519、id_ed25519.pub（加密公私钥对）这三个核心文件打包传输到新服务器的相同路径下。如果在迁移后发现客户端提示“Key mismatch”，通常是因为漏传了公钥文件，或者新服务器的权限设置不正确（需确保属主为rustdesk运行用户）。

hbbr与hbbs服务启动失败的快速排查

在新服务器上部署并导入数据后，经常会遇到服务无法正常启动的情况。如果你使用的是Docker Compose部署（参考2026年4月官方推荐的1.2.4及以上版本镜像），请首先通过 docker logs hbbs 查看日志。一个极其常见的报错是“Failed to bind to 0.0.0.0:21116”，这通常意味着新服务器的防火墙未放行该端口，或者该端口被其他进程（如旧版残留服务）占用。新手排查时，请务必确认TCP和UDP的21116端口均已在云服务商的安全组及系统防火墙（如ufw或firewalld）中双向开放。

客户端重连异常：网络配置与缓存清理

服务器端配置完成后，部分客户端可能依然显示“未就绪”或一直处于“正在连接”状态。这往往是因为客户端本地缓存了旧服务器的DNS解析记录或旧的公钥配置。对于Windows客户端，建议进入 %appdata%\RustDesk\config 目录，删除 RustDesk.toml 文件中的旧网络配置后重启软件。另外，如果新服务器更换了IP但域名未变，请确保客户端所在网络的DNS缓存已刷新（可通过命令 ipconfig /flushdns 处理）。若依然连不上，请检查客户端网络设置中的“API服务器”地址是否已同步更新。

中继服务器（Relay）不生效的深度诊断

很多新手在迁移后发现，直连可以成功，但跨运营商的网络环境下连接极度卡顿，这说明中继服务（hbbr）未能正常工作。排查此问题时，首先要检查hbbs启动时是否正确携带了 -r 参数指向了新服务器的IP或域名（例如 hbbs -r relay.example.com:21117）。其次，在客户端的“网络设置”中，查看“中继服务器”一栏是否留空或填错了旧地址。如果使用Nginx进行反向代理转发，请务必确认Nginx配置中开启了TCP/UDP的Stream流转发模块，否则21117端口的流量将被直接丢弃，导致中继彻底失效。

常见问题

换了新服务器后，为什么被控端电脑一直提示“公钥不匹配”？

这是因为新服务器重新生成了 id_ed25519.pub 文件。你需要将旧服务器上的公私钥文件覆盖到新服务器，或者在所有被控端电脑的网络设置中，手动将“Key”字段更新为新服务器生成的公钥字符串。

数据库文件 db_v2.sqlite 拷贝过去后，服务直接崩溃怎么处理？

通常是文件权限问题引起的。如果是Linux系统，拷贝过去的文件可能属于root用户，而RustDesk服务以普通用户运行导致无法读取。请使用 chown 命令将该数据库文件的所有者修改为运行RustDesk程序的用户。

域名没变只换了IP，为什么部分远端设备死活连不上新节点？

远端设备可能存在DNS缓存，或者旧节点的TCP连接处于假死状态未断开。建议让远端设备彻底退出RustDesk进程（包括后台服务）并重启，同时检查新节点云服务器的UDP 21116端口是否真实放行。

总结

准备好体验更流畅的远程控制了吗？前往RustDesk官方网站下载最新版本客户端，获取更多关于自建服务器部署与迁移的官方技术文档！

相关阅读：RustDesk 迁移 常见问题与排查 202604，RustDesk 迁移 常见问题与排查 202604使用技巧，RustDesk 迁移 常见问题与排查 202604：自建服务器与客户端数据无缝转移指南