RustDesk服务器Docker部署中的密钥持久化问题解决方案

在使用Docker部署RustDesk自建服务器时，许多用户会遇到一个常见问题：当容器重启后，服务器生成的密钥会重新生成，导致所有客户端都需要重新配置密钥。这个问题看似简单，但实际上涉及到Docker数据持久化的核心概念。

问题现象分析

当用户通过Docker Compose部署RustDesk服务器(hbbs和hbbr服务)时，如果采用默认配置，每次容器重启都会生成新的密钥对。这是因为Docker容器的文件系统默认是临时的，容器停止后其中的数据就会丢失。对于RustDesk服务器来说，密钥文件存储在容器的/root目录下，主要包括：

• id_ed25519 (私钥文件)
• id_ed25519.pub (公钥文件)

这些密钥文件是客户端连接服务器时进行身份验证的关键凭证。如果密钥变更，所有已连接的客户端都需要更新配置才能重新连接。

解决方案：使用Docker卷持久化数据

要解决这个问题，我们需要确保密钥文件在容器重启后仍然存在。Docker提供了多种数据持久化方案，其中最推荐的是使用命名卷(named volume)。

正确的Docker Compose配置

以下是经过验证的正确配置示例：

version: '3'

networks:
  rustdesk-net:
    external: false

services:
  hbbs:
    container_name: hbbs
    ports:
      - 21115:21115
      - 21116:21116
      - 21116:21116/udp
      - 21118:21118
    image: rustdesk/rustdesk-server:latest
    command: hbbs -r 服务器IP或域名:21117
    volumes:
      - rustdesk:/root
    networks:
      - rustdesk-net
    depends_on:
      - hbbr
    restart: unless-stopped

  hbbr:
    container_name: hbbr
    ports:
      - 21117:21117
      - 21119:21119
    image: rustdesk/rustdesk-server:latest
    command: hbbr
    volumes:
      - rustdesk:/root
    networks:
      - rustdesk-net
    restart: unless-stopped

volumes:
  rustdesk:
    external: true

关键配置说明

1. 命名卷使用：我们创建了一个名为"rustdesk"的Docker卷，并将其挂载到两个服务的/root目录
2. external: true：表示该卷需要在部署前手动创建
3. 共享卷：hbbs和hbbr服务共享同一个卷，确保密钥一致性

实施步骤

1. 创建持久化卷： 在部署前，先执行命令创建Docker卷：

   docker volume create rustdesk
   

2. 部署服务： 使用上述docker-compose.yml文件启动服务：

   docker-compose up -d
   

3. 验证密钥持久化： 重启容器后，检查密钥文件是否保持不变：

   docker exec -it hbbs cat /root/id_ed25519.pub
   

技术原理深入

Docker的数据持久化机制分为几种类型：

1. 绑定挂载(Bind Mount)：直接挂载主机文件系统目录

   • 优点：易于访问和备份
   • 缺点：依赖主机文件系统路径

2. 命名卷(Named Volume)：由Docker管理的存储卷

   • 优点：与容器生命周期解耦，适合生产环境
   • 缺点：需要额外管理

3. 临时文件系统(tmpfs)：仅存在于内存中

   • 不适用于此场景

对于RustDesk服务器，使用命名卷是最佳选择，因为：

• 数据完全由Docker管理，不受容器生命周期影响
• 性能优于绑定挂载
• 便于迁移和备份
• 可以设置更精细的权限控制

常见问题排查

如果按照上述配置后仍然遇到密钥重置问题，可以检查以下方面：

1. 卷是否正确创建：

   docker volume inspect rustdesk
   

2. 卷是否正确挂载：

   docker inspect hbbs | grep Mounts -A 10
   

3. 文件权限问题： 确保容器用户(默认root)有权限读写卷中的文件

4. 卷是否被意外删除： 检查是否有其他操作删除了Docker卷

最佳实践建议

1. 定期备份卷数据：

   docker run --rm -v rustdesk:/volume -v $(pwd):/backup alpine tar cvf /backup/rustdesk-backup.tar /volume
   

2. 考虑使用备份方案： 对于生产环境，建议设置定期自动备份策略

3. 监控卷使用情况：

   docker system df -v
   

通过正确配置Docker数据持久化，可以确保RustDesk服务器的密钥长期有效，避免因容器重启导致的连接问题。这种方案不仅适用于RustDesk，也是大多数需要持久化数据的Docker应用的通用解决方案。