3分钟搞定Docker容器中Windows挂载USB设备：从驱动到共享全流程
项目地址: https://gitcode.com/GitHub_Trending/wi/windows 你是否曾在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系统，无需复杂的驱动配置。
配置步骤：
-
在主机上创建USB挂载点：
mkdir -p ./usb-share sudo mount /dev/sdb1 ./usb-share # 将sdb1替换为你的USB设备 -
Samba服务会自动共享以下目录（见Samba配置）：
- /data → 映射为"Data"共享
- /data2 → 映射为"Data2"共享（存在时自动创建）
- /data3 → 映射为"Data3"共享（存在时自动创建）
-
在容器内Windows系统中，通过网络访问
\\host.lan\Data即可连接到USB设备。
3.2 直接设备映射方案（高级用户）
对于需要直接访问USB硬件的场景（如USB加密狗、特殊设备），可通过以下步骤实现：
-
识别USB设备的Vendor ID和Product ID：
lsusb -
在compose.yml中添加设备过滤规则：
devices: - /dev/bus/usb/001/005:/dev/bus/usb/001/005 # 替换为实际设备路径 -
启动容器后，通过RDP连接到Windows系统，安装相应的USB设备驱动。
四、验证与故障排除
4.1 验证共享是否成功
在容器内Windows系统中打开文件资源管理器，输入\\host.lan\Data，如果能看到USB设备中的文件，则表示配置成功。
4.2 常见问题解决
- 设备无法识别：检查USB设备是否已正确挂载到主机的
./usb-share目录 - 权限错误：确保主机共享目录权限设置正确：
chmod 777 ./usb-share - Samba服务未启动：检查Samba服务状态，通过
docker exec -it windows smbd --version验证服务是否正常运行
五、最佳实践与注意事项
- 设备热插拔：不建议在容器运行时插拔USB设备，可能导致系统不稳定
- 多设备管理：如需同时挂载多个USB设备，可创建/data2、/data3等目录并映射（参考Samba自动共享逻辑）
- 性能考量：网络共享方式会有轻微性能损耗，对于大容量文件传输，建议使用直接设备映射方案
- 安全提示：USB设备可能携带恶意软件，接入前建议在主机端进行病毒扫描
通过以上步骤，你已经掌握了在Docker容器中运行的Windows系统挂载USB存储设备的完整方案。无论是普通U盘还是专业USB设备，都能通过本文介绍的方法实现稳定连接。如有其他问题，可参考项目官方文档或查看Samba服务源码了解更多高级配置选项。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
