RustDesk 服务端完整安装部署教程

2. 创建配置目录

sudo mkdir -p /var/lib/rustdesk
sudo chown root:root /var/lib/rustdesk
sudo chmod 755 /var/lib/rustdesk

3. 配置 systemd 服务

创建 hbbs.service（ID 服务器）：

sudo nano /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（中继服务器）：

sudo nano /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. 获取客户端安装脚本

1. 浏览器访问 http://服务器 IP:8000
2. 输入用户名 admin 和密码（安装时会显示）
3. 下载对应系统的客户端安装包（含预配置的服务器信息）

2. 手动配置客户端

1. 打开 RustDesk 客户端，点击右上角齿轮图标 → 'ID / 中继服务器'
2. 配置以下信息：
   • ID 服务器：填入服务器 IP 或域名
   • 公钥：填入安装时生成的公钥（安装完成是打印上会显示）
3. 点击'保存'，重启客户端

四、验证与测试

1. 检查服务状态

sudo systemctl status hbbs hbbr # 确保两者均为 active (running)

2. 查看服务日志

sudo journalctl -u hbbs -f # 实时查看 hbbs 日志
sudo journalctl -u hbbr -f # 实时查看 hbbr 日志

3. 客户端连接测试

1. 在两台设备上安装并配置 RustDesk 客户端
2. 使用设备 ID 互相连接，测试远程桌面功能
3. 验证直连和中继模式是否正常工作

五、常见问题排查

1. 服务启动失败

错误现象：systemctl status hbbs 显示 active (auto-restart) 或报错

解决步骤：

验证服务配置语法：

sudo systemd-analyze verify hbbs.service

检查工作目录：

sudo mkdir -p /var/lib/rustdesk
sudo chown root:root /var/lib/rustdesk
sudo chmod 755 /var/lib/rustdesk

检查文件路径和权限：

sudo find / -name "hbbs" # 确认文件存在
sudo chmod +x /path/to/hbbs # 赋予执行权限

2. 参数冲突问题

错误现象：The argument '--relay-servers <HOST>' was provided more than once

解决方法：

1. 编辑 /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. 使用域名访问

1. 在域名服务商处添加 A 记录，指向服务器公网 IP
2. 安装时选择'2) Enter your DNS/Domain'，输入域名
3. 配置 SSL 证书（推荐使用 Caddy 自动配置）：

# 安装 Caddy
sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https curl
curl -fsSL 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg
curl -fsSL 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | sudo tee /etc/apt/sources.list.d/caddy-stable.list
sudo apt update
sudo apt install caddy

# 创建 Caddyfile 配置
sudo nano /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
sudo rm /etc/systemd/system/hbbs.service /etc/systemd/system/hbbr.service /etc/systemd/system/gohttpserver.service
sudo rm -rf /usr/bin/hbbs /usr/bin/hbbr /usr/bin/gohttpserver
sudo rm -rf /var/lib/rustdesk
sudo systemctl daemon-reload

八、参考资源

• RustDesk 官方文档：https://rustdesk.com/docs/en/
• GitHub 仓库：https://github.com/rustdesk/rustdesk
• 社区支持：https://community.rustdesk.com/