如何将外置HDD挂载到Docker ElasticSearch？出现NoSuchFileException错误

问题重现 #

在Mac上使用Docker运行ElasticSearch 8.8.2，尝试将外置硬盘（T7）上的目录挂载到容器内的ES数据目录时，容器启动失败并抛出NoSuchFileException，但挂载本地主硬盘目录时容器可正常启动。

执行的启动命令：

(base) peter@Peters-MBP14 ~ % docker run --name es01-t7v --net elastic -p 9200:9200 -v /Volumes/T7/pdr/dom-2.2.1/es-data-01:/usr/share/elasticsearch/data -it docker.elastic.co/elasticsearch/elasticsearch:8.8.2

报错信息：

Exception in thread "main" java.nio.file.NoSuchFileException: /usr/share/elasticsearch/data
    at java.base/sun.nio.fs.UnixException.translateToIOException(UnixException.java:92)
    at java.base/sun.nio.fs.UnixException.asIOException(UnixException.java:115)
    at java.base/sun.nio.fs.UnixFileSystemProvider.newDirectoryStream(UnixFileSystemProvider.java:477)
    at java.base/java.nio.file.Files.newDirectoryStream(Files.java:481)
    at java.base/java.nio.file.Files.list(Files.java:3767)
    at org.elasticsearch.xpack.security.cli.AutoConfigureNode.isDirEmpty(AutoConfigureNode.java:1144)
    at org.elasticsearch.xpack.security.cli.AutoConfigureNode.execute(AutoConfigureNode.java:166)
    at org.elasticsearch.server.cli.ServerCli.autoConfigureSecurity(ServerCli.java:165)
    at org.elasticsearch.server.cli.ServerCli.execute(ServerCli.java:86)
    at org.elasticsearch.common.cli.EnvironmentAwareCommand.execute(EnvironmentAwareCommand.java:54)
    at org.elasticsearch.cli.Command.mainWithoutErrorHandling(Command.java:85)
    at org.elasticsearch.cli.Command.main(Command.java:50)
    at org.elasticsearch.launcher.CliToolLauncher.main(CliToolLauncher.java:64)

已确认外置硬盘目录权限正常：

(base) peter@Peters-MBP14 ~ % ls -al /Volumes/T7/pdr/dom-2.2.1/es-data-01
total 512
drwxrwxrwx  1 peter  staff  131072 Jul 19 19:18 .
drwxrwxrwx  1 peter  staff  131072 Jul 19 17:30 ..

可能的解决方法 #

1. 检查Docker Desktop的文件共享设置 #

Mac上Docker Desktop默认仅共享/Users目录，外置硬盘不在默认共享列表中，导致容器无法访问该路径。

• 打开Docker Desktop，进入偏好设置 -> Resources -> File Sharing
• 添加/Volumes/T7（或直接添加整个/Volumes目录）到共享列表
• 点击Apply & Restart重启Docker，之后重新尝试启动ES容器

2. 验证外置硬盘的文件系统格式 #

如果外置硬盘是NTFS格式，Mac系统默认仅挂载为只读模式，即使宿主机显示权限为777，容器内也可能无法正常访问（表现为路径不存在的错误）。

• 解决方案：
  • 将硬盘格式化为APFS或Mac OS扩展（日志式）（注意提前备份数据）
  • 或安装NTFS读写工具（如Paragon NTFS），确保硬盘可读写

3. 确认宿主机挂载路径的有效性 #

虽然已检查权限，但可以进一步验证路径的可访问性：

# 进入目标目录并创建测试文件，确认路径可读写
cd /Volumes/T7/pdr/dom-2.2.1/es-data-01 && touch test.txt && rm test.txt

# 用realpath确认路径真实存在
realpath /Volumes/T7/pdr/dom-2.2.1/es-data-01

4. 调整容器用户权限映射 #

ES容器默认使用elasticsearch用户（UID 1000）运行，Mac外置硬盘的权限映射可能和主硬盘不同，导致容器内用户无法访问挂载目录：

• 临时测试：启动容器时指定root用户（仅用于排查，不推荐生产环境）

  docker run --name es01-t7v --net elastic -p 9200:9200 -v /Volumes/T7/pdr/dom-2.2.1/es-data-01:/usr/share/elasticsearch/data --user root -it docker.elastic.co/elasticsearch/elasticsearch:8.8.2
  

• 永久解决：修改宿主机外置硬盘目录的所有者为容器内的elasticsearch用户（UID 1000）

  sudo chown -R 1000:1000 /Volumes/T7/pdr/dom-2.2.1/es-data-01
  

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