Docker volumes挂载Windows共享文件夹不使用IP地址的问题求解

你在shell中可以正常访问//mypath/c是因为用户态SMB工具（如smbclient、gvfs）会自动尝试DNS、NetBIOS、WINS等多种名称解析方式，而Docker的local卷驱动调用的是内核态mount.cifs逻辑，默认仅走系统DNS解析，且默认不处理NetBIOS名称映射，因此出现IP可用但域名/主机名不可用的问题。

方案1：调整Docker卷挂载参数，补充NetBIOS解析配置 #

在driver_opts.o中新增netbiosname参数指定SMB主机名，同时修正device路径的转义和格式：

volumes:
  mysharefolder:
    driver: local
    driver_opts:
      type: cifs
      o: username=username,password=pwd,rw,domain=mydomain,netbiosname=mypath
      device: "//mypath/c$$"

配置完成后重启Docker daemon以加载最新的系统hosts/DNS配置，再启动容器即可。 #

方案2：宿主机预挂载共享目录再绑定到容器 #

将CIFS挂载逻辑交给宿主机处理，仅把挂载好的目录绑定到Docker容器，该方案稳定性最高：

1. 先在宿主机创建挂载目录：mkdir -p /mnt/myshare
2. 编辑/etc/fstab添加挂载配置：

   //mypath/c$$ /mnt/myshare cifs username=username,password=pwd,rw,domain=mydomain 0 0
   

3. 执行mount -a验证挂载正常
4. 修改Docker配置改为绑定挂载：

   services:
     myimage:
       volumes:
         - /mnt/myshare:/容器内的目标路径
   

方案3：启动前自动解析IP注入配置 #

如果不想修改宿主机配置，可在启动容器前通过脚本自动解析主机名对应的IP，通过环境变量注入到Docker配置中：

1. 启动前执行命令获取IP并写入环境变量：

   export CIFS_HOST_IP=$(getent hosts mypath | awk '{ print $1 }')
   

2. 修改Docker卷配置的device字段：

   device: "//${CIFS_HOST_IP}/c$$"
   

3. 正常执行docker-compose up启动即可，每次启动都会自动获取最新IP。

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