Windows WSL环境Docker如何设置容器可写层最大存储限制

你遇到的报错来自两个核心问题，和Windows/WSL环境本身没有直接冲突：

• 命令语法错误：docker run的所有运行参数必须放在镜像名之前，你当前写法中ubuntu:latest之后的所有内容都会被识别为容器内的启动命令，不会传给Docker daemon；另外你用的--mem_limit、--storage_opt是废弃的下划线格式参数，当前版本Docker需要使用--memory、--storage-opt的中划线格式。
• 原生存储配额的依赖要求：--storage-opt size=xxx的硬配额能力，仅支持运行在带pquota挂载选项的XFS文件系统上的overlay2存储驱动。这个配置属于WSL2（Docker实际运行的后端宿主机）层面的存储配置，既不是Windows宿主系统配置，也不是容器镜像层面的配置。你之前直接修改Docker Engine的storage-driver配置导致崩溃，是因为Docker Desktop默认在WSL2中使用的虚拟磁盘是ext4格式，直接切换驱动没有匹配的底层存储后端，自然会启动失败。

这个方案和Linux环境下的原生能力完全一致，配额是文件系统级别的硬限制，容器写入超出配额会直接返回磁盘满错误，步骤如下：

1. 完全退出Docker Desktop，在PowerShell中执行wsl --shutdown关闭所有运行中的WSL实例。
2. 创建用于Docker数据存储的XFS专用虚拟磁盘：在PowerShell中执行以下命令创建动态扩展的vhdx虚拟磁盘文件，路径和大小可以按需调整：

   New-VHD -Path D:\docker-xfs-data.vhdx -SizeBytes 50GB -Dynamic
   

3. 打开WSL2终端，完成磁盘格式化和挂载配置：

   # 创建挂载目录
   sudo mkdir -p /mnt/docker-xfs
   # 挂载刚才创建的虚拟磁盘到WSL
   sudo wsl --mount D:\docker-xfs-data.vhdx --bare
   # 执行lsblk查看新挂载的磁盘设备名，一般是最后一项，比如/dev/sdc
   lsblk
   # 将磁盘格式化为支持reflink的XFS文件系统，注意替换sdX为你实际查到的设备名
   sudo mkfs.xfs -f -m reflink=1,rmapbt=1 /dev/sdX
   # 以pquota模式挂载分区到目标目录
   sudo mount -o pquota /dev/sdX /mnt/docker-xfs
   

4. 打开Docker Desktop，进入Settings -> Docker Engine配置页，在配置JSON中添加数据根目录配置，保留默认的overlay2存储驱动不要修改：

   {
     "data-root": "/mnt/docker-xfs",
     "storage-driver": "overlay2"
     // 其余原有配置保持不变
   }
   

   保存配置后重启Docker Desktop等待初始化完成。
5. 使用正确语法启动带存储配额的容器：

   docker run -it --memory 100m --name xyz --storage-opt size=100m ubuntu:latest
   

   启动后进入容器执行df -h /即可看到根分区可用空间为100M。后续调整配额只需要在新建容器时修改size参数值即可，已创建的容器可以通过修改对应容器的hostconfig.json文件调整配额，重启Docker后生效。

如果只是测试场景需要限制容器写入，不想调整Docker全局存储配置，可以用以下方式实现类似效果：

• 固定大小卷挂载：提前创建指定大小的镜像文件，格式化为ext4后作为loop设备挂载，启动容器时将这个设备绑定挂载到容器的可写路径（比如/root、/app等业务写入目录），写入超出镜像大小就会报错。
• 目录配额限制：如果只需要限制绑定挂载的宿主机目录/命名卷的大小，可以直接在WSL2中对对应目录使用ext4/XFS的项目配额能力，不需要修改Docker的全局存储配置。
• 监控触发限流：通过cgroup v2统计容器的磁盘写入量，配合简单的监控脚本，当容器磁盘占用达到阈值时自动暂停容器，适合不需要硬阻断的场景。

内容的提问来源于stack exchange，提问作者Jack Hales