Docker Desktop 挂载检查怎么配置或排查

Docker Desktop 挂载检查，核心不是反复重启容器，而是依次确认“宿主目录是否被 Docker Desktop 允许访问、source 和 target 是否写对、容器实际拿到的读写属性是否符合预期”。项目目录位于共享范围之外时，常见表现就是 Mounts denied、容器启动失败或容器内目录为空。

先在 Docker Desktop 的 Settings → Resources → File sharing 中加入项目所在目录，再用一个最小容器读取并写入测试文件，最后用 docker inspect 核对 Source、Destination 和 RW。三处一致，挂载问题通常就能收口。

官方地址：https://docs.docker.com/desktop/settings-and-maintenance/settings/

先把宿主目录加入 Docker Desktop 的共享范围

以本机的 /work/demo-app 为例，先确认它确实存在，并且里面有一个容易识别的文件，例如 README.md。在 Docker Desktop 中打开 Settings → Resources → File sharing，选择 Add a folder，加入项目目录或它的父目录，然后点击 Apply & Restart。如果使用 Windows，入口名称可能显示为 Shared Folders，但判断原则相同。

这里建议共享范围保持足够小，只加入项目需要的目录。共享整个用户目录会增加文件同步开销，也可能让容器接触到不必要的个人文件。

用最小容器判断路径和读写是否真的可用

共享完成后，不要直接从复杂的 Compose 服务排错。先执行一个短命令，把宿主目录挂到容器的 /app，列出文件，再创建一个检查文件：

docker run --rm \
  --mount type=bind,source=/work/demo-app,target=/app \
  alpine sh -c 'ls -la /app && echo mount-check > /app/check.txt && cat /app/check.txt'
# 先列出挂载内容，再写入一个短文件，最后回读确认可写链路。

看到宿主目录中的文件，并读到 mount-check，才说明本次可写挂载基本正常。命令中的 source 必须是宿主路径，target 必须是容器内的绝对路径；把二者写反会让问题看起来像“容器没有文件”。

如果业务容器只需要读取代码，把挂载改成只读更稳妥：

docker run --rm \
  --mount type=bind,source=/work/demo-app,target=/app,readonly \
  alpine sh -c 'ls -la /app && test ! -w /app'
# 只读模式用于代码检查；不要在同一挂载上安排写缓存或生成文件。

再用 Mounts 结果核对四个字段

需要查看容器的实际配置时，去掉 --rm 运行一个测试容器：

docker run -d --name demo-web \
  --mount type=bind,source=/work/demo-app,target=/app \
  nginx:alpine

docker inspect demo-web
# 只关注 Mounts 数组，不要把镜像层里的文件误认为宿主目录内容。

在返回的 Mounts 数组中，按下面的清单检查：

检查完可以清理测试容器：

docker rm -f demo-web
# 测试结束删除临时容器；宿主目录和其中的检查文件不会因此自动删除。

按错误现象定位配置层还是路径层

出现 Mounts denied 或 access denied：先回到 File sharing，确认共享的是项目所在目录而不是另一个同名目录；再检查宿主系统是否允许 Docker Desktop 访问该文件夹。

容器启动了但目录为空：优先看 docker inspect 的 Source 和 Destination。在 macOS 与 Windows 上，大小写和路径转换也可能造成“看似同一路径、实际不是同一目录”的结果。Compose 场景再执行 docker compose config，确认变量展开后的 volumes 值。

能读不能写：检查挂载是否带了 ro 或 readonly，再看宿主目录权限。不要先修改容器内用户或全局权限；先证明挂载属性本身正确。

挂载后镜像原有文件消失：绑定挂载会遮住 target 目录原先的内容。需要保留那些文件时，应改用新的容器目标目录，或重新创建不带该挂载的容器。

常见问题

Docker Desktop 文件共享应该加项目目录还是整个磁盘？

优先加入项目目录或必要的父目录。范围越大，同步开销和暴露的宿主文件越多。

--mount 和 -v 检查结果有什么区别？

两者都能创建 bind mount，但 --mount 使用键值对，source、target 和 readonly 更直观，排查时不容易把冒号字段写错。

Docker Desktop 能使用 mount propagation 吗？

Docker 官方文档说明 Docker Desktop 不支持 mount propagation。需要这类 Linux 挂载传播能力时，不能仅靠 Docker Desktop 的 bind mount 参数解决。