Docker Desktop在Windows上默认将WSL2数据存于C盘,需迁移以释放空间;可通过设置界面一键迁移至其他盘符,或手动导出/重导入docker-desktop-data发行版彻底自定义路径,还可配置daemon.json的data-root缓解C盘压力。

在Windows上使用Docker Desktop时,镜像和容器数据默认全堆在C盘用户目录下,随着拉取的镜像增多,【C:Users用户名AppDataLocalDockerwsldataext4.vhdx】这个虚拟磁盘文件会迅速膨胀到几十GB,严重挤压系统盘空间。必须将存储位置迁出C盘,否则后续构建、pull、run操作都可能因磁盘满而失败。
通过Docker Desktop设置界面一键迁移(新手首选)
这一步适合只想快速把数据挪到D盘或F盘、不碰命令行、也不需要定制路径结构的用户。Docker官方原生支持,全程图形化,出错可回退。
退出Docker Desktop:右键任务栏Docker图标 → 选择“Quit Docker Desktop”
启动Docker Desktop → 点击右上角齿轮图标 → Settings → Resources → Advanced
找到“Disk image location”字段,当前显示类似 C:UsersAliceAppDataLocalDockerwsl
点击右侧Browse按钮 → 浏览并选中一个已存在的空文件夹(如 D:docker-wsl),注意:Docker不会自动创建父级目录,D:docker-wsl 必须提前手动建好
点击Apply & Restart → Docker自动关闭WSL、迁移数据、重启服务。首次迁移耗时取决于现有镜像体积,可能持续5–20分钟,期间不要强制关机或中断电源。
手动导出/重导入docker-desktop-data发行版(彻底掌控路径)
当设置界面无法修改(灰色不可点)、Apply后路径未生效、或你明确要求把虚拟磁盘放在NAS挂载点、加密卷、或非NTFS分区时,必须走这条路径。它直接操作WSL2底层发行版,100%决定实际.vhdx存放位置。
第一步:确保Docker完全退出 → 右键托盘图标Quit → 再打开PowerShell(无需管理员权限)执行:wsl --shutdown
第二步:确认目标发行版存在 → 运行 wsl -l -v,输出中必须包含一行:docker-desktop-data Running 2 或 Stopped。若无此行,请勿继续,说明你的Docker Desktop版本异常或已损坏。
Docker Hub (hub.docker.com)。此技能适用于所有 Docker Hub 操作,包括读取、创建、更新和删除数据。只要任务涉及 Docker Hub,就使用此技能。
第三步:导出数据 → 执行:wsl --export docker-desktop-data D:ackupdocker-data.tar。注意:D:ackup目录必须预先创建,且剩余空间 ≥ 当前data.vhdx大小 × 1.3(tar包略大于原始.vhdx)
第四步:注销旧发行版 → wsl --unregister docker-desktop-data。这步【不可逆】,执行后原C盘下的所有镜像、容器、卷立即消失,仅靠上一步的tar包能恢复。
第五步:导入到新位置 → 先创建目标目录(如 D:dockerdata),再运行:wsl --import docker-desktop-data D:dockerdata D:ackupdocker-data.tar --version 2。务必带 --version 2,否则导入为WSL1,Docker Desktop将无法识别。
配置daemon.json指定data-root(仅影响Docker内部路径)
该方法不改变WSL2虚拟磁盘位置,只让Docker引擎把镜像层、overlay2、tmpfs等写入你指定的NTFS路径。适用于已有大量数据不便迁移、又想缓解C盘压力的折中场景。
方法一:编辑daemon.json文件
确保Docker已退出 → 打开路径:C:Users用户名.dockerdaemon.json → 若文件不存在,新建文本文档,另存为该路径,编码选UTF-8 → 写入内容:
{"data-root": "D:\docker-data"}
方法二:用PowerShell快速生成(推荐)
以普通用户身份打开PowerShell → 执行:
$path = "$env:USERPROFILE.dockerdaemon.json"; $json = '{"data-root": "D:\docker-data"}'; New-Item -Path $path -Force | Out-Null; Set-Content -Path $path -Value $json -Encoding UTF8
保存后重启Docker Desktop。验证是否生效:打开终端运行 docker info | findstr "Docker Root Dir",输出应为 Docker Root Dir: D:docker-data

















