解决 WSL2 下 Docker vhdx 磁盘占用过大

在 Windows 下使用 WSL2 后端运行 Docker Desktop 时，由于动态 VHD 磁盘（docker_data.vhdx）的特性，即使我们在 Docker 中删除了大量的无用镜像和容器，宿主机的磁盘空间并不会自动释放。很多时候容器实际占用只有 20 多 G，但宿主机的 .vhdx 文件却可能膨胀到 130G，甚至把 C 盘挤占满。

核心解决方案：直接压缩这个 VHDX

解决这个问题的最根本做法是先关机、然后利用 Windows 的 diskpart 工具手动压缩那个膨胀的虚拟磁盘文件。单纯执行 docker system prune 是不够的，必须真正把 VHD 文件压回去。

1. 清理 Docker 内部垃圾 (可选)

在压缩磁盘之前，最好先把不需要的镜像、僵尸容器彻底抛弃，腾出容器内部空间：

1
2
3
4
5

# 查看空间占用
docker system df

# 清理所有悬空资源、停止的容器和无用的缓存卷
docker system prune -a --volumes

2. 关闭 WSL

清理完毕后，彻底退出 Docker Desktop。为了让 WSL 的 VHDX 脱离挂载使用状态，在 管理员权限的 PowerShell 中运行：

1

wsl --shutdown

3. 压缩磁盘

继续在管理员 PowerShell 中输入 diskpart 进入交互界面，接着依次执行以下命令（需要替换为你本地 .vhdx 的实际路径）：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

# 选择你的 vhdx 文件
select vdisk file="C:\Users\mioyi\AppData\Local\Docker\wsl\disk\docker_data.vhdx"

# 以只读模式挂载
attach vdisk readonly

# 压缩虚拟磁盘（核心操作，该步骤可能需要一点时间）
compact vdisk

# 卸载并退出 diskpart
detach vdisk
exit

执行完毕后，你会发现这块 .vhdx 文件的体积已经明显下降，接近于你现在系统 docker 的实际上层读写占用。之后可以重新打开 Docker Desktop 正常使用了。