liuqianglunji/rustdesk-server

RustDesk Server Docker镜像文档

镜像概述

本镜像为RustDesk自托管服务器组件，用于搭建私有远程桌面服务。通过运行hbbs（ID注册服务器）和hbbr（中继服务器）两个容器，实现设备间的远程控制功能，支持PC与手机跨平台控制，所有通信通过加密密钥保障安全性。

核心功能与特性

• 双组件架构：包含hbbs（ID注册服务器）和hbbr（中继服务器），协同实现远程连接
• 加密通信：hbbs首次运行自动生成密钥对（id_ed25519和id_ed25519.pub），保障数据传输安全
• 跨平台支持：兼容PC和手机客户端，支持双向控制（PC控制PC、手机控制PC等）
• 持久化存储：通过卷挂载实现配置和密钥文件的持久化
• 端口可控：明确的端口映射规则，支持防火墙配置

使用场景

• 企业内部远程技术支持
• 个人设备跨平台远程控制
• 私有网络环境下的设备管理
• 对数据隐私有较高要求的远程协作场景

使用方法

1. 拉取镜像

bash
docker pull liuqianglunji/rustdesk-server:latest

2. 准备目录与权限

在宿主机创建数据目录并设置读写权限（以软路由为例）：

bash
# 创建hbbs和hbbr数据目录
mkdir -p /opt/docker/rustdesk/hbbs /opt/docker/rustdesk/hbbr

# 设置目录权限（7777表示完全读写权限）
chmod -R 7777 /opt/docker/rustdesk

注意：/opt/docker/rustdesk路径可替换为自定义路径，后续命令需同步修改

3. 部署hbbs容器

bash
docker run --name hbbs \
  -p 21115:21115 \
  -p 21116:21116 \
  -p 21116:21116/udp \
  -p 21118:21118 \
  -v /opt/docker/rustdesk/hbbs:/root \
  -td --net=host \
  rustdesk/rustdesk-server hbbs -r XXXXXXXX:21116

参数说明：

• --name hbbs：容器名称
• 端口映射：21115（TCP）、21116（TCP/UDP）、21118（TCP）
• -v /opt/docker/rustdesk/hbbs:/root：挂载hbbs数据目录（密钥文件将生成于此）
• --net=host：使用主机网络模式
• hbbs -r XXXXXXXX:21116：启动hbbs服务，XXXXXXXX需替换为实际外网域名

4. 部署hbbr容器

bash
docker run --name hbbr \
  -p 21117:21117 \
  -p 21119:21119 \
  -v /opt/docker/rustdesk/hbbr:/root \
  -td --net=host \
  rustdesk/rustdesk-server hbbr

参数说明：

• --name hbbr：容器名称
• 端口映射：21117（TCP）、21119（TCP）
• -v /opt/docker/rustdesk/hbbr:/root：挂载hbbr数据目录

5. 防火墙配置

在软路由防火墙中开放以下端口：

• 协议：TCP+UDP
• 端口范围：21115-21119
• 规则名称：rustdesk

配置完成后保存并应用规则，然后启动hbbs和hbbr容器：

bash
docker start hbbs hbbr

6. 客户端配置

1. 下载客户端：访问https://github.com/rustdesk/rustdesk/releases
2. 获取密钥：在宿主机的/opt/docker/rustdesk/hbbs目录下找到id_ed25519.pub文件，复制其中内容
3. 客户端设置：在客户端中输入服务器域名（或IP）和密钥，完成配置后即可实现远程控制

注意事项

• 首次运行hbbs后，需等待密钥文件生成（位于挂载目录下）
• 外网访问需确保域名解析正确且端口已转发
• 客户端与服务器版本需保持兼容，建议使用最新版本
• 数据目录权限需确保容器可读写，否则可能导致密钥生成失败