VS2019调试Docker Linux容器时挂载Windows共享盘为Volume报错如何解决

根因说明 #

报错是因为Docker Daemon无法识别用户态映射的网络盘符Z，且默认没有权限访问Windows SMB网络共享路径，尝试自动创建挂载根目录时被系统拦截。

分步解决方法 #

• 步骤1：替换盘符为UNC路径 #

  网络驱动器盘符Z是当前用户登录后才映射的，Docker后台服务默认无法识别，需要将配置中的路径替换为原始UNC路径，修改项目文件配置为：

  <PropertyGroup>
      <DockerfileRunArguments>-v "\\10.29.100.22\foldershare\myfolder:/mnt/"</DockerfileRunArguments>
  </PropertyGroup>
  

• 步骤2：配置Docker文件共享权限 #

  打开Docker Desktop设置，进入「Resources」-「File Sharing」：

  1. 点击「+」添加SMB共享的根路径\\10.29.100.22\foldershare
  2. 勾选「Allow mounting Windows network shares」选项（部分版本显示为Enable SMB sharing）
  3. 点击「Apply & Restart」保存配置重启Docker

• 步骤3：修改Docker服务运行账户（可选，上述步骤无效时操作） #

  Docker默认用系统本地账户启动，没有SMB共享访问权限，可手动修改服务账户：

  1. 按Win+R输入services.msc打开服务管理器
  2. 找到「Docker Desktop Service」右键点击「属性」
  3. 切换到「登录」选项卡，选择「此账户」，输入你平时访问该SMB共享的Windows账号密码
  4. 重启Docker服务生效

• 步骤4：WSL2后端专属适配（如果使用WSL2作为Docker运行后端） #

  WSL2默认无法直接访问Windows SMB共享，需要先手动挂载到WSL2中再映射到容器：

  1. 打开WSL2终端，执行命令创建挂载目录：sudo mkdir /mnt/myfolder
  2. 执行挂载命令，替换为你自己的共享账号密码：

     sudo mount -t cifs //10.29.100.22/foldershare/myfolder /mnt/myfolder -o username=你的Windows用户名,password=你的Windows密码,uid=1000,gid=1000
     

  3. 修改项目配置，挂载WSL2内的路径：

     <PropertyGroup>
         <DockerfileRunArguments>-v "/mnt/myfolder:/mnt/"</DockerfileRunArguments>
     </PropertyGroup>
     

验证方法 #

修改完成后先在Windows终端执行以下命令验证挂载是否正常，无报错且能列出共享目录内文件即可回到VS启动调试：

docker run --rm -v "\\10.29.100.22\foldershare\myfolder:/mnt/" alpine ls /mnt

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