RustDesk 服务端完整安装部署教程
RustDesk 服务端完整安装部署教程（2025 版）
一、环境准备
1. 服务器要求
- 操作系统：Ubuntu 20.04/22.04（推荐）、Debian、CentOS 等
- 硬件配置：
- 测试环境：1 核 2G 以上
- 生产环境：2 核 4G+，50G + 存储空间
- 网络要求：公网 IP（如需外网访问）
2. 防火墙配置
开放 RustDesk 服务端所需端口：
# Ubuntu/Debiansudo ufw allow 21115:21119/tcp sudo ufw allow 21116/udp sudo ufw allow 8000/tcp # 用于客户端安装脚本sudo ufw enable# CentOSsudo firewall-cmd --permanent --add-port=21115-21119/tcp sudo firewall-cmd --permanent --add-port=21116/udp sudo firewall-cmd --permanent --add-port=8000/tcp sudo firewall-cmd --reload 二、安装 RustDesk 服务端
方法 1：官方一键安装脚本（推荐）
wget https://raw.githubusercontent.com/techahold/rustdeskinstall/master/install.sh chmod +x install.sh ./install.sh 安装步骤说明：
- 脚本会自动下载并安装：
hbbs：ID 服务器（负责设备注册和身份验证）hbbr：中继服务器（负责流量转发，当直连失败时使用）gohttpserver：配置分发服务（提供客户端安装包和配置）
- 安装过程中会提示选择连接方式：
- 输入
1：自动解析当前公网 IP（适合临时测试） - 输入
2：手动输入域名（需提前配置 DNS 解析）
- 输入
- 安装完成后，记录输出的公钥信息（如：
Your public key is），后续客户端配置需要使用
方法 2：手动安装（适用于自定义需求）
1. 下载二进制文件
wget https://github.com/rustdesk/rustdesk-server/releases/latest/download/hbbs wget https://github.com/rustdesk/rustdesk-server/releases/latest/download/hbbr chmod +x hbbs hbbr sudomv hbbs hbbr /usr/bin/ # 移动到系统路径2. 创建配置目录
sudomkdir -p /var/lib/rustdesk sudochown root:root /var/lib/rustdesk sudochmod755 /var/lib/rustdesk 3. 配置 systemd 服务
创建 hbbs.service（ID 服务器）：
sudonano /etc/systemd/system/hbbs.service 内容：
[Unit] Description=RustDesk ID Server (hbbs) After=network.target [Service] ExecStart=/usr/bin/hbbs -r /var/lib/rustdesk --relay-servers 127.0.0.1 WorkingDirectory=/var/lib/rustdesk Restart=always RestartSec=5 [Install] WantedBy=multi-user.target 创建 hbbr.service（中继服务器）：
sudonano /etc/systemd/system/hbbr.service 内容：
[Unit] Description=RustDesk Relay Server (hbbr) After=network.target [Service] ExecStart=/usr/bin/hbbr Restart=always RestartSec=5 [Install] WantedBy=multi-user.target 4. 启动服务
sudo systemctl daemon-reload # 重新加载 systemd 配置sudo systemctl enable hbbs hbbr # 设置开机自启sudo systemctl start hbbs hbbr # 启动服务sudo systemctl status hbbs hbbr # 检查服务状态三、客户端配置与连接
1. 获取客户端安装脚本
- 浏览器访问
http://服务器IP:8000 - 输入用户名
admin和密码 ``（安装时会显示） - 下载对应系统的客户端安装包（含预配置的服务器信息）
2. 手动配置客户端
- 打开 RustDesk 客户端，点击右上角齿轮图标 → “ID / 中继服务器”
- 配置以下信息：
- ID 服务器：填入服务器 IP 或域名
- 公钥：填入安装时生成的公钥（安装完成是打印上会显示）
- 点击 “保存”，重启客户端
四、验证与测试
1. 检查服务状态
sudo systemctl status hbbs hbbr # 确保两者均为 active (running)2. 查看服务日志
sudo journalctl -u hbbs -f # 实时查看 hbbs 日志sudo journalctl -u hbbr -f # 实时查看 hbbr 日志3. 客户端连接测试
- 在两台设备上安装并配置 RustDesk 客户端
- 使用设备 ID 互相连接，测试远程桌面功能
- 验证直连和中继模式是否正常工作
五、常见问题排查
1. 服务启动失败
错误现象：systemctl status hbbs 显示 active (auto-restart) 或报错
解决步骤：
验证服务配置语法：
sudo systemd-analyze verify hbbs.service 检查工作目录：
sudomkdir -p /var/lib/rustdesk sudochown root:root /var/lib/rustdesk sudochmod755 /var/lib/rustdesk 检查文件路径和权限：
sudofind / -name "hbbs"# 确认文件存在sudochmod +x /path/to/hbbs # 赋予执行权限2. 参数冲突问题
错误现象：The argument '--relay-servers <HOST>' was provided more than once
解决方法：
- 编辑
/etc/systemd/system/hbbs.service
重新加载并重启服务：
sudo systemctl daemon-reload sudo systemctl restart hbbs 确保ExecStart中 --relay-servers 参数只出现一次：
ExecStart=/usr/bin/hbbs -r /var/lib/rustdesk --relay-servers 127.0.0.1 六、进阶配置（可选）
1. 使用域名访问
- 在域名服务商处添加 A 记录，指向服务器公网 IP
- 安装时选择 “2) Enter your DNS/Domain”，输入域名
- 配置 SSL 证书（推荐使用 Caddy 自动配置）：
# 安装 Caddysudoaptinstall -y debian-keyring debian-archive-keyring apt-transport-https curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key'|sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt'|sudotee /etc/apt/sources.list.d/caddy-stable.list sudoapt update sudoaptinstall caddy # 创建 Caddyfile 配置sudonano /etc/caddy/Caddyfile Caddyfile 内容：
yourdomain.com { reverse_proxy * 127.0.0.1:8000 } 启动 Caddy 服务：
sudo systemctl enable caddy sudo systemctl start caddy 七、卸载方法
sudo systemctl stop hbbs hbbr gohttpserver sudo systemctl disable hbbs hbbr gohttpserver sudorm /etc/systemd/system/hbbs.service /etc/systemd/system/hbbr.service /etc/systemd/system/gohttpserver.service sudorm -rf /usr/bin/hbbs /usr/bin/hbbr /usr/bin/gohttpserver sudorm -rf /var/lib/rustdesk sudo systemctl daemon-reload 八、参考资源
- RustDesk 官方文档：https://rustdesk.com/docs/en/
- GitHub 仓库：https://github.com/rustdesk/rustdesk
- 社区支持：https://community.rustdesk.com/
