RustDesk Server 部署指南
开源远程桌面服务器,支持自托管,数据完全自主可控。包含信号服务器(hbbs)和中继服务器(hbbr),客户端支持 Windows、macOS、Linux、iOS、Android。
功能特性
- 自建信号服务器(hbbs)+ 中继服务器(hbbr)
- 端到端加密,数据不经过第三方
- 支持 TCP 打洞和中继转发
- 自动生成 Ed25519 密钥对
- 支持仅加密连接模式
- 跨平台客户端支持
- WebSocket 支持(可通过 Nginx 代理)
技术栈
| 组件 | 版本 | 说明 |
|---|---|---|
| RustDesk Server | latest | 信号服务器 + 中继服务器 |
| Nginx | 系统包 | 反向代理 + HTTPS(WebSocket) |
| Docker | 最新版 | 容器运行环境 |
端口说明
| 端口 | 协议 | 服务 | 说明 |
|---|---|---|---|
| 21115 | TCP | hbbs | NAT 类型测试 |
| 21116 | TCP | hbbs | TCP 打洞 / 连接请求 |
| 21116 | UDP | hbbs | ID 注册 / 心跳 |
| 21117 | TCP | hbbr | 中继流量转发 |
| 21118 | WS | hbbs | WebSocket(仅本地监听) |
| 21119 | WS | hbbr | WebSocket(仅本地监听) |
21115、21116、21117 需要从外网可访问,21118/21119 仅本地通过 Nginx 代理。
前置条件
- 一台 Linux 服务器(Ubuntu 22.04/24.04 推荐)
- 一个已解析到服务器的域名(如
rustdesk.example.com) - 服务器 80/443 端口可从外网访问
- 服务器 21115-21117 端口可从外网访问
目录结构
rustdesk/
├── docker-compose.yml # 容器编排(hbbs + hbbr)
├── .env.example # 配置模板
├── deploy.sh # 一键部署脚本
├── backup.sh # 备份脚本
├── uninstall.sh # 完全卸载脚本
├── nginx/
│ └── rustdesk.conf # Nginx 反向代理配置
└── README.md # 本文件
服务器上的数据目录:
/var/lib/rustdesk/ # RustDesk 数据(密钥对 + 数据库)
/var/backups/rustdesk/ # 备份文件
快速部署
第一步:上传文件到服务器
# 在本地执行,上传 rustdesk 目录
scp -r rustdesk/ root@<服务器IP>:/opt/rustdesk
# 如果服务器上还没有部署过 base(首台服务或全新服务器),还需上传 base
scp -r base/ root@<服务器IP>:/opt/base
第二步:登录服务器执行部署
ssh root@<服务器IP>
# 如果是全新服务器,先安装基础环境
cd /opt/base
cp .env.example .env
bash setup.sh
# 部署 RustDesk
cd /opt/rustdesk
bash deploy.sh
# 首次运行会生成 .env,按提示修改配置后重新运行
vi .env
bash deploy.sh
第三步:配置域名解析
在域名服务商(如阿里云 DNS)添加 A 记录:
| 记录类型 | 主机记录 | 记录值 |
|---|---|---|
| A | rustdesk | <服务器公网IP> |
第四步:配置 RustDesk 客户端
- 下载并安装 RustDesk 客户端
- 打开客户端,进入 设置 → 网络 → ID/中继服务器
- 填入以下信息:
| 配置项 | 值 |
|---|---|
| ID 服务器 | rustdesk.yourdomain.com |
| 中继服务器 | rustdesk.yourdomain.com |
| Key | 部署完成时显示的公钥 |
公钥获取方法: 部署脚本完成时会自动显示公钥,也可手动查看:
cat /var/lib/rustdesk/id_ed25519.pub
常用操作
# 查看服务状态
cd /opt/rustdesk && docker compose ps
# 查看日志
cd /opt/rustdesk && docker compose logs -f
# 重启服务
cd /opt/rustdesk && docker compose restart
# 停止服务
cd /opt/rustdesk && docker compose down
# 备份数据
cd /opt/rustdesk && bash backup.sh
# 查看公钥
cat /var/lib/rustdesk/id_ed25519.pub
# 更新镜像
cd /opt/rustdesk && docker compose pull && docker compose up -d
安全建议
- 默认开启
ENCRYPTED_ONLY=1,仅允许加密连接 - 密钥对文件(
id_ed25519/id_ed25519.pub)是最重要的数据,务必备份 - 如需更换密钥对,删除数据目录中的密钥文件后重启服务即可重新生成
- 建议定期执行
bash backup.sh并将备份异地存储