WSL2 Docker释放磁盘空间

free-docker-space-in-wsl2.blog.md

WSL2 Docker释放磁盘空间

Docker使用久了，会残留很多中间生成的镜像，占用磁盘空间。

要清理Docker镜像，本来是挺简单的，一条命令就搞定了：

docker system prune

但是当在Windows中使用WSL2作为Docker后端引擎的时候，情况就会稍微复杂一些了。

原理

因为WSL2本质上来说是虚拟机，对于每个虚拟机，Windows会创建vhdx后缀的磁盘镜像文件，用于存储其内容，类似于vmdk、vdi，用过虚拟机的同学应该都不陌生。

这种镜像文件的特点是支持自动扩容，但是一般不会自动缩容。因此一旦Docker镜像文件过多，引起镜像扩容，即使再使用docker system prune清理虚拟机中的镜像文件，也不会释放出已经占用的系统磁盘空间了。

解决方案

镜像文件虽然一般不会自动压缩，但是支持手动压缩。

首先寻找到对应的镜像文件，在系统中搜索ext4.vhdx文件，可以搜索到多条记录，Docker对应的镜像文件一般是在C:\Users\<你的用户名>\AppData\Local\Docker\wsl\data\ext4.vhdx这个位置。

找到这个文件之后，进行压缩即可。

首先，删除Docker中的无用镜像：

docker system prune

然后退出Docker Desktop并关停WSL2实例。

wsl --shutdown

最后打开 Windows 中提供的diskpart工具进行压缩

# 代码来自 https://github.com/microsoft/WSL/issues/4699#issuecomment-627133168

diskpart
# open window Diskpart
select vdisk file="C:\Users\<你的用户名>\AppData\Local\Docker\wsl\data\ext4.vhdx"
attach vdisk readonly
compact vdisk
detach vdisk
exit

根据 L53317 的评论，上述diskpart系列命令也可简化为：

Optimize-VHD -Path "path_to_disk.vhdx" -Mode Full

如此操作完成之后，就可以看到磁盘空间已经收回了。

强大，实测有效，感谢

似乎路径双引号内的两个像顿号的上标不应该出现

似乎路径双引号内的两个像顿号的上标不应该出现

谢谢指正，已修复

效果很好，感谢！

貌似可以使用
Optimize-VHD -Path "path_to_disk.vhdx" -Mode Full
应该也是有效果的，这个工具只需要一个命令即可。猜测Optimize-VHD这个工具的内部实现是diskpart，因为用diskpart和用Optimize-VHD时都遇到了相同的“文件被加密，用户没有能力解密”的问题，并且实测这两个命令都可以用来解决类似问题。
参考链接：
https://tkacz.pro/reduce-wsl-and-docker-disks-size/
https://learn.microsoft.com/en-us/powershell/module/hyper-v/optimize-vhd?view=windowsserver2022-ps&viewFallbackFrom=win10-ps

貌似可以使用
Optimize-VHD -Path "path_to_disk.vhdx" -Mode Full
应该也是有效果的，这个工具只需要一个命令即可。猜测Optimize-VHD这个工具的内部实现是diskpart，因为用diskpart和用Optimize-VHD时都遇到了相同的“文件被加密，用户没有能力解密”的问题，并且实测这两个命令都可以用来解决类似问题。
参考链接：
https://tkacz.pro/reduce-wsl-and-docker-disks-size/
https://learn.microsoft.com/en-us/powershell/module/hyper-v/optimize-vhd?view=windowsserver2022-ps&viewFallbackFrom=win10-ps

赞👍

为方便更多人看到，我添加在上文中了

中间可改为
select vdisk file="%USERPROFILE%\AppData\Local\Docker\wsl\data\ext4.vhdx"

这样的话就可以更改为

select vdisk file="%USERPROFILE%\AppData\Local\Docker\wsl\data\ext4.vhdx"
attach vdisk readonly
compact vdisk
detach vdisk
exit

实测好用 感谢

Optimize-VHD -Path "%USERPROFILE%\AppData\Local\Docker\wsl\data\ext4.vhdx" -Mode Full

管理员权限的PowerShell中：
Optimize-VHD -Path $env:USERPROFILE"\AppData\Local\Docker\wsl\data\ext4.vhdx" -Mode Full

有效！感谢！

有用

补充下: compact vdisk 命令出错The requested operation requires that the virtual disk be attached read only.时用detach vdisk再分离一次，然后 compact vdisk

diskpart和optimize都没用，输出都正常，但结束后vhdx的大小完全没变

diskpart和optimize都没用，输出都正常，但结束后vhdx的大小完全没变

有没有提前在 wsl 中执行 docker system prune命令呢？

有效，感谢

没有太大效果， 实测从17g压缩到了14g， 0容器， 实际镜像只有不到4g。还有10g空间被浪费

没有太大效果， 实测从17g压缩到了14g， 0容器， 实际镜像只有不到4g。还有10g空间被浪费

会不会是你本地构建过镜像，有 Build Cache 在，我也是从 16 G 压缩到了 13 G，0 容器 0 镜像，后来清了下 Build Cache 清掉了 11G

先用这条命令 docker builder prune 清 Build Cache 试试，然后再压缩

C盘从剩余3G减小到剩余54G，感谢哈哈哈

没有太大效果， 实测从17g压缩到了14g， 0容器， 实际镜像只有不到4g。还有10g空间被浪费

会不会是你本地构建过镜像，有 Build Cache 在，我也是从 16 G 压缩到了 13 G，0 容器 0 镜像，后来清了下 Build Cache 清掉了 11G

先用这条命令 docker builder prune 清 Build Cache 试试，然后再压缩

确实是构建缓存没有清理

楼主好，我想将ext4.vhdx扩容到1T(因为wsl2的原有容量是256G)，但使用diskpart进行扩容时，遇到了相同的“文件被加密，用户没有能力解密”的问题，请问该如何解决

window上可以卸载dockerdesktop然后重装，看到这条帖子前我是这么干的，哈哈

有效，释放300G!

vhdx跟个弱智一样, 要不是虚拟机无法直接访问显卡, 我宁愿将docker跑在虚拟机上

今天折腾Arch Linux安装到wsl2, 无意间看到一个终极解决方案
wsl --manage Ubuntu --set-sparse true

   --manage <Distro> <Options...>
       更改发行版特定选项。

       选项:
           --set-sparse, -s <true|false>
               将发行版的 vhdx 设置为稀疏，从而允许自动回收磁盘空间。

另外卸载docker for windows, 将docker安装到wsl里面, windows版有坑
从此再也不用隔三岔五的去缩容

本来C盘剩余空间55G 执行完之后剩余54.8G...

感谢！第一次尝试的简化命令，没效果后用的方法一成功了！