Docker如何挂载动态文件结构 实现USB热插拔无需重启容器

两次方案失败的核心原因是未配置正确的挂载传播（Mount Propagation）策略：

• Docker默认的bind挂载、普通volume挂载，默认使用rprivate传播属性，宿主机在映射目录下新增的子文件系统挂载（即插入USB后新创建的/media/xxx挂载点），不会同步到容器的独立挂载命名空间内。因此容器只能识别启动那一刻/media目录下已有的内容，后续动态新增的挂载点完全无法感知，和测试中“启动时存在的文件可正常读，启动后目录结构变更无法识别”的表现完全吻合。

直接使用配置了rshared传播属性的bind挂载即可，无需第三方存储插件，USB插拔全程不需要重启容器，完全匹配需求。

操作步骤 #

• 宿主机提前创建USB设备统一挂载根目录/media，确保目录权限允许udev/systemd执行挂载操作
• 启动容器时使用带传播属性配置的挂载参数，替换原有的普通bind参数：

docker run -d \
  --mount type=bind,source=/media,target=/host_media,bind-propagation=rshared \
  你的业务镜像名

• 配置宿主机udev/systemd自动挂载规则，所有USB存储设备统一挂载到/media的子目录下（禁止直接挂载到/media根目录）。推荐直接调用systemd-mount实现自动挂载/卸载，不需要自行编写复杂脚本：
  新建/etc/udev/rules.d/99-usb-auto-mount.rules文件，写入以下规则：

  ACTION=="add", SUBSYSTEM=="block", KERNEL=="sd[a-z][0-9]", ENV{ID_BUS}=="usb", RUN+="/usr/bin/systemd-mount --no-block --collect --owner=1000 %E{DEVNAME} /media"
  ACTION=="remove", SUBSYSTEM=="block", KERNEL=="sd[a-z][0-9]", ENV{ID_BUS}=="usb", RUN+="/usr/bin/systemd-umount --no-block %E{DEVNAME}"
  

  执行udevadm control --reload-rules加载规则后，插入USB会自动在/media下生成对应设备名的挂载点，拔出设备会自动卸载并清理临时目录。

验证效果 #

配置完成后所有挂载变更实时同步，无需重启容器：

• 插入USB时，宿主机生成/media/usb-sda1类挂载点，容器内直接访问/host_media/usb-sda1即可读取U盘全量文件
• 拔出USB时，宿主机卸载对应目录，容器内对应挂载点同步消失，不会残留无效文件句柄

避坑提示 #

• 禁止将USB设备直接挂载到/media根路径，否则会覆盖宿主机/media原有内容，导致挂载传播失效
• 若使用rootless模式运行Docker，需确保内核版本≥5.0，支持用户命名空间下的挂载传播特性
• 无需使用Docker volume方案，普通volume默认无法配置rshared传播属性，实现链路比直接bind挂载更冗余

内容的提问来源于stack exchange，提问作者Some Guy