Docker run使用-v参数挂载本地卷后双向同步失效问题求助

首先明确：你使用的 -v 绑定挂载语法本身的设计逻辑就是支持宿主机与容器目录双向实时同步，你遇到的同步失效属于异常场景，不符合功能设计预期，可按以下步骤排查：

• 第一步：验证挂载是否实际生效 #

  执行以下命令查看容器的挂载配置，确认绑定关系是否被Docker正确识别：

  docker inspect zeppelin | jq '.[0].Mounts'
  

  如果输出中不存在 /home/sammy/mnt/Zeppelin_Notebook 到 /zeppelin/notebook 的挂载记录，说明启动时挂载直接失败，常见原因是宿主机路径拼写错误、目录不存在，或宿主机目录权限不足导致挂载被跳过。
  如果挂载记录存在，继续向下排查。

• 第二步：核对目录权限匹配情况 #

  绑定挂载会直接继承宿主机目录的权限属性，容器内进程对挂载目录的读写权限完全由宿主机目录的UID/GID权限控制：
  1. 先查看容器内运行Zeppelin进程的用户UID：

     docker exec zeppelin ps aux | grep zeppelin
     

  2. 再对比宿主机挂载目录的所有者UID：

     ls -ld /home/sammy/mnt/Zeppelin_Notebook
     

  如果二者UID不匹配，容器内进程没有写入权限，会出现“修改未同步”的假象，实际是写入操作被系统拦截了。
  如果你在Windows/macOS环境使用Docker Desktop，还需要确认 /home/sammy/mnt/Zeppelin_Notebook 所在的磁盘分区已经在Docker Desktop的「设置-资源-文件共享」列表中被授权，未授权的目录挂载会直接静默失效。

• 第三步：排查镜像目录的特殊配置 #

  Apache Zeppelin 0.9.0官方镜像默认会在首次启动时向/zeppelin/notebook目录写入预置示例笔记：
  • 若首次挂载时宿主机目录为空，容器会自动将预置文件同步到宿主机
  • 若首次挂载时宿主机目录非空，容器会直接使用宿主机目录内容，不会覆盖
    该逻辑不会导致双向同步完全失效，如果是首次启动后就完全无法同步，可以排除该原因。

• 第四步：检查目录独占锁问题 #

  如果宿主机或容器内有其他进程对挂载目录加了独占锁，也会导致文件修改无法被另一侧及时识别，可尝试重启容器后再次测试修改同步效果。

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