rustdesk自建服务需下载rustdesk-server-linux-amd64.zip,解压后将hbbs和hbbr移至/usr/local/bin并赋执行权限;用systemd配置rustdesk-hbbs.service(含-k指定私钥)和rustdesk-hbbr.service,启动并检查listening状态;必须生成密钥对(./hbbs -g)、严格设私钥权限,并开放21115/21116(tcp+udp)/21117端口。

hbbs 和 hbbr 怎么下载、启动并保持常驻
RustDesk 的自建服务由两个核心进程组成:hbbs(ID 注册服务器)和 hbbr(中继服务器),它们不依赖数据库或运行时环境,直接运行二进制即可。别被“Rust 编写”吓住——你不需要编译,官方已提供预编译包。
实操建议如下:
- 去 GitHub releases 页面 下载最新版
rustdesk-server-linux-amd64.zip(ARM 设备选-arm64或-armv7) - 解压后把
hbbs和hbbr移到/usr/local/bin/,加执行权限:sudo chmod +x /usr/local/bin/hbbs /usr/local/bin/hbbr - 不要直接前台运行,用
systemd管理更稳:创建/etc/systemd/system/rustdesk-hbbs.service,内容包含ExecStart=/usr/local/bin/hbbs -p 21115 -k your_private_key;同理配hbbr.service,端口设为21117 - 必须加
-k参数指定私钥,否则客户端无法注册 ID;密钥对需提前生成(见下节) - 启动后检查状态:
sudo systemctl start rustdesk-hbbs && sudo systemctl status rustdesk-hbbs,确认输出里有listening on 0.0.0.0:21115
私钥和公钥怎么生成,为什么不能跳过
所有 RustDesk 客户端连接你的服务器前,必须通过 hbbs 验证身份,而验证依赖非对称加密——hbbs 持有私钥,客户端用公钥加密握手请求。跳过这步等于开放匿名注册,任何人都能往你服务器上塞 ID,风险极大。
生成方式很简单,但位置和权限容易出错:
- 在服务器上运行:
./hbbs -g(注意是hbbs自带的生成命令,不是openssl) - 它会输出两段 Base64 字符串:
private key和public key,分别保存为/etc/rustdesk/private.key和/etc/rustdesk/public.key -
hbbs启动时用-k /etc/rustdesk/private.key加载;客户端设置里填入的是public key字符串(不是文件路径!) - 务必限制私钥权限:
sudo chmod 600 /etc/rustdesk/private.key && sudo chown root:root /etc/rustdesk/private.key - 常见错误:
hbbs启动报failed to load private key,基本是路径错、权限松、或复制时多了空格/换行
防火墙和云平台安全组要开哪些端口,UDP 必须开吗
必须开 21116 的 UDP,这是 RustDesk ID 注册和心跳保活的核心通道。只开 TCP 是很多连接“能显示 ID 但连不上”的根本原因。
完整端口清单(按实际必要性排序):
-
21115/tcp:NAT 类型探测,客户端首次连接时用来判断网络环境,必须开 -
21116/tcp+udp:ID 注册、登录、心跳维持,TCP 和 UDP 都得放行,缺一不可 -
21117/tcp:中继数据转发主端口,所有画面、键盘、鼠标流量走这里,必须开 -
21118/tcp和21119/tcp:仅用于网页版客户端(WebRTC),纯桌面用户可不开
操作提醒:
- Linux 本地防火墙(如
ufw或firewalld)要显式加/udp后缀,例如:sudo ufw allow 21116/udp - 云服务器(阿里云/腾讯云等)的安全组规则里,协议类型必须选“UDP”,不能只写“全部”或“TCP”
- 若用 Docker 部署,记得加
--publish 21116:21116/udp,Docker 默认只映射 TCP
客户端怎么填服务器地址,填错会有什么现象
Windows/macOS/Linux 客户端都统一在「设置 → 网络 → 自定义 ID 服务器」里填写。格式必须是:your-server-ip:21116(不含 http://,也不加路径)。
填错的典型表现:
- 填成
http://ip:21116或ip:21115:客户端卡在“正在连接…”几秒后提示“无法连接到 ID 服务器” - 填了域名但没配 DNS 或 HTTPS 证书:一样失败,RustDesk 不走 HTTP 协议,不校验证书
- 漏填
public key:客户端能连上服务器,也能生成 ID,但后续所有连接都会失败,日志里出现auth failed - 服务器 IP 填成内网地址(如
192.168.x.x):只有同局域网设备能连,外网客户端完全不可达
调试技巧:在客户端开启日志(设置里勾选「启用详细日志」),查看 rustdesk.log 文件末尾,重点找 register id server 和 auth response 相关行——这是最直接的故障定位依据。











