3分钟搞定Docker容器中Windows挂载USB设备：从驱动到共享全流程

你是否曾在Docker容器中运行Windows系统时，因无法识别USB设备而困扰？是否尝试过多种方法却依然无法让外部存储与容器内系统正常交互？本文将通过3个核心步骤，带你解决Docker环境下Windows系统挂载USB存储设备的全部痛点，无需专业Linux知识，普通用户也能轻松完成。

一、理解Docker与USB设备的通信障碍

Docker容器本质上是一个隔离的运行环境，默认情况下无法直接访问主机的硬件设备。当我们在容器中运行Windows系统时，USB设备的识别需要经过三层桥接：

• 物理USB端口 → 主机系统 → Docker服务 → 容器内Windows

这种多层隔离导致直接挂载USB设备变得复杂。通过分析项目中的Samba服务配置，我们发现开发团队采用了网络共享方案来规避直接硬件访问的限制，这也是目前最稳定的实现方式。

二、准备工作：配置Docker环境

2.1 检查系统兼容性

确保你的Docker环境满足以下条件：

• 已启用KVM虚拟化支持（通过lsmod | grep kvm命令验证）
• Docker版本≥20.10.0
• 主机内核支持USB设备转发

2.2 修改Docker Compose配置

打开项目根目录下的compose.yml文件，在devices部分添加USB设备映射：

services:
  windows:
    image: dockurr/windows
    container_name: windows
    environment:
      VERSION: "11"
    devices:
      - /dev/kvm
      - /dev/bus/usb:/dev/bus/usb  # 添加USB总线映射
    cap_add:
      - NET_ADMIN
      - SYS_ADMIN  # 添加系统管理权限
    ports:
      - 8006:8006
      - 3389:3389/tcp
      - 3389:3389/udp
    volumes:
      - ./usb-share:/mnt/usb  # 添加USB共享目录
    stop_grace_period: 2m

三、实现USB设备共享的两种方案

3.1 Samba网络共享方案（推荐）

项目内置的Samba服务提供了便捷的文件共享功能。该方案通过网络方式将主机上的USB设备共享给容器内Windows系统，无需复杂的驱动配置。

配置步骤：

1. 在主机上创建USB挂载点：

   mkdir -p ./usb-share
   sudo mount /dev/sdb1 ./usb-share  # 将sdb1替换为你的USB设备
   

2. Samba服务会自动共享以下目录（见Samba配置）：

   • /data → 映射为"Data"共享
   • /data2 → 映射为"Data2"共享（存在时自动创建）
   • /data3 → 映射为"Data3"共享（存在时自动创建）

3. 在容器内Windows系统中，通过网络访问\\host.lan\Data即可连接到USB设备。

3.2 直接设备映射方案（高级用户）

对于需要直接访问USB硬件的场景（如USB加密狗、特殊设备），可通过以下步骤实现：

1. 识别USB设备的Vendor ID和Product ID：

   lsusb
   

2. 在compose.yml中添加设备过滤规则：

   devices:
     - /dev/bus/usb/001/005:/dev/bus/usb/001/005  # 替换为实际设备路径
   

3. 启动容器后，通过RDP连接到Windows系统，安装相应的USB设备驱动。

四、验证与故障排除

4.1 验证共享是否成功

在容器内Windows系统中打开文件资源管理器，输入\\host.lan\Data，如果能看到USB设备中的文件，则表示配置成功。

4.2 常见问题解决

1. 设备无法识别：检查USB设备是否已正确挂载到主机的./usb-share目录
2. 权限错误：确保主机共享目录权限设置正确：chmod 777 ./usb-share
3. Samba服务未启动：检查Samba服务状态，通过docker exec -it windows smbd --version验证服务是否正常运行

五、最佳实践与注意事项

1. 设备热插拔：不建议在容器运行时插拔USB设备，可能导致系统不稳定
2. 多设备管理：如需同时挂载多个USB设备，可创建/data2、/data3等目录并映射（参考Samba自动共享逻辑）
3. 性能考量：网络共享方式会有轻微性能损耗，对于大容量文件传输，建议使用直接设备映射方案
4. 安全提示：USB设备可能携带恶意软件，接入前建议在主机端进行病毒扫描

通过以上步骤，你已经掌握了在Docker容器中运行的Windows系统挂载USB存储设备的完整方案。无论是普通U盘还是专业USB设备，都能通过本文介绍的方法实现稳定连接。如有其他问题，可参考项目官方文档或查看Samba服务源码了解更多高级配置选项。