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 docker -v docker compose version 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 sudo ufw statussudo ufw allow 21115:21119/tcpsudo ufw allow 21116/udpsudo ufw allow 22/tcpsudo ufw reloadsudo 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: container_name: hbbs image: rustdesk/rustdesk-server:latest command : hbbs -r YOUR_SERVER_IP: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 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 docker compose logs -f
正常日志大致长这样:
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/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 docker compose logs hbbs | tail -30sudo ss -tulnp | grep -E '2111[5-9]'
在客户端确认连接方式 :连上后,会话窗口顶部工具栏会显示连接类型。P2P / 直接连接(Direct) 表示打洞成功;中继(Relay) 表示走了你的 hbbr。两种都算部署成功,区别只是耗不耗服务器带宽。
从外部验证端口通不通 (在自己电脑上执行):
1 2 3 4 5 6 nc -vz 1.2.3.4 21116 nc -vz 1.2.3.4 21117 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 - TOTAL_BANDWIDTH=512 - LIMIT_SPEED=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 docker compose logs --tail =100 hbbr docker compose pull docker compose up -d docker image prune -f docker compose restart docker compose down tar czf ~/rustdesk-backup-$(date +%F).tar.gz -C /opt/rustdesk data docker-compose.yml
备份里最重要的是 data/id_ed25519 和 id_ed25519.pub。 只要这对密钥还在,即使换服务器重装,客户端也不用改配置(前提是 IP / 域名不变——这也是推荐用域名的原因)。
十一、常见问题排查 客户端一直「正在连接到 ID 服务器…」,状态灯不变绿 按顺序排查:
UDP 21116 没放行 :出现频率第一名。检查云厂商安全组里是否有单独一条 UDP 21116 规则 。
容器没起来 :docker compose ps 看是不是 Up;docker compose logs 看有无报错。
Key 填错 :复制时带了换行 / 空格,或者复制成了私钥。重新 cat id_ed25519.pub 复制。
ID 服务器地址写错 :只填 IP / 域名即可,不要乱加端口。
本机 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 _ network_mode: host 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 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 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 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; } [ "$(id -u) " -eq 0 ] || die "请用 root 运行:sudo bash $0 " 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 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 " 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" 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 cd "$WORKDIR " info "正在拉取镜像并启动(首次可能需要几分钟)..." $DC pull$DC up -dfor _ in $(seq 1 30); do [ -s "$WORKDIR /data/id_ed25519.pub" ] && break sleep 1done $DC psif [ -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
参考资料