保姆级教程：用Docker Compose在Ubuntu上自建RustDesk远程桌面服务器（含端口详解）

私有化部署RustDesk远程桌面从Docker Compose到安全优化的完整实践在数字化办公日益普及的今天远程桌面工具已成为开发者跨设备协作的刚需。而RustDesk作为一款开源的远程控制解决方案凭借其轻量级、低延迟和隐私保护特性正吸引着越来越多技术团队的目光。本文将带您从零开始在Ubuntu系统上通过Docker Compose搭建专属的RustDesk服务器并深入探讨端口配置、安全加固和性能调优等进阶话题。1. 环境准备与基础配置在开始部署前我们需要确保基础环境就绪。推荐使用Ubuntu 22.04 LTS或更高版本系统需预先安装Docker引擎和Docker Compose插件。对于生产环境建议选择至少2核CPU、4GB内存的云服务器或本地设备。基础组件安装命令# 更新软件包索引 sudo apt update sudo apt upgrade -y # 安装Docker引擎 sudo apt install -y docker.io # 安装Docker Compose插件 sudo apt install -y docker-compose-plugin # 验证安装 docker --version docker compose version提示如果您的服务器位于企业防火墙后可能需要联系网络管理员开放必要的出站连接以便Docker能够拉取镜像。创建专用目录结构是保持系统整洁的好习惯sudo mkdir -p /opt/rustdesk/{config,data} sudo chown -R $USER:$USER /opt/rustdesk cd /opt/rustdesk2. Docker Compose架构设计RustDesk服务端由两个核心组件构成hbbs信令服务器和hbbr中继服务器。理解它们的协作方式对后续故障排查至关重要。组件功能对比组件主要职责关键端口网络协议hbbs设备注册、连接协商21115-21116, 21118TCP/UDPhbbr数据中继传输21117, 21119TCP下面是经过优化的docker-compose.yml配置增加了资源限制和健康检查version: 3.8 services: hbbs: image: rustdesk/rustdesk-server:latest container_name: hbbs command: hbbs environment: - RELAYhbbr:21117 - ENCRYPTED_ONLY1 ports: - 21115:21115 - 21116:21116 - 21116:21116/udp - 21118:21118 volumes: - ./data:/root networks: - rustdesk-net deploy: resources: limits: cpus: 1 memory: 512M healthcheck: test: [CMD, netstat, -tuln, |, grep, 21116] interval: 30s timeout: 10s retries: 3 hbbr: image: rustdesk/rustdesk-server:latest container_name: hbbr command: hbbr ports: - 21117:21117 - 21119:21119 volumes: - ./data:/root networks: - rustdesk-net deploy: resources: limits: cpus: 0.5 memory: 256M networks: rustdesk-net: driver: bridge ipam: config: - subnet: 172.28.0.0/16启动服务并验证状态docker compose up -d docker compose ps3. 端口功能深度解析RustDesk使用多个端口实现不同功能合理配置防火墙是安全运营的关键。以下是各端口的详细说明核心端口矩阵端口协议服务必需性安全建议21115TCPNAT类型检测必需限制访问IP21116TCP/UDP主通信端口必需启用加密21117TCP中继数据传输可选配置TLS21118TCPWeb控制台可选强密码保护21119TCPWeb客户端可选按需开放对于企业级部署建议实施以下安全措施使用UFW配置精细化防火墙规则sudo ufw allow from 192.168.1.0/24 to any port 21116 proto tcp sudo ufw allow from 192.168.1.0/24 to any port 21116 proto udp启用TLS加密需准备域名和证书# 在hbbs环境变量中添加 - HTTPS_CERT/path/to/cert.pem - HTTPS_KEY/path/to/key.pem4. 密钥管理与访问控制RustDesk自动生成的密钥对是保障通信安全的第一道防线。部署完成后您可以在挂载目录中找到以下文件/opt/rustdesk/data/ ├── id_ed25519 # 私钥绝不可泄露 ├── id_ed25519.pub # 公钥需配置到客户端 └── db_v2.sqlite3 # 设备注册数据库密钥轮换最佳实践每月或重大版本更新后执行密钥轮换轮换前通知所有客户端更新配置使用脚本自动化备份旧密钥#!/bin/bash BACKUP_DIR/opt/rustdesk/backups/$(date %Y%m%d) mkdir -p $BACKUP_DIR cp /opt/rustdesk/data/id_ed25519* $BACKUP_DIR/对于团队使用场景可以集成LDAP/AD认证# 在hbbs环境变量中添加 - LDAP_SERVERldap://your.ldap.server - LDAP_BASE_DNouusers,dccompany,dccom5. 性能调优与监控大规模部署时需要对服务进行性能优化。以下参数可根据实际负载调整性能调优参数表参数默认值建议值100设备作用worker_threadsCPU核心数核心数×2处理线程数max_connections10005000最大连接数relay_threads48中继线程数启用Prometheus监控指标# 在hbbs和hbbr的环境变量中添加 - PROMETHEUS_LISTEN0.0.0.0:21120然后配置Grafana仪表板监控关键指标在线设备数带宽使用情况连接延迟分布中继流量占比6. 客户端配置与连接测试服务器就绪后需要在各平台客户端进行配置。以下是Windows客户端的配置示例下载官方客户端并安装进入设置 → 网络 → ID服务器填写服务器地址IP或域名在密钥字段粘贴id_ed25519.pub内容连接测试清单[ ] 局域网内设备互连测试[ ] 跨网络环境连接测试[ ] 文件传输功能验证[ ] 多显示器支持检查[ ] 音频重定向测试对于移动端用户建议生成配置二维码# 安装qrencode工具 sudo apt install -y qrencode # 生成配置二维码 echo rustdesk://your.server.com?key$(cat /opt/rustdesk/data/id_ed25519.pub | base64) | qrencode -t ANSI7. 常见问题排错指南即使按照最佳实践部署仍可能遇到各种连接问题。以下是几个典型场景的解决方案问题1客户端显示无法连接到ID服务器检查防火墙规则验证hbbs容器日志docker logs hbbs测试端口连通性telnet your.server 21116问题2连接建立但画面卡顿检查hbbr容器资源使用情况尝试直连模式绕过中继调整客户端画质设置问题3Web客户端无法访问确认21118/21119端口开放检查浏览器控制台错误验证证书有效性如启用HTTPS建立系统化的日志收集机制有助于快速定位问题# 配置日志轮转 sudo tee /etc/logrotate.d/rustdesk EOF /opt/rustdesk/data/*.log { daily missingok rotate 30 compress delaycompress notifempty create 644 root root } EOF8. 备份策略与灾备方案为确保服务连续性需要制定完善的备份计划。以下是关键数据的备份策略备份矩阵数据类型频率保留周期存储位置密钥文件每日永久加密云存储配置数据每周3个月本地NAS日志文件每日1个月对象存储自动化备份脚本示例#!/bin/bash DATE$(date %Y%m%d) BACKUP_DIR/mnt/backups/rustdesk/$DATE mkdir -p $BACKUP_DIR docker compose exec hbbs sqlite3 /root/db_v2.sqlite3 .backup $BACKUP_DIR/db_v2.sqlite3 cp /opt/rustdesk/data/id_ed25519* $BACKUP_DIR/ tar czf $BACKUP_DIR/config.tar.gz /opt/rustdesk/config/ # 上传到云存储 rclone copy $BACKUP_DIR remote:rustdesk-backups/$DATE对于关键业务场景建议配置多区域部署在主要区域部署主集群在备用区域部署只读副本使用DNS轮询实现负载均衡配置健康检查自动故障转移9. 进阶与现有基础设施集成成熟的IT环境通常需要将新服务整合到现有体系中。以下是几种常见集成方案与企业VPN集成配置路由规则使远程用户通过VPN访问RustDesk限制仅VPN IP段可以连接服务端口与ITSM系统对接通过Webhook接收连接事件通知自动创建工单记录远程会话与SIEM系统集成转发服务日志到SIEM中心配置异常连接告警规则自动化部署方案# 使用Ansible部署示例 - name: Deploy RustDesk server hosts: remote_servers tasks: - name: Create directory structure file: path: /opt/rustdesk/{{ item }} state: directory loop: [config, data] - name: Copy compose file template: src: templates/docker-compose.yml.j2 dest: /opt/rustdesk/docker-compose.yml - name: Start services community.docker.docker_compose: project_src: /opt/rustdesk state: present10. 成本优化与资源规划私有化部署虽然提升了安全性但也需要考虑成本因素。以下是不同规模部署的资源建议部署规模参考表并发设备数CPU核心内存带宽适用场景1-1011GB10Mbps个人开发者10-5024GB50Mbps小型团队50-20048GB100Mbps中型企业200集群16GB专线大型组织降低带宽消耗的技巧启用客户端压缩选项限制非必要设备的画面帧率为移动端配置更低的默认画质云服务成本控制方法使用预留实例节省长期费用配置自动伸缩策略应对流量波动选择按流量计费的带宽套餐在家庭实验室环境中可以考虑将RustDesk与其它服务共享服务器资源但需要注意资源隔离# 在docker-compose.yml中设置资源限制 deploy: resources: limits: cpus: 0.5 memory: 512M reservations: cpus: 0.2 memory: 256M