用 Docker 自建 RustDesk 远程桌面服务器(Ubuntu 实战)

RustDesk 是一款开源的远程桌面软件,可以看作 TeamViewer / 向日葵的开源替代。它默认走官方的公共服务器,在国内经常连不上或者画面卡顿。好在 RustDesk 的服务端也是开源的,只要有一台公网 Ubuntu 云服务器并装好 Docker,就能把中转服务换成自己的:速度更快,数据也不经过别人的机器。

全程大约 10 分钟。下面每一步都写了”为什么这么做”,可以边读边执行。

一、先搞懂:自建的到底是什么

RustDesk 服务端(开源版,简称 OSS 版)只有两个进程:

组件 全称 干什么 吃不吃带宽
hbbs ID / Rendezvous Server 客户端开机后来这里注册自己的 9 位 ID 并保持心跳;发起连接时由它撮合双方打洞(交换彼此的公网 IP:端口) 几乎不吃,只有信令
hbbr Relay Server 打洞失败时,把两端的加密流量原样转发 很吃,等于你在替他们跑流量

一次连接的完整过程:

1
2
3
4
5
6
7
8
控制端                      hbbs(信令)                     被控端
|---- 我要连 123456789 ---->| |
| |---- 有人找你,这是他的地址 -->|
|<--- 这是对方的地址 -------| |
| |
|========== ① 先尝试 P2P 直连(NAT 打洞)=================>| ← 成功了就不占服务器带宽
| |
|------- ② 打洞失败,改走中继 ---> hbbr ------------------>| ← 服务器带宽被占用

几个结论:

  • 大部分家庭/办公网络都能打洞成功,服务器带宽压力很小;
  • 但只要有一端在对称型 NAT(很多企业网、4G/5G 移动网络)后面,就必然走中继,这时云服务器的出网带宽就是画面流畅度的天花板。1 Mbps 的小水管扛不住远程桌面,建议至少 5 Mbps,或选按流量计费;
  • 传输是端到端加密的,hbbr 只搬密文,看不见你的屏幕内容。

另外还有 RustDesk Server Pro(闭源商业版),多了 Web 管理后台、用户体系、权限、审计、地址簿同步等。本文只讲免费开源版,个人和小团队够用了。

二、端口清单(最容易踩坑的地方)

九成的部署失败都是端口没放开,尤其是 UDP 21116。云厂商安全组默认只放 TCP,很多人只加了 TCP 规则,结果客户端永远显示”未就绪 / 正在连接服务器”。

端口 协议 归属 用途 能不能省
21115 TCP hbbs NAT 类型检测 建议放开
21116 UDP hbbs ID 注册与心跳(最关键!) ❌ 必须
21116 TCP hbbs TCP 打洞与连接服务 ❌ 必须
21117 TCP hbbr 中继数据转发 ❌ 必须
21118 TCP hbbs Web 客户端(WebSocket) 不用网页版可省
21119 TCP hbbr Web 客户端中继(WebSocket) 不用网页版可省
21114 TCP hbbs Web 管理后台,仅 Pro 版有 ✅ 开源版不用开

记住一句话:21115~21119 全放行,21116 的 TCP 和 UDP 都要放。

三、前置准备

1
2
3
4
5
6
7
8
9
# 1) 确认 Docker 与 Compose 插件可用(v2 是 "docker compose",中间是空格)
docker -v
docker compose version

# 若 compose 命令不存在,Ubuntu 上装官方插件:
# sudo apt update && sudo apt install -y docker-compose-plugin

# 2) 确认公网 IP(后面到处都要用)
curl -s https://ipinfo.io/ip; echo

关于域名(可选但推荐):直接用 IP 完全可以跑。但如果云服务器 IP 可能变化,或者以后想换机器,建议解析一个域名(如 rd.yourdomain.com 的 A 记录指向该 IP),客户端里填域名,将来换 IP 只改 DNS,不用挨个改客户端。

注意:hbbs/hbbr 走的是 RustDesk 自己的二进制协议,不是 HTTP,所以不需要 Nginx 反向代理,也不需要 SSL 证书。它自己用 NaCl / Ed25519 做端到端加密,套一层 Nginx 反而会把连接搞坏。

四、第一步:放行端口(安全组 + ufw)

有两道门,两道都要开。

4.1 云厂商安全组

在阿里云 / 腾讯云 / 华为云 / AWS 控制台,给这台实例的安全组加入方向规则:

协议 端口范围 源地址
TCP 21115-21119 0.0.0.0/0
UDP 21116 0.0.0.0/0

⚠️ 再强调一次:UDP 21116 是单独的一条规则,别只加 TCP。

4.2 服务器本机防火墙 ufw

1
2
3
4
5
6
7
8
9
10
11
12
# 先看 ufw 是否启用;显示 inactive 的话可以跳过本节
sudo ufw status

# 放行 RustDesk 所需端口
sudo ufw allow 21115:21119/tcp
sudo ufw allow 21116/udp

# 别把自己关在门外:确认 SSH 是通的
sudo ufw allow 22/tcp

sudo ufw reload
sudo ufw status numbered

五、第二步:部署服务

1
2
# 建工作目录(数据都放这儿,将来备份就备份这个目录)
sudo mkdir -p /opt/rustdesk && cd /opt/rustdesk

5.1 创建 docker-compose.yml

直接在服务器上粘贴执行:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
cat > /opt/rustdesk/docker-compose.yml <<'YAML'
networks:
rustdesk-net:
external: false

services:
# hbbs:ID 注册 + 打洞信令服务器
hbbs:
container_name: hbbs
image: rustdesk/rustdesk-server:latest
# ↓↓↓ 把 YOUR_SERVER_IP 换成你的公网 IP 或域名!全文最关键的一行 ↓↓↓
command: hbbs -r YOUR_SERVER_IP:21117 -k _
ports:
- 21115:21115 # TCP NAT 类型检测
- 21116:21116 # TCP 打洞 / 连接服务
- 21116:21116/udp # UDP ID 注册与心跳(最关键)
- 21118:21118 # TCP Web 客户端,不用网页版可删
volumes:
- ./data:/root # 密钥对 + 数据库
networks:
- rustdesk-net
depends_on:
- hbbr
restart: unless-stopped

# hbbr:中继转发服务器
hbbr:
container_name: hbbr
image: rustdesk/rustdesk-server:latest
command: hbbr -k _
ports:
- 21117:21117 # TCP 中继数据转发
- 21119:21119 # TCP Web 客户端中继,不用网页版可删
volumes:
- ./data:/root # 和 hbbs 共用同一份密钥
networks:
- rustdesk-net
restart: unless-stopped
YAML

# 一条命令把占位符替换成本机公网 IP(也可以手动 vim 改成域名)
sed -i "s/YOUR_SERVER_IP/$(curl -s https://ipinfo.io/ip)/" /opt/rustdesk/docker-compose.yml

# 确认替换成功
grep 'command: hbbs' /opt/rustdesk/docker-compose.yml

新版 Docker Compose 不再需要顶层的 version: 字段,写了反而会告警,所以这里省略了。

参数解释(重要):

  • -r YOUR_SERVER_IP:21117:hbbs 会把这个地址下发给客户端,告诉它们”打洞失败就去这里中继”。必须写公网可达的 IP 或域名,写成 127.0.0.1、hbbr、内网 IP 都会导致中继不可用。
  • -k _:启用密钥校验。_ 的意思是”从 /root/id_ed25519 读取密钥对,没有就自动生成一对”。加了它,只有填了正确 Key 的客户端才能用你的服务器;不加的话,任何知道你 IP 的人都能白嫖你的中继带宽。
  • ./data:/root:hbbs 和 hbbr 共用同一个 data 目录,这样两者读到的是同一对密钥,必须保持一致。

5.2 启动

1
2
3
4
cd /opt/rustdesk
docker compose up -d # 拉镜像并后台启动
docker compose ps # 两个容器都应是 Up 状态
docker compose logs -f # 看日志,Ctrl+C 退出(不会停服务)

正常日志大致长这样:

1
2
3
4
5
hbbs  | INFO [src/rendezvous_server.rs] Listening on tcp/udp :21116
hbbs | INFO [src/rendezvous_server.rs] Listening on tcp :21115(NAT test)
hbbs | INFO [src/rendezvous_server.rs] Listening on tcp :21118(website)
hbbs | INFO [src/rendezvous_server.rs] Start
hbbr | INFO [src/relay_server.rs] Listening on tcp :21117

六、第三步:取出公钥 Key

启动后 data/ 目录里会自动生成一对密钥:

1
2
3
4
5
6
7
ls -l /opt/rustdesk/data/
# id_ed25519 ← 私钥,绝不外传,别贴到群里 / 截图里
# id_ed25519.pub ← 公钥,就是客户端里要填的 "Key"
# db_v2.sqlite3 ← 设备数据库

# 打印公钥(一串 base64,别把多余的空格换行也复制进去)
cat /opt/rustdesk/data/id_ed25519.pub; echo

输出类似:OeVuKk5nlHiXp+APNn0Y3pC1Iwpwn44JGqrQCsWqmBw=,把这串字符复制下来,下一步要用。

七、第四步:客户端配置

每一台参与远程控制的电脑 / 手机都要配一遍,控制端和被控端都要。

从 GitHub Releases 下载对应平台的客户端,然后:

主界面 → 右上角 ⋮(三个点) → 网络(Network) → 点 解锁网络设置(可能要输入管理员密码)

填入:

字段 填什么 示例
ID 服务器 / ID Server 公网 IP 或域名(不带端口,默认就是 21116) 1.2.3.4 或 rd.yourdomain.com
中继服务器 / Relay Server 留空(hbbs 会自动下发 -r 里配的地址) 空
API 服务器 / API Server 留空(Pro 版才用) 空
Key 上一步 id_ed25519.pub 的内容 OeVuKk5n...mBw=

点 应用 / Apply,回到主界面,左下角状态灯应该在几秒内变成绿色「就绪 / Ready」。如果一直是「正在连接到 ID 服务器…」,直接看后面第十一节「常见问题排查」。

批量部署小技巧:把配置写进文件名

不想手动配几十台机器?RustDesk 支持从可执行文件名读取配置。把下载的 exe 重命名成这个格式,双击运行就自动带好配置:

1
rustdesk-host=1.2.3.4,key=OeVuKk5nlHiXp+APNn0Y3pC1Iwpwn44JGqrQCsWqmBw=.exe

⚠️ 坑:base64 公钥里可能出现 /,而 Windows 文件名不允许 /。如果你的 Key 含 /,这招就用不了——可以删掉 data/ 下的密钥、重启服务重新生成一对,直到公钥里不含 /(多试两次通常就有了)。前提是还没有客户端在用旧 Key。

八、第五步:验证是否真的走了自己的服务器

光看到「就绪」还不够,还要确认流量确实经过你的服务器:

1
2
3
4
5
6
7
cd /opt/rustdesk

# 1) 看 hbbs 日志有没有设备来注册(每台上线的机器都会打一条)
docker compose logs hbbs | tail -30

# 2) 看端口确实在监听
sudo ss -tulnp | grep -E '2111[5-9]'

在客户端确认连接方式:连上后,会话窗口顶部工具栏会显示连接类型。P2P / 直接连接(Direct) 表示打洞成功;中继(Relay) 表示走了你的 hbbr。两种都算部署成功,区别只是耗不耗服务器带宽。

从外部验证端口通不通(在自己电脑上执行):

1
2
3
4
5
6
# TCP 检测
nc -vz 1.2.3.4 21116
nc -vz 1.2.3.4 21117

# UDP 比较难测,可以试试(可能需要 sudo)
nc -vzu 1.2.3.4 21116

九、安全加固

9.1 必做:保持 -k _

上面的配置里已经加了。不开密钥校验,等于你的中继服务器对全网开放,迟早被扫描到并白嫖带宽。私钥 id_ed25519 不要泄露。

9.2 可选:限制中继带宽

在 hbbr 服务下加环境变量,防止流量被跑爆:

1
2
3
4
5
6
hbbr:
# ...
environment:
- SINGLE_BANDWIDTH=64 # 单条中继连接上限 Mb/s(默认 128)
- TOTAL_BANDWIDTH=512 # 全部连接合计上限 Mb/s(默认 1024)
- LIMIT_SPEED=32 # 触发降级后的单连接限速 Mb/s(默认 32)

按流量计费的云主机尤其建议设置,否则一次异常就可能烧掉不少钱。

9.3 可选:限制来源 IP

如果只在固定几个办公地点使用,可以把安全组的源地址从 0.0.0.0/0 收窄成公司的出口 IP 段,安全性提升一大截。

9.4 可选:强制全部走中继

某些场景(比如不希望客户端之间暴露真实 IP)可以禁用 P2P:

1
2
3
hbbs:
environment:
- ALWAYS_USE_RELAY=Y

代价是所有流量都吃服务器带宽,慎用。

十、日常运维:升级、备份、日志

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
cd /opt/rustdesk

# —— 查看状态与日志 ——
docker compose ps
docker compose logs -f hbbs # 只看 hbbs
docker compose logs --tail=100 hbbr

# —— 升级到最新版 ——
docker compose pull # 拉取新镜像
docker compose up -d # 用新镜像重建容器(data 目录不受影响,Key 不变)
docker image prune -f # 清理旧镜像释放磁盘

# —— 重启 / 停止 ——
docker compose restart
docker compose down # 停止并删除容器(数据仍在 ./data)

# —— 备份(关键!Key 丢了所有客户端都要重配)——
tar czf ~/rustdesk-backup-$(date +%F).tar.gz -C /opt/rustdesk data docker-compose.yml

备份里最重要的是 data/id_ed25519 和 id_ed25519.pub。 只要这对密钥还在,即使换服务器重装,客户端也不用改配置(前提是 IP / 域名不变——这也是推荐用域名的原因)。

十一、常见问题排查

客户端一直「正在连接到 ID 服务器…」,状态灯不变绿

按顺序排查:

  1. UDP 21116 没放行:出现频率第一名。检查云厂商安全组里是否有单独一条 UDP 21116 规则。
  2. 容器没起来:docker compose ps 看是不是 Up;docker compose logs 看有无报错。
  3. Key 填错:复制时带了换行 / 空格,或者复制成了私钥。重新 cat id_ed25519.pub 复制。
  4. ID 服务器地址写错:只填 IP / 域名即可,不要乱加端口。
  5. 本机 ufw 拦了:sudo ufw status 确认规则已生效。

显示「就绪」,但连接对方时提示 Key 不匹配 / 未授权

两端客户端填的 Key 必须完全一致,且等于服务器 id_ed25519.pub 的内容。如果中途删过 data 目录,密钥会重新生成,所有客户端都要更新 Key。

连上了但画面很卡、延迟高

先确认是不是走了中继(会话工具栏看 P2P / Relay)。如果是中继,瓶颈就在云服务器的出网带宽,解决方向:

  • 升级带宽,或换成按量计费;
  • 客户端画质调成「平衡」或「低画质」,降低帧率;
  • 让至少一端处于能打洞的网络(家宽通常可以,企业网 / 4G 常常不行)。

始终打不了洞,全走中继

先试试 host 网络模式,排除 Docker NAT 的干扰。默认的 bridge 网络绝大多数情况没问题,但如果服务器上有特殊的 iptables 规则或网络插件(Tailscale、K3s 等),可能会影响源地址。host 模式下容器直接使用宿主机网络栈,不做端口映射,源 IP 原样保留,打洞成功率最高;代价是没有网络隔离,而且 Windows / macOS 的 Docker 不支持。

新建 /opt/rustdesk/docker-compose.host.yml:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
services:
hbbs:
container_name: hbbs
image: rustdesk/rustdesk-server:latest
command: hbbs -r YOUR_SERVER_IP:21117 -k _ # ← 改成你的公网 IP/域名
network_mode: host # 直接用宿主机网络,无需 ports 映射
volumes:
- ./data:/root
depends_on:
- hbbr
restart: unless-stopped

hbbr:
container_name: hbbr
image: rustdesk/rustdesk-server:latest
command: hbbr -k _
network_mode: host
volumes:
- ./data:/root
restart: unless-stopped

切换过去:

1
2
3
cd /opt/rustdesk
docker compose down
docker compose -f docker-compose.host.yml up -d

还是不行的话,多半是双方网络本身就是对称型 NAT,属于物理限制,只能走中继。

docker compose 命令不存在

老版本是 docker-compose(带横杠)。建议装官方 v2 插件:

1
sudo apt update && sudo apt install -y docker-compose-plugin

端口被占用 bind: address already in use

1
2
3
sudo ss -tulnp | grep 2111       # 找出占用者
docker ps -a # 可能是之前残留的 rustdesk 容器
docker rm -f hbbs hbbr # 删掉重来

十二、进阶选项

修改默认端口

如果 21116 被运营商封了,可以用 -p 改主端口,其它端口会跟着偏移:比如 hbbs -p 31116,NAT 检测口就变成 31115、Web 口变成 31118,中继要相应改成 hbbr -p 31117,-r 参数也改成 :31117。客户端的 ID 服务器要写成 1.2.3.4:31116。别忘了同步改安全组、ufw 和 compose 里的端口映射。

Web 客户端

保留 21118 / 21119 两个端口后,可以用官方网页版 https://rustdesk.com/web/ 连接自己的服务器。不需要网页版的话,这两个端口直接删掉即可。

升级到 Pro 版

需要 Web 管理后台、多用户权限、地址簿同步、登录审计、设备分组时,可以考虑官方 RustDesk Server Pro(镜像 rustdesk/rustdesk-server-pro,额外用 21114 端口做 Web 控制台)。配置方式与本文类似,只是客户端多一个 API Server 地址要填。

附:一键部署脚本

把第四~六步串成一个脚本,保存为 deploy.sh:

1
2
sudo bash deploy.sh                 # 自动检测公网 IP
sudo bash deploy.sh rd.your.com # 或指定域名(推荐)

脚本会检查依赖、生成 compose 文件(已有的会先备份)、放行 ufw、启动服务,最后直接把客户端要填的内容打印出来。它管不了云厂商安全组,那一步必须自己去控制台加。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
#!/usr/bin/env bash
# RustDesk 自建服务器 —— 一键部署脚本(Ubuntu + Docker)
set -euo pipefail

WORKDIR="/opt/rustdesk"

info() { printf '\033[1;32m[✔]\033[0m %s\n' "$*"; }
warn() { printf '\033[1;33m[!]\033[0m %s\n' "$*"; }
die() { printf '\033[1;31m[✘]\033[0m %s\n' "$*" >&2; exit 1; }

# 0. 权限检查
[ "$(id -u)" -eq 0 ] || die "请用 root 运行:sudo bash $0"

# 1. 依赖检查:v2 插件 "docker compose" 或老版 "docker-compose"
command -v docker >/dev/null 2>&1 || die "未找到 docker,请先安装 Docker"
if docker compose version >/dev/null 2>&1; then
DC="docker compose"
elif command -v docker-compose >/dev/null 2>&1; then
DC="docker-compose"
warn "检测到旧版 docker-compose,建议升级:apt install -y docker-compose-plugin"
else
die "未找到 Docker Compose,请执行:apt update && apt install -y docker-compose-plugin"
fi

# 2. 确定对外地址:优先用参数(域名),否则探测公网 IP
if [ "$#" -ge 1 ] && [ -n "${1:-}" ]; then
SERVER_ADDR="$1"
else
SERVER_ADDR="$(curl -fsS --max-time 10 https://ipinfo.io/ip 2>/dev/null || true)"
[ -n "$SERVER_ADDR" ] || die "自动探测公网 IP 失败,请手动指定:sudo bash $0 <你的IP或域名>"
fi
info "对外地址:$SERVER_ADDR"

# 3. 生成 docker-compose.yml(已存在则先备份)
mkdir -p "$WORKDIR/data"
if [ -f "$WORKDIR/docker-compose.yml" ]; then
cp "$WORKDIR/docker-compose.yml" "$WORKDIR/docker-compose.yml.bak.$(date +%s)"
warn "已备份原有 docker-compose.yml"
fi

cat > "$WORKDIR/docker-compose.yml" <<YAML
networks:
rustdesk-net:
external: false

services:
hbbs:
container_name: hbbs
image: rustdesk/rustdesk-server:latest
command: hbbs -r ${SERVER_ADDR}:21117 -k _
ports:
- 21115:21115
- 21116:21116
- 21116:21116/udp
- 21118:21118
volumes:
- ./data:/root
networks:
- rustdesk-net
depends_on:
- hbbr
restart: unless-stopped

hbbr:
container_name: hbbr
image: rustdesk/rustdesk-server:latest
command: hbbr -k _
ports:
- 21117:21117
- 21119:21119
volumes:
- ./data:/root
networks:
- rustdesk-net
restart: unless-stopped
YAML
info "已生成 $WORKDIR/docker-compose.yml"

# 4. 放行本机防火墙(ufw 启用时)
if command -v ufw >/dev/null 2>&1 && ufw status 2>/dev/null | grep -q "Status: active"; then
ufw allow 21115:21119/tcp >/dev/null
ufw allow 21116/udp >/dev/null
info "ufw 已放行 21115-21119/tcp 与 21116/udp"
else
warn "ufw 未启用或未安装,跳过本机防火墙配置"
fi

# 5. 启动服务
cd "$WORKDIR"
info "正在拉取镜像并启动(首次可能需要几分钟)..."
$DC pull
$DC up -d

# 等待 hbbs 写出公钥
for _ in $(seq 1 30); do
[ -s "$WORKDIR/data/id_ed25519.pub" ] && break
sleep 1
done

# 6. 输出结果
$DC ps
if [ -s "$WORKDIR/data/id_ed25519.pub" ]; then
KEY="$(cat "$WORKDIR/data/id_ed25519.pub")"
else
KEY="(尚未生成,请稍后执行: cat $WORKDIR/data/id_ed25519.pub)"
fi

cat <<TXT

==================== 部署完成,客户端这样填 ====================
ID 服务器 (ID Server) : ${SERVER_ADDR}
中继服务器 (Relay Server) : 留空
API 服务器 (API Server) : 留空
Key : ${KEY}
================================================================

【必做】去云厂商控制台的安全组放行:
TCP 21115-21119
UDP 21116 ← 单独一条规则,最容易漏!
TXT

参考资料


用 Docker 自建 RustDesk 远程桌面服务器(Ubuntu 实战)
http://eevann.cn/2026/09/24/rustdesk-self-host/
作者
月下独白
发布于
2026年9月24日
许可协议