Docker卷文件变更/更新/创建无法同步至Windows主机问题

问题场景 #

将Python应用容器化后，Windows主机与Debian容器间的卷同步出现异常：

• 容器内创建或修改的文件，Windows主机无法实时查看
• Windows主机创建的文件，容器需重启才能识别
  当前使用的容器启动命令：

docker run --rm -it -v /x/project/0005/data:/app/data 0005

解决步骤 #

1. 确认Docker Desktop文件共享权限 #

• 打开Docker Desktop设置，进入「Resources」→「File Sharing」
• 确保X盘已被添加到共享列表，授予Docker访问权限
• 修改后重启Docker Desktop生效

2. 修正卷映射路径格式 #

Windows环境下优先使用原生路径格式替换WSL风格路径：
原启动命令：

docker run --rm -it -v /x/project/0005/data:/app/data 0005

修改为：

docker run --rm -it -v X:\Project\0005\data:/app/data 0005

注意保持路径大小写一致，避免识别异常。

3. 调整WSL版本优化同步 #

• 若使用WSL2后端，容器文件同步存在天然延迟，可切换为WSL1：
  打开PowerShell执行：

  wsl --set-version <你的WSL发行版名称> 1
  

  示例：wsl --set-version Ubuntu-22.04 1
  切换完成后重启Docker和WSL服务

4. 修复容器内目录权限 #

容器内/app/data权限不足可能导致同步失败，在Dockerfile末尾添加权限配置：

RUN mkdir -p /app/data && chmod 777 /app/data

（开发环境可放宽权限，生产环境需根据实际运行用户调整）
重新构建镜像：

docker build . --tag "0005" --no-cache

5. 使用--mount参数强制实时同步 #

替代-v参数，明确指定绑定类型，绕过Docker缓存机制：

docker run --rm -it --mount type=bind,source=X:\Project\0005\data,target=/app/data 0005

内容的提问来源于stack exchange，提问作者Alex Mikhaelson