logo
icon

RustDesk Server

自建 RustDesk 远程桌面服务器:官方 hbbs/hbbr 中继与转发服务器,加上自制的 Rust API 与网页管理后台, 用于管理用户与设备。

template cover
部署次数1
发布者zeaburd1FG
创建于2026-08-06
标签
Remote DesktopNetworking

RustDesk Server

自建的 RustDesk 远程桌面服务器,部署内容包含:

  • hbbs / hbbr — 官方 RustDesk ID/中继服务器与转发服务器(rustdesk-server,GPL-3.0 许可)。
  • api — 自制 Rust API 服务器,负责用户/设备管理,数据存于 MySQL。
  • web — 网页管理后台(nginx + 静态 SPA),可管理用户、设备与通讯录。
  • mysql — API 服务器使用的数据库。

部署后设置

  1. 打开 https://<你的域名> 进入 web 管理后台,使用 api 服务环境变量中的 ADMIN_USER / ADMIN_PASS 登录(默认账号 admin,密码为自动生成的 ${PASSWORD},请到 api 服务的变量页查看)。
  2. hbbshbbr 服务的「网络」标签页,查看对外转发的主机与端口(hbbs 的 21115/21116,hbbr 的 21117)。 3.(可选,建议设置)hbbs/hbbr 使用原始 TCP/UDP,Zeabur 无法直接为其绑定域名——对外主机是裸 IP, 重新部署后可能变化。若你填写了 ID_SERVER_DOMAIN / RELAY_SERVER_DOMAIN,请为这两个域名分别新增 DNS A 记录,指向步骤 2 中查到的对外主机,之后下方端口就能通过固定域名连接,而不用裸 IP。
  3. 在 RustDesk 客户端「设置 → 网络」填入:
    • ID 服务器<ID_SERVER_DOMAIN,或 hbbs 对外主机>:<hbbs 21116 对外端口>
    • 中继服务器<RELAY_SERVER_DOMAIN,或 hbbr 对外主机>:<hbbr 21117 对外端口>
    • API 服务器https://<你的域名>web 服务会把 /api/ 反向代理到 api
    • Keyhbbs 首次启动时会自动生成一组 Ed25519 密钥对,并保存(id_ed25519.pub / id_ed25519)在自己的数据 volume 中。到 hbbs 服务打开 Shell(Zeabur 的 Shell / exec 功能), 执行 cat id_ed25519.pub 即可获取。必填——没有对应密钥的客户端会被拒绝连接。

安全提示

hbbs 首次启动时会自动生成自己的 Ed25519 密钥对,并保存在挂载的数据 volume 中,重启或重新部署 都不会丢失,也不需要任何手动设置。客户端必须使用对应的公钥(id_ed25519.pub,获取方式见上方) 才能向 hbbs 注册。

hbbr 不设置密钥即启动,这是 RustDesk 官方默认行为:因为客户端一开始就需要 hbbs 的密钥才能 注册连接,所以 hbbr 端不校验密钥。若你想让 hbbr 也校验中继密钥,可以把 hbbsid_ed25519 / id_ed25519.pub 复制到 hbbr 的数据 volume 中,并自行在 hbbr 的启动命令加上 -k <该密钥>

若要更换密钥,删除 hbbs 服务数据 volume 中的 id_ed25519 / id_ed25519.pub,重新启动 hbbs 即会自动生成新的密钥对。

许可