Agent Skills
返回列表
Docker Desktop 数据盘迁移

Docker Desktop 数据盘迁移

IT 运维与安全 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_17e82f9b/docker-data-disk-migration。

技能介绍

问题在哪

在 Windows 上装 Docker Desktop 后,镜像、容器层和数据卷都会落在默认路径下的 docker_data.vhdx(常见为 C:\Users\<用户>\AppData\Local\Docker\wsl\disk\docker_data.vhdx)。这个虚拟磁盘往往几十 GB,且 不是稀疏文件——占多少空间就真占多少,C 盘会被持续吃紧。很多人想迁到 D 盘或其它盘,但网上教程多数仍围绕已消失的 docker-desktop-data 分发版,照搬容易走错路。

技能在做什么

技能先让你 识别环境:Docker Desktop 约 4.30+ 若 WSL 里只有 docker-desktop、没有 docker-desktop-data,应走 junction(目录联结) 方案;若仍存在 docker-desktop-data,再用经典的 wsl --export / import 流程。新版只需迁移数据盘 docker_data.vhdx,运行时小的 ext4.vhdx(约 96MB)一般不必搬。

核心原则是 先复制、再对源路径改名兜底、最后建 junction,避免直接删源导致不可恢复。文档里还给验证步骤、常见坑(首次挂载 ERROR_SHARING_VIOLATION、wsl --shutdown 后容器 Exited(255) 等)以及 回滚:数据在目标盘保留副本时,恢复旧目录名即可。

边界与注意

wsl 等命令需在 本机管理员 PowerShell 执行,沙箱或远程助手无法代跑。WorkBuddy 一类环境同样受限,只能由用户执行后把结果交给 AI 核对。迁移窗口期内应停 Docker、关 WSL,并按文档收尾删除 C 盘上的空壳目录,才算真正释放空间。

使用场景

  • C 盘告警后发现 `docker_data.vhdx` 占用 40GB+,要把 Docker 数据迁到 D 盘
  • 升级 Docker Desktop 4.30+ 后 WSL 里没有 docker-desktop-data,需要 junction 方案而非旧 export 教程
  • 迁移后首次启动报 SHARING_VIOLATION 或容器全 Exited,要按文档做 wsl shutdown 与恢复
  • 迁盘完成并验证 compose 正常后,要安全删掉 C 盘原目录空壳释放空间

适合人员

  • 在 Windows 笔记本上长期跑 Docker 开发、C 盘只剩几 GB 的全栈工程师
  • 公司电脑不允许扩 C 盘、只能把个人工具数据放到 D 盘的本地运维
  • 按网上 wsl export 教程失败后、需要区分新版单 distro 与 junction 的 Docker 用户
  • 迁移期间要停服较少、希望有明确回滚步骤再动 `AppData\Local\Docker` 的 SRE