RustDesk 自托管指南：用 Rust 写的开源远程桌面，TeamViewer 替代方案！

TeamViewer、向日葵、ToDesk……几乎每一款主流的远程桌面工具都在朝"商业授权+按席位收费"的方向演进。RustDesk 反其道而行：用 Rust 写一个开源的远程桌面，既能直接用官方公共服务器，也能自托管一整套中继服务，所有连接在自己机器之间完成。

一、什么是 RustDesk？

RustDesk 是一款开源跨平台远程桌面软件，定位是"TeamViewer 的自托管替代方案"。客户端覆盖 Windows、macOS、Linux、iOS、Android、Web，服务端可自由部署在任何支持 Docker 的机器上。

• 服务端仓库：github.com/rustdesk/rustdesk-server

• 官方文档：rustdesk.com/docs/en/self-host

二、核心能力

• 跨平台：客户端支持主流桌面与移动系统，支持 Web 访问。

• 点对点优先：默认尝试 P2P 直连，仅在无法直连时才走中继。

• 端到端加密：通信默认加密，自托管后 ID 与公钥都在自己手中。

• 文件传输：支持双向文件拖拽、剪贴板同步。

• 自托管服务器：官方提供 hbbs + hbbr 两个服务，即可搭建一套完整的连接中继。

三、架构一览：hbbs + hbbr

自托管 RustDesk 服务端由两个进程组成，分别承担不同的角色：

一次连接大致流程：

   客户端 A                        客户端 B
      │                                │
      │  ① 注册 / 发现 → hbbs (21116)   │
      │                                │
      │  ②  尝试 P2P 直连 ←→            │
      │                                │
      │  ③ 直连失败时 → hbbr (21117)    │
      │     ↓↑ 中继转发 ↓↑               │

四、使用 Docker Compose 部署

官方仓库提供的 docker-compose.yml（示例域名需替换为你自己的）：

version: '3'

networks:
  rustdesk-net:
    external: false

services:
  hbbs:
    container_name: hbbs
    ports:
      - 21115:21115
      - 21116:21116
      - 21116:21116/udp
      - 21118:21118
    image: rustdesk/rustdesk-server:latest
    command: hbbs -r rustdesk.example.com:21117
    volumes:
      - ./data:/root
    networks:
      - rustdesk-net
    depends_on:
      - hbbr
    restart: unless-stopped

  hbbr:
    container_name: hbbr
    ports:
      - 21117:21117
      - 21119:21119
    image: rustdesk/rustdesk-server:latest
    command: hbbr
    volumes:
      - ./data:/root
    networks:
      - rustdesk-net
    restart: unless-stopped

启动：docker compose up -d。首次启动后，./data 目录下会生成一对密钥文件 id_ed25519 / id_ed25519.pub——客户端连接时需要 公钥。

五、防火墙与端口

公网使用时，请确保服务器上和云安全组同时放通：

• TCP：21115, 21116, 21117, 21118, 21119

• UDP：21116

六、客户端接入自托管服务器

1. 下载并安装 RustDesk 客户端。

2. 打开客户端 → 右上角菜单 → ID / 中继服务器。

3. 填写：

   • ID 服务器：your-server-ip（或域名）

   • Key：上一步 id_ed25519.pub 中的内容

4. 保存后，RustDesk 会重新连接到你的自托管服务器，此时得到的 ID 就是你自有中继网络中的唯一标识。

七、在 1Panel 上的部署

1Panel 应用商店提供了 RustDesk Server 的一键安装，自动创建 hbbs 与 hbbr 两个容器并完成端口映射，部署后可在面板"应用日志"中看到自动生成的公钥，复制给客户端即可使用。

👇 1Panel 官方地址

八、使用前需要注意

• 保管好密钥：id_ed25519（私钥）一旦泄露，任何人都能假冒你的中继服务器身份。

• 推荐使用 Pro 或 Oss 版本按需选择：本文使用的是官方开源 OSS 版本，若有 Web 控制台、用户体系、审计等需求，可评估 Rustdesk Server Pro。

• 中继流量费用：若服务器带宽较小，大量会话经 hbbr 中继时会消耗不少流量，建议让客户端尽量 P2P 直连。

参考链接

• RustDesk Server OSS 文档：https://rustdesk.com/docs/en/self-host/rustdesk-server-oss/

• 服务端 GitHub 仓库：https://github.com/rustdesk/rustdesk-server

• 官方 docker-compose.yml：rustdesk-server 仓库内