RustDesk自建服务器全攻略从Docker部署到客户端配置避坑指南远程协作工具已经成为现代工作场景中不可或缺的一部分。对于注重数据隐私和自主控制的技术团队来说自建远程桌面解决方案不仅能提升安全性还能根据实际需求灵活调整配置。RustDesk作为一款开源远程桌面工具凭借其轻量级架构和出色的跨平台兼容性正成为越来越多技术团队的首选方案。本文将带您从零开始搭建专属的RustDesk服务器环境涵盖从服务器准备到客户端连接的全流程。不同于简单的安装教程我们会深入探讨每个环节的技术细节和常见问题帮助您避开部署过程中的各种坑。1. 环境准备与基础配置在开始部署前需要确保服务器环境满足基本要求。推荐使用Ubuntu 22.04 LTS或CentOS 8以上版本的操作系统配置至少2核CPU、4GB内存和50GB存储空间。云服务商方面阿里云、腾讯云或AWS的轻量应用服务器都是不错的选择。1.1 系统基础设置首先更新系统软件包并安装必要工具sudo apt update sudo apt upgrade -y sudo apt install -y curl wget vim tree net-tools设置主机名有助于后续管理sudo hostnamectl set-hostname rustdesk-server1.2 防火墙配置RustDesk需要特定的端口才能正常工作。以下是必须开放的端口列表端口号协议用途必选21115TCPNAT类型测试是21116TCPID注册和连接服务是21116UDPID注册和心跳服务是21117TCP中继服务是21118TCPWeb客户端支持可选21119TCPWeb客户端支持可选使用UFW配置防火墙规则sudo ufw allow 21115/tcp sudo ufw allow 21116/tcp sudo ufw allow 21116/udp sudo ufw allow 21117/tcp sudo ufw enable1.3 Docker环境安装RustDesk官方推荐使用Docker部署这能简化依赖管理和版本控制。安装Docker和Docker Compose# 安装Docker curl -fsSL https://get.docker.com | sh sudo systemctl enable --now docker # 安装Docker Compose sudo curl -L https://github.com/docker/compose/releases/download/v2.20.3/docker-compose-$(uname -s)-$(uname -m) -o /usr/local/bin/docker-compose sudo chmod x /usr/local/bin/docker-compose验证安装是否成功docker --version docker-compose --version2. Docker Compose部署RustDesk服务2.1 准备部署目录创建专用目录结构存放配置文件和持久化数据mkdir -p /data/rustdesk/{compose,root} cd /data/rustdesk/compose2.2 编写docker-compose.yml创建docker-compose.yml文件内容如下version: 3.8 services: hbbs: container_name: hbbs image: rustdesk/rustdesk-server:latest command: hbbs environment: - RELAYhbbr:21117 - ENCRYPTED_ONLY1 ports: - 21115:21115 - 21116:21116 - 21116:21116/udp - 21118:21118 volumes: - /data/rustdesk/root:/root networks: - rustdesk-net restart: unless-stopped hbbr: container_name: hbbr image: rustdesk/rustdesk-server:latest command: hbbr ports: - 21117:21117 - 21119:21119 volumes: - /data/rustdesk/root:/root networks: - rustdesk-net restart: unless-stopped networks: rustdesk-net: driver: bridge关键配置说明RELAY环境变量指定中继服务器地址ENCRYPTED_ONLY1强制使用加密连接数据卷映射确保重启后数据不丢失2.3 启动服务执行以下命令启动服务docker-compose up -d验证容器状态docker-compose ps预期输出应显示hbbs和hbbr两个容器都处于运行状态。3. 服务端高级配置3.1 获取公钥RustDesk服务启动后会自动生成密钥对获取公钥用于客户端配置cat /data/rustdesk/root/id_ed25519.pub记录输出的公钥内容形如G2yFoE0pWWqXAHM174TXbsoUqJB1brHKOxZhEKv7hA3.2 域名配置可选如果希望通过域名访问服务需要配置DNS解析在域名管理平台添加A记录将子域名如rustdesk.yourdomain.com指向服务器IP配置Nginx反向代理可选server { listen 80; server_name rustdesk.yourdomain.com; location / { proxy_pass http://127.0.0.1:21114; proxy_set_header Host $host; } }3.3 性能调优对于高并发场景可以调整以下参数修改docker-compose.yml中的资源限制hbbs: deploy: resources: limits: cpus: 2 memory: 2G调整内核参数提升网络性能echo net.core.rmem_max4194304 /etc/sysctl.conf echo net.core.wmem_max4194304 /etc/sysctl.conf sysctl -p4. 客户端配置与连接测试4.1 客户端安装从官方GitHub发布页下载对应平台的客户端。支持以下操作系统Windows (7及以上)macOS (10.13及以上)Linux (主流发行版)Android/iOS移动端4.2 客户端配置在客户端设置中配置自建服务器打开RustDesk客户端进入设置 → ID/中继服务器填写以下信息ID服务器您的服务器IP或域名如rustdesk.yourdomain.com中继服务器同上Key之前获取的公钥内容注意所有需要互连的客户端都必须配置相同的服务器信息和公钥4.3 连接测试测试不同类型的连接场景场景1局域网内直连两台设备在同一局域网连接后应显示加密直连场景2跨网络中继设备位于不同网络环境连接后应显示加密中继连接常见问题排查连接超时检查服务器防火墙设置验证端口是否开放测试telnet 服务器IP 21116是否通连接不稳定检查服务器带宽是否充足尝试调整客户端编解码器设置在客户端设置中启用强制TCP选项5. 维护与监控5.1 服务更新更新RustDesk服务到最新版本cd /data/rustdesk/compose docker-compose pull docker-compose up -d --force-recreate5.2 日志查看查看实时日志docker-compose logs -f5.3 备份策略建议定期备份以下数据/data/rustdesk/root目录下的密钥文件Docker Compose配置文件数据库文件默认使用SQLite可以设置cron任务自动备份0 3 * * * tar -czf /backup/rustdesk-$(date \%Y\%m\%d).tar.gz /data/rustdesk5.4 性能监控使用以下命令监控资源使用情况# 查看容器资源占用 docker stats # 查看网络连接 ss -tulnp | grep rustdesk对于生产环境建议集成PrometheusGrafana进行可视化监控。6. 安全加固措施6.1 密钥轮换定期更换密钥对每月一次docker-compose down rm /data/rustdesk/root/id_ed25519* docker-compose up -d更新后需要所有客户端重新配置新公钥。6.2 访问控制限制访问来源IP# 只允许特定IP访问21116端口 sudo ufw allow from 192.168.1.0/24 to any port 211166.3 日志审计启用详细日志记录# 在docker-compose.yml中添加 hbbs: environment: - LOG_LEVELdebug6.4 定期安全扫描使用Trivy扫描容器镜像漏洞trivy image rustdesk/rustdesk-server:latest7. 高级功能扩展7.1 Web客户端集成启用Web客户端支持在docker-compose.yml中开放21118和21119端口访问http://服务器IP:21118使用Web客户端7.2 多服务器负载均衡对于大规模部署可以配置多个RustDesk服务器# hbbs配置中添加 environment: - PUBLIC_IP服务器1IP - RELAY_SERVERS服务器1IP:21117,服务器2IP:211177.3 自定义客户端打包使用官方工具打包包含预配置的自定义客户端下载RustDesk源码修改src/ui/settings.rs中的默认服务器配置编译打包git clone https://github.com/rustdesk/rustdesk cd rustdesk cargo build --release8. 故障排除指南8.1 常见错误代码错误代码可能原因解决方案连接失败端口未开放检查防火墙设置密钥无效公钥不匹配重新配置客户端公钥连接不稳定网络延迟高尝试切换编解码器8.2 诊断工具使用内置命令诊断服务状态# 检查hbbs状态 docker exec -it hbbs hbbs --version # 检查网络连通性 docker exec -it hbbs ping hbbr8.3 性能优化建议对于高延迟网络在客户端设置中启用优化低带宽调整视频质量设置平衡画质和流畅度在服务器上启用BBR拥塞控制echo net.core.default_qdiscfq /etc/sysctl.conf echo net.ipv4.tcp_congestion_controlbbr /etc/sysctl.conf sysctl -p9. 实际应用场景9.1 远程技术支持技术团队可以使用自建RustDesk服务器为客户端提供远程支持确保所有会话数据都在可控范围内。9.2 跨地域协作分布式团队可以通过中继服务器实现高效的跨地域协作不受网络环境限制。9.3 安全敏感环境对于金融、医疗等对数据安全要求高的行业自建方案能完全满足合规要求。10. 替代方案对比与其他远程桌面解决方案相比RustDesk自建方案具有独特优势特性RustDesk自建TeamViewerAnyDesk数据控制完全自主第三方托管第三方托管成本免费商业授权商业授权延迟可优化依赖厂商依赖厂商定制能力完全开放有限有限在实际使用中我们发现RustDesk的P2P直连模式在局域网环境下延迟可以控制在50ms以内画质损失几乎不可察觉。而当中继不可避免时选择地理位置合适的服务器位置至关重要。
RustDesk自建服务器全攻略：从Docker部署到客户端配置（避坑指南）
RustDesk自建服务器全攻略从Docker部署到客户端配置避坑指南远程协作工具已经成为现代工作场景中不可或缺的一部分。对于注重数据隐私和自主控制的技术团队来说自建远程桌面解决方案不仅能提升安全性还能根据实际需求灵活调整配置。RustDesk作为一款开源远程桌面工具凭借其轻量级架构和出色的跨平台兼容性正成为越来越多技术团队的首选方案。本文将带您从零开始搭建专属的RustDesk服务器环境涵盖从服务器准备到客户端连接的全流程。不同于简单的安装教程我们会深入探讨每个环节的技术细节和常见问题帮助您避开部署过程中的各种坑。1. 环境准备与基础配置在开始部署前需要确保服务器环境满足基本要求。推荐使用Ubuntu 22.04 LTS或CentOS 8以上版本的操作系统配置至少2核CPU、4GB内存和50GB存储空间。云服务商方面阿里云、腾讯云或AWS的轻量应用服务器都是不错的选择。1.1 系统基础设置首先更新系统软件包并安装必要工具sudo apt update sudo apt upgrade -y sudo apt install -y curl wget vim tree net-tools设置主机名有助于后续管理sudo hostnamectl set-hostname rustdesk-server1.2 防火墙配置RustDesk需要特定的端口才能正常工作。以下是必须开放的端口列表端口号协议用途必选21115TCPNAT类型测试是21116TCPID注册和连接服务是21116UDPID注册和心跳服务是21117TCP中继服务是21118TCPWeb客户端支持可选21119TCPWeb客户端支持可选使用UFW配置防火墙规则sudo ufw allow 21115/tcp sudo ufw allow 21116/tcp sudo ufw allow 21116/udp sudo ufw allow 21117/tcp sudo ufw enable1.3 Docker环境安装RustDesk官方推荐使用Docker部署这能简化依赖管理和版本控制。安装Docker和Docker Compose# 安装Docker curl -fsSL https://get.docker.com | sh sudo systemctl enable --now docker # 安装Docker Compose sudo curl -L https://github.com/docker/compose/releases/download/v2.20.3/docker-compose-$(uname -s)-$(uname -m) -o /usr/local/bin/docker-compose sudo chmod x /usr/local/bin/docker-compose验证安装是否成功docker --version docker-compose --version2. Docker Compose部署RustDesk服务2.1 准备部署目录创建专用目录结构存放配置文件和持久化数据mkdir -p /data/rustdesk/{compose,root} cd /data/rustdesk/compose2.2 编写docker-compose.yml创建docker-compose.yml文件内容如下version: 3.8 services: hbbs: container_name: hbbs image: rustdesk/rustdesk-server:latest command: hbbs environment: - RELAYhbbr:21117 - ENCRYPTED_ONLY1 ports: - 21115:21115 - 21116:21116 - 21116:21116/udp - 21118:21118 volumes: - /data/rustdesk/root:/root networks: - rustdesk-net restart: unless-stopped hbbr: container_name: hbbr image: rustdesk/rustdesk-server:latest command: hbbr ports: - 21117:21117 - 21119:21119 volumes: - /data/rustdesk/root:/root networks: - rustdesk-net restart: unless-stopped networks: rustdesk-net: driver: bridge关键配置说明RELAY环境变量指定中继服务器地址ENCRYPTED_ONLY1强制使用加密连接数据卷映射确保重启后数据不丢失2.3 启动服务执行以下命令启动服务docker-compose up -d验证容器状态docker-compose ps预期输出应显示hbbs和hbbr两个容器都处于运行状态。3. 服务端高级配置3.1 获取公钥RustDesk服务启动后会自动生成密钥对获取公钥用于客户端配置cat /data/rustdesk/root/id_ed25519.pub记录输出的公钥内容形如G2yFoE0pWWqXAHM174TXbsoUqJB1brHKOxZhEKv7hA3.2 域名配置可选如果希望通过域名访问服务需要配置DNS解析在域名管理平台添加A记录将子域名如rustdesk.yourdomain.com指向服务器IP配置Nginx反向代理可选server { listen 80; server_name rustdesk.yourdomain.com; location / { proxy_pass http://127.0.0.1:21114; proxy_set_header Host $host; } }3.3 性能调优对于高并发场景可以调整以下参数修改docker-compose.yml中的资源限制hbbs: deploy: resources: limits: cpus: 2 memory: 2G调整内核参数提升网络性能echo net.core.rmem_max4194304 /etc/sysctl.conf echo net.core.wmem_max4194304 /etc/sysctl.conf sysctl -p4. 客户端配置与连接测试4.1 客户端安装从官方GitHub发布页下载对应平台的客户端。支持以下操作系统Windows (7及以上)macOS (10.13及以上)Linux (主流发行版)Android/iOS移动端4.2 客户端配置在客户端设置中配置自建服务器打开RustDesk客户端进入设置 → ID/中继服务器填写以下信息ID服务器您的服务器IP或域名如rustdesk.yourdomain.com中继服务器同上Key之前获取的公钥内容注意所有需要互连的客户端都必须配置相同的服务器信息和公钥4.3 连接测试测试不同类型的连接场景场景1局域网内直连两台设备在同一局域网连接后应显示加密直连场景2跨网络中继设备位于不同网络环境连接后应显示加密中继连接常见问题排查连接超时检查服务器防火墙设置验证端口是否开放测试telnet 服务器IP 21116是否通连接不稳定检查服务器带宽是否充足尝试调整客户端编解码器设置在客户端设置中启用强制TCP选项5. 维护与监控5.1 服务更新更新RustDesk服务到最新版本cd /data/rustdesk/compose docker-compose pull docker-compose up -d --force-recreate5.2 日志查看查看实时日志docker-compose logs -f5.3 备份策略建议定期备份以下数据/data/rustdesk/root目录下的密钥文件Docker Compose配置文件数据库文件默认使用SQLite可以设置cron任务自动备份0 3 * * * tar -czf /backup/rustdesk-$(date \%Y\%m\%d).tar.gz /data/rustdesk5.4 性能监控使用以下命令监控资源使用情况# 查看容器资源占用 docker stats # 查看网络连接 ss -tulnp | grep rustdesk对于生产环境建议集成PrometheusGrafana进行可视化监控。6. 安全加固措施6.1 密钥轮换定期更换密钥对每月一次docker-compose down rm /data/rustdesk/root/id_ed25519* docker-compose up -d更新后需要所有客户端重新配置新公钥。6.2 访问控制限制访问来源IP# 只允许特定IP访问21116端口 sudo ufw allow from 192.168.1.0/24 to any port 211166.3 日志审计启用详细日志记录# 在docker-compose.yml中添加 hbbs: environment: - LOG_LEVELdebug6.4 定期安全扫描使用Trivy扫描容器镜像漏洞trivy image rustdesk/rustdesk-server:latest7. 高级功能扩展7.1 Web客户端集成启用Web客户端支持在docker-compose.yml中开放21118和21119端口访问http://服务器IP:21118使用Web客户端7.2 多服务器负载均衡对于大规模部署可以配置多个RustDesk服务器# hbbs配置中添加 environment: - PUBLIC_IP服务器1IP - RELAY_SERVERS服务器1IP:21117,服务器2IP:211177.3 自定义客户端打包使用官方工具打包包含预配置的自定义客户端下载RustDesk源码修改src/ui/settings.rs中的默认服务器配置编译打包git clone https://github.com/rustdesk/rustdesk cd rustdesk cargo build --release8. 故障排除指南8.1 常见错误代码错误代码可能原因解决方案连接失败端口未开放检查防火墙设置密钥无效公钥不匹配重新配置客户端公钥连接不稳定网络延迟高尝试切换编解码器8.2 诊断工具使用内置命令诊断服务状态# 检查hbbs状态 docker exec -it hbbs hbbs --version # 检查网络连通性 docker exec -it hbbs ping hbbr8.3 性能优化建议对于高延迟网络在客户端设置中启用优化低带宽调整视频质量设置平衡画质和流畅度在服务器上启用BBR拥塞控制echo net.core.default_qdiscfq /etc/sysctl.conf echo net.ipv4.tcp_congestion_controlbbr /etc/sysctl.conf sysctl -p9. 实际应用场景9.1 远程技术支持技术团队可以使用自建RustDesk服务器为客户端提供远程支持确保所有会话数据都在可控范围内。9.2 跨地域协作分布式团队可以通过中继服务器实现高效的跨地域协作不受网络环境限制。9.3 安全敏感环境对于金融、医疗等对数据安全要求高的行业自建方案能完全满足合规要求。10. 替代方案对比与其他远程桌面解决方案相比RustDesk自建方案具有独特优势特性RustDesk自建TeamViewerAnyDesk数据控制完全自主第三方托管第三方托管成本免费商业授权商业授权延迟可优化依赖厂商依赖厂商定制能力完全开放有限有限在实际使用中我们发现RustDesk的P2P直连模式在局域网环境下延迟可以控制在50ms以内画质损失几乎不可察觉。而当中继不可避免时选择地理位置合适的服务器位置至关重要。
