企业官网建设流程全解析

1. 迁移前先搞清楚：为什么C盘会被Docker Desktop吃满

先直接给结论：Docker Desktop 本体安装包其实不大，真正让你C盘飘红的，是它基于WSL2创建的两个虚拟发行版，以及里面那块只增不减的 ext4.vhdx 虚拟磁盘。所以“wsl的Docker Desktop从C盘迁移出”这件事，本质上不是把安装目录改个位置那么简单，而是要把 WSL2 后端对应的虚拟磁盘从 C 盘整体搬到其他分区，方向对了，后续操作才不会白费。

1.1 WSL2虚拟磁盘的工作机制

Docker Desktop for Windows 一旦开启 WSL2 后端，就会在系统里注册两个 WSL 发行版，一个叫docker-desktop，一个叫docker-desktop-data。前者放的是运行 Docker 引擎所需的程序文件，后者才是真正的“仓库重地”——你拉下来的所有镜像、跑起来的容器、创建的卷、构建缓存，全部存在这个发行版的 ext4.vhdx 虚拟磁盘里。

这两个发行版的默认存储路径在%LOCALAPPDATA%\Docker\wsl\下，展开看就是C:\Users\你的用户名\AppData\Local\Docker\wsl\data\ext4.vhdx和同目录下的distro\ext4.vhdx。很多人以为清理 Docker 就是卸掉不用的镜像，实际上镜像删掉之后，vhdx 并不会自动把空出来的空间还给C盘，它跟普通文件夹不一样，更像一个膨胀起来就缩不回去的气球。平时拉镜像、跑构建、挂载卷的时候它不断变大，等你以为清理干净了，C盘占用却纹丝不动，这种感觉我太熟悉了。

还有一点容易被忽略：默认情况下 vhdx 按需扩容，可能实际数据只有 20GB，文件已经涨到 40GB。如果你从没做过 compcat，那 C 盘里的空间很大程度是被“预分配加未回收”占了。迁移时如果只复制镜像文件，或者只改安装目录，大概率只解决了一半问题。

1.2 先确认现场：三条命令定位真实占用

动手之前，我建议先花五分钟看看现场，否则你根本不知道要搬多大的东西，也不知道搬完之后C盘究竟能省多少。

第一步，打开终端输入wsl -l -v，确认当前机器上有哪几个发行版。正常情况下你能看到docker-desktop和docker-desktop-data，State 是 Stopped 或 Running。注意看版本号，新版 Docker Desktop 的发行版名称可能略有变化，后面所有操作都以你机器上实际列出来的名字为准。

第二步，在 PowerShell 里跑这样一段命令，直接算出 Docker 在AppData\Local\Docker\wsl下占用多大：

Get-ChildItem "$env:LOCALAPPDATA\Docker\wsl" -Recurse -File | Measure-Object -Property Length -Sum | ForEach-Object { '{0:N2} GB' -f ($_.Sum / 1GB) }

这一步能让你直观看到C盘到底被 Docker 吃了多少，也方便后面预估备份占用的临时空间。

第三步，在普通终端里执行docker system df，它会按 Images、Containers、Local Volumes、Build Cache 分类显示占用。如果看到一堆 “dangling images” 和巨大的 Build Cache，那说明迁移前还有一波清理可以做，清完之后导出的 tar 会小很多，迁移也会快不少。

1.3 迁移方案选型：GUI、WSL命令还是软链接

目前几种主流迁移方式我都试过，简单列个对比：

我个人最常用的是导出-注销-导入，原因很简单：它不依赖 Docker Desktop 的具体版本，每一步都看得见、可回滚，而且导出的 tar 本身就是一份完整备份。万一新环境起不来，也好排查。如果你 WSL 版本够新，wsl --manage --move确实是体验最好的，后面我会把两条路线都写清楚。

2. 动手迁移前的准备：备份、清理与工具

很多人一听说要迁移，第一反应就是直接去AppData\Local\Docker\wsl把文件夹复制到 D 盘。这个操作我在早期踩过坑：文件复制过程中 Docker 进程可能还在读写，复制出来的 vhdx 不一定一致，重新导入后数据损坏的情况不是没有。更稳妥的做法是先让 Docker 彻底停止，再用 WSL 自带的导出机制生成 tar 备份。

2.1 备份思路：导出tar而不是直接复制vhdx

为什么要导出 tar？因为 vhdx 是正在使用的虚拟磁盘格式，即使 Docker 已经退出，WSL 发行版可能还处于挂载状态。直接复制文件，复制出来的副本可能有脏数据。而wsl --export会用 WSL 自己的机制把整个发行版打包成 tar，这个包可以二次检校，也能直接用wsl --import恢复。

在你准备迁移的磁盘上建一个备份目录，比如D:\docker-migrate，确认它至少有当前 Docker 数据大小加上 10%~20% 的余量。导出的命令很简单：

wsl --export docker-desktop-data D:\docker-migrate\docker-desktop-data.tar

如果你的数据有几十 GB，这一步会跑二三十分钟以上，期间看起来像卡住，其实是在打包。旁边开着资源管理器看 tar 文件大小有没有持续增长就行，只要它在变大就说明正常。愿意等的话，可以顺手把docker-desktop也导出来，虽然它通常只有一两 GB，但保险起见一起搬比较干净。

这里强调一下：导出前先执行wsl --shutdown，确保所有发行版都处于停止状态。如果机器上有其他正在使用的 WSL 发行版，这条命令会把它们也关掉，事先保存好工作区内容。

2.2 迁移前做一次有节制的瘦身

既然迁移过程主要耗在打包和解包，那提前把垃圾清掉就很有必要。我是这样操作的：

先跑docker system df看看各项占用，然后根据情况执行：

docker system prune -f docker builder prune -f

第一句会清理所有已停止的容器、未被使用的网络、dangling 镜像和构建缓存，默认不动本地卷，比较安全。第二句是专门清 Build Cache 的，这个项目平时最容易偷偷膨胀。如果你已经确定容器里的数据都不需要保留，也可以加上-a把所有未使用镜像一起清掉，但我不建议迁移前做太激进的清理，毕竟一会儿还要拿旧环境做验证。

清理完再看一眼docker system df，你会发现可用空间瞬间多出不少，导出 tar 的速度也会明显加快。有个细节：如果你平时习惯用docker logs看容器日志，注意检查有没有巨型日志文件，它们也占在 vhdx 里。

2.3 工具清单与前置检查

迁移过程中会用到的工具其实就是 Windows 自带的终端和 PowerShell，不需要额外装软件。但有几点环境确认必须提前做，不然容易白等半天：

• 确认目标盘是 NTFS 格式，且盘符固定。如果你把数据放在移动硬盘上，哪天忘记插盘，Docker 启动就直接失败。
• 确认当前 WSL 版本。执行wsl --version，如果能看到版本号，并且执行wsl --manage --help时列出了--move选项，说明你走方案一没问题。
• 某些命令需要管理员权限，特别是涉及 vhdx 压缩时。建议直接以管理员身份打开 Windows Terminal，省得中途权限不足又得重来。
• 确认 Docker Desktop 已经彻底退出。不只关窗口，要右键托盘图标选择 Quit，否则后面wsl --unregister会报“正在使用中”。

3. 实战迁移：三种方法按需选择

3.1 最快的一条路：wsl --manage --move

如果你的 WSL 是较新版本，迁移这事就简单到令人怀疑是不是搞错了。

第一步，退出 Docker Desktop，然后执行：

wsl --shutdown

第二步，在磁盘上创建目标目录，比如D:\Docker\wsl\data和D:\Docker\wsl\distro，然后逐个搬：

wsl --manage docker-desktop-data --move D:\Docker\wsl\data wsl --manage docker-desktop --move D:\Docker\wsl\distro

这里要注意，--move后面接的是目录，不是 vhdx 文件的完整路径。命令执行完，WSL 会把对应发行版的虚拟磁盘整体搬到新位置，并在原位置解除占用。

第三步，重新打开 Docker Desktop，等它启动完成，再执行wsl -l -v确认两个发行版状态正常。此刻你再到D:\Docker\wsl下看一眼，会看到ext4.vhdx已经躺在那里了。

这个方案唯一的坑在于，有些早期 WSL 版本不支持--manage --move，会提示缺少该命令或版本过旧。遇到这个提示别纠结，直接跳到下面的导出导入方案。

3.2 最通用的老办法：导出-注销-导入三步走

这条路线我走了很多次，适合所有版本，每一步都可控。核心思路是把发行版打包、用--unregister注销掉、再用--import引入到新位置。

先建好工作目录：

mkdir D:\docker-migrate mkdir D:\Docker\wsl\data mkdir D:\Docker\wsl\distro

接着让 Docker 和 WSL 全部停止：

wsl --shutdown

然后分别导出两个发行版。导docker-desktop-data时会比较久，耐心等：

wsl --export docker-desktop-data D:\docker-migrate\docker-desktop-data.tar wsl --export docker-desktop D:\docker-migrate\docker-desktop.tar

导出完成后，我习惯先用资源管理器确认 tar 文件大小合理。如果 tar 只有几百 MB，那多半是导错了对象，或者 Docket 数据本来就不在这里。

接下来是关键一步，注销两个发行版：

wsl --unregister docker-desktop-data wsl --unregister docker-desktop

执行完这条命令，系统会提示“正在注销”，然后这两个发行版就从 WSL 列表里消失了。别慌，你的数据还在刚才的 tar 包里面。如果这一步没做干净，导入时很容易出现同名冲突。

然后在新位置重新导入，注意一定要带--version 2：

wsl --import docker-desktop-data D:\Docker\wsl\data D:\docker-migrate\docker-desktop-data.tar --version 2 wsl --import docker-desktop D:\Docker\wsl\distro D:\docker-migrate\docker-desktop.tar --version 2

--version 2的作用是强制把发行版以 WSL2 模式注册。如果不加，部分环境下可能默认成 WSL1，Docker Desktop 启动时会直接报错。导入完成后再执行wsl -l -v，如果看到两个发行版名字还在，且状态正常，就可以启动 Docker Desktop 了。

这个方法最稳，也是我踩过一堆坑之后最终固定下来的方案。唯一的缺点是慢，导出加导入的时间基本等于你的数据量除以硬盘写入速度，几十 GB 的数据可能要花一两个小时。

3.3 最省事的GUI路径：Docker Desktop内置磁盘位置

如果你不想敲命令，新版 Docker Desktop 自带磁盘迁移入口。打开软件后进入 Settings，切到 Resources 下面的 Advanced，里面有一项 Disk image location，默认是C:\Users\xxx\AppData\Local\Docker\wsl\data\ext4.vhdx这种路径。

直接点 Browse，把位置改到 D 盘的具体目录，然后 Apply & Restart。Docker Desktop 会自己执行拷贝和重新挂载，界面上会有进度。整个过程不需要处理发行版注册，也不用管 tar，属于小白最友好的一条路。

但它的局限性也要说清楚：部分旧版本里这个选项位置不一样，甚至没有；另外有些版本改了 Disk image location 之后，只搬了数据盘，docker-desktop运行盘还在 C 盘，虽然影响不大，但如果你追求彻底，还是命令行方案更完整。

3.4 软链接偏方：只适合应急的场景

还有一种野路子，是直接把%LOCALAPPDATA%\Docker\wsl目录整体挪到 D 盘，在原来的位置建立一个目录联接（junction）。操作用管理员权限的 cmd 执行：

mklink /J "C:\Users\你的用户名\AppData\Local\Docker\wsl" "D:\Docker\wsl"

设置好之后，Docker Desktop 以为数据还在 C 盘，实际落到了 D 盘，系统层面的兼容性确实能行。但我不推荐把这个当长期方案，原因是 Docker Desktop 更新频繁，新版本有时会改成别的存储路径，或者更新过程直接把联接删除再重建真实目录，到时候新旧数据分家，排查起来很费劲。应急用一下可以，稳定使用还是走官方支持的迁移方式。

4. 迁移后的验证、压缩与问题排查

搬完不是结束，恰恰是容易翻车的地方。我见过不少朋友迁移后 Docker Desktop 图标能点开，但docker ps报错，或者镜像列表空空如也，这些基本都是验证环节跳过导致的。

4.1 迁移后验证清单

启动 Docker Desktop 后，别急着跑业务，先按以下顺序逐项确认：

• 执行wsl -l -v，确认两个发行版都在，并且 Version 列显示是 2；
• 执行docker info，看 Server 部分是否有错误；如果看到类似 “error during connect” 的提示，说明引擎没起来；
• 执行docker images，镜像列表应该和迁移前一模一样；
• 执行docker ps -a，看原来的容器还在不在，虽然它们现在多半是停止状态；
• 在资源管理器地址栏输入\\wsl$\docker-desktop-data\var\lib\docker，应能看到 volumes、image 等目录，证明数据真的被新环境挂载上了。

全部通过后，再跑一次docker run hello-world或者启动你的业务容器做实际验证。注意容器不会因为你迁移了就自动启动，需要手动docker start或重新docker compose up -d。

4.2 别让C盘继续膨胀：vhdx压缩与日常维护

迁移成功之后，你可能会发现 C 盘空出来的空间没有想象中多，原因就是 vhdx 文件在长期使用中内部产生了大量空洞，删除数据时那些空洞没有自动释放。想真正收回空间，需要手动 compact。

先在 PowerShell 里以管理员身份执行：

wsl --shutdown Optimize-VHD -Path "D:\Docker\wsl\data\ext4.vhdx" -Mode Full

如果你的系统没有 Hyper-V 模块，会提示 Optimize-VHD 不是可识别的命令，这时候改用 diskpart 也能达到同样效果：

diskpart select vdisk file="D:\Docker\wsl\data\ext4.vhdx" attach vdisk readonly compact vdisk detach vdisk exit

compact 过程也可能要几分钟到十几分钟，跑完之后你会发现 C 盘占用明显下降。之后的日子，我建议定期做两件事：每隔一段时间执行一次docker system prune清理 dangling 镜像和构建缓存，每个月左右做一次 vhdx 压缩。另外镜像不要无节制地堆在本地，用不到的镜像及时清理，这比任何优化技巧都管用。

4.3 迁移翻车实录：常见问题与解决速查

结合自己踩过的坑，我把迁移中最常见的问题整理成一张速查表，方便你对症处理：

最后一个问题，也是我踩过最惨的一次：迁移完后着急删了 tar 备份，结果第二天 Docker Desktop 启动异常，想回滚都没有余地。所以我的习惯是迁移成功并稳定运行至少一周后，才删掉D:\docker-migrate里的 tar 文件。留着它占不了多少空间，关键时候能救命。

现在我自己手边机器的固定流程已经固化成一条命令链：先docker system df看占用，再wsl --export导出，wsl --unregister注销，wsl --import导入，最后验证和 compact。用熟练之后整套操作也就半小时以内，麻烦的只是等待时间。如果你机器上 WSL 版本够新，直接wsl --manage --move更是两三分钟解决战斗。迁移这件事本身不复杂，复杂的是迁移前的判断和迁移后的验证，这两步做到位，基本不会再被 C 盘告急追着跑了。