RustDesk常见问题解答（FAQ）：连接失败、服务器配置、速度优化等 20 问

连接类问题

Q1：主界面显示「未就绪」/ ID 为空？

说明客户端无法连接 ID 服务器：

1. 检查「设置」→「网络」中 ID 服务器地址是否正确；
2. 公共服务器高峰期可能拥堵，稍后重试或换自建服务器；
3. 检查本机代理软件是否拦截 UDP 21116 端口。

Q2：能 ping 通服务器但 RustDesk 连不上？

确认服务器放行了全部端口：TCP 21115-21119 与 UDP 21116。云服务器还需在控制台「安全组」中放行，仅系统防火墙放行不够。

Q3：连接时提示「Key 不匹配」？

服务端密钥已变更，客户端需要更新 Key 字段为新的 id_ed25519.pub 内容。

Q4：打洞失败、全程走中继很慢？

P2P 打洞失败常见于对称 NAT（运营商级 NAT、严格企业防火墙）：

1. 两端任一在家庭网络通常可直连；
2. 手机热点成功率高于公司网；
3. 无法改善时自建高带宽中继服务器。

Q5：macOS 被控只能看不能点？

需在「系统设置」→「隐私与安全性」授予「屏幕录制」「辅助功能」「输入监控」三项权限后重启 RustDesk。

Q6：Linux 连上后黑屏？

多为 Wayland 会话的捕获限制：切换到 X11 登录会话，或在「设置」中更换屏幕捕获方式；无桌面环境需安装虚拟显示。

服务器类问题

Q7：自建服务器需要多大配置？

1 核 1G VPS 即可支撑数十台设备注册；重点是带宽——中继流量全走服务器，720P 会话约需 2-4Mbps。

Q8：hbbs 和 hbbr 必须都装吗？

建议都装。hbbs 管注册与打洞，hbbr 负责打洞失败后的中继，只装 hbbs 会导致部分设备无法连接。

Q9：服务器重启后 RustDesk 服务没了？

Docker 部署确认 compose 里写了 restart: unless-stopped；二进制部署需配置 systemd 服务。

Q10：能把服务器从 IP 换成域名吗？

可以，客户端 ID 服务器填域名即可。建议一开始就用域名，日后迁移服务器不用改所有客户端。

性能类问题

Q11：画面卡顿怎么优化？

1. 「显示」设置中降低画质/帧率、关闭「显示远程光标」；
2. 两端切换更快的网络；
3. 自建服务器提升中继带宽；
4. 被控端关闭动态壁纸与高刷特效。

Q12：文件传输慢？

传输走服务器时受服务器带宽限制；同局域网会 P2P 直传，速度接近内网满速。

Q13：声音无法同步？

会话中开启声音图标；Linux 需 PulseAudio/PipeWire 正常工作；被控端检查系统输出设备。

Q14：多显示器怎么切换？

工具栏「显示器」菜单列出所有屏幕，可单独切换或拼接显示。

功能与配置类问题

Q15：如何设置无人值守固定密码？

「设置」→「安全」→「固定密码」，设置强密码并配合白名单使用。

Q16：如何限制只有特定设备能连我？

「安全」设置中配置 ID 白名单，或自建 hbbs 时用 -k _ 参数强制密钥校验。

Q17：RustDesk 完全免费吗？商用违规吗？

客户端与服务端均开源（GPL-3.0），个人与商用都可免费使用。GPL 要求：若修改并分发软件需开源修改；仅内部使用不受影响。

Q18：iOS 能被控制吗？

受系统限制 iPhone 不能被完整控制，可通过屏幕共享实现观看；iPad/Android 均可正常被控。

Q19：手机控制电脑怎么打字？

点击会话工具栏键盘图标唤起输入法；中文输入建议在被控端使用系统输入法，或开启「同步剪贴板」后粘贴。

Q20：和 ToDesk、TeamViewer 怎么选？

• 想自建服务器、开源可控：RustDesk；
• 国内开箱即用、省心：ToDesk；
• 跨国弱网、企业生态：TeamViewer。

快速排查表

总结

RustDesk 的问题大多集中在「服务器连接」与「系统权限」两类。掌握「未就绪先查网络、不能动先查权限、速度慢看是否走了中继」三条主线，配合本文排查表，绝大多数问题都能快速定位解决。