Windows用Docker挂载本地目录方法

在Windows上使用Docker实现容器与宿主机目录的高效读写，关键在于正确配置绑定挂载（如`-v C:/path:/container/path`）或命名卷，并妥善处理驱动器共享、路径格式（正斜杠+驱动器前缀）、空格/中文字符兼容性及权限问题；本文手把手教你避开常见报错（如“drive has not been shared”或“Permission denied”），覆盖从开发调试到生产持久化的完整实践路径，助你轻松打通Windows本地文件与Docker容器之间的数据桥梁。

如果您在Windows系统中使用Docker运行容器，但希望容器能直接读写宿主机上的指定文件夹，则需要通过卷（volume）或绑定挂载（bind mount）方式将本地目录映射进容器。以下是实现该目标的具体操作步骤：

一、使用绑定挂载（Bind Mount）方式映射本地目录

绑定挂载允许您将Windows主机上的任意文件夹路径直接映射为容器内的一个目录，适用于开发调试场景，且路径变更实时可见。注意：Windows路径需转换为Docker可识别格式，并确保Docker Desktop已启用WSL2后端或Hyper-V虚拟化支持。

1、打开PowerShell或命令提示符，确认Docker服务正在运行：docker info。

2、创建本地测试目录，例如在C盘根目录下新建文件夹：C:\mydata。

3、执行docker run命令，使用-v参数指定挂载关系，注意路径分隔符需用正斜杠并添加驱动器前缀：docker run -it -v C:/mydata:/app ubuntu:22.04。

4、进入容器后，执行ls /app可查看到C:\mydata下的文件；在容器内向/app写入文件，宿主机C:\mydata中将同步出现。

二、使用命名卷（Named Volume）配合初始数据复制

命名卷由Docker管理，具备跨平台兼容性与自动权限适配能力，虽不直接暴露宿主机路径，但可通过临时绑定挂载方式初始化内容，适合需要持久化且避免路径硬编码的场景。

1、创建命名卷：docker volume create myvol。

2、启动一个临时容器，将本地目录内容复制进该卷：docker run --rm -v C:/mydata:/src -v myvol:/dst alpine cp -r /src/. /dst/。

3、运行目标容器并挂载该命名卷：docker run -it -v myvol:/app nginx:alpine。

4、容器内/app目录即为myvol卷内容，修改后数据由Docker守护进程持久保存，重启容器仍保留。

三、通过Docker Desktop设置共享驱动器（仅限Windows Pro/Enterprise）

若使用Docker Desktop for Windows，默认情况下C盘以外的驱动器不可被挂载。必须先在GUI中显式授权，否则绑定挂载会报错“drive has not been shared”。

1、右键任务栏Docker图标，选择Settings。

2、进入Resources → File Sharing页面。

3、点击+ Add a share，输入要共享的完整路径，如D:\projects，然后点击Apply & Restart。

4、重启完成后，在命令行中即可使用该路径进行绑定挂载：docker run -v D:/projects:/workspace python:3.9。

四、处理Windows路径空格与特殊字符问题

当本地目录路径包含空格、括号或中文时，Docker命令可能解析失败，需采用转义或引号包裹策略以确保路径完整性。

1、对含空格路径使用双引号包裹整个-v参数：docker run -v "C:/My Documents/data":"/data" busybox ls /data。

2、避免使用中文路径名；若必须使用，确保Windows系统区域设置为UTF-8，并在PowerShell中启用$OutputEncoding = [System.Text.Encoding]::UTF8。

3、检查路径是否存在：在执行命令前，先运行dir C:\My Documents\data确认路径可访问且非隐藏属性。

五、验证挂载是否生效及排查常见错误

挂载后需确认容器内路径权限、内容可见性及读写能力，部分错误源于SELinux模拟限制（WSL2）、NTFS权限继承或Docker版本差异。

1、进入运行中的容器：docker exec -it sh。

2、检查挂载点状态：mount | grep app 或 findmnt /app。

3、测试写入权限：echo "test" > /app/hello.txt && ls -l /app/，若提示Permission denied，需添加:rw后缀或改用:z标签（仅WSL2）。

4、若提示invalid argument，检查Docker Desktop是否已更新至v4.15以上，旧版本对长路径支持不佳。

本篇关于《Windows用Docker挂载本地目录方法》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！