docker/desktop-reclaim-space

Docker Desktop空间回收工具

镜像概述

Docker Desktop空间回收工具是一款轻量级工具，专为释放Docker Desktop虚拟机（VM）占用的磁盘空间而设计。在Windows和macOS系统中，Docker Desktop运行于独立虚拟机内，长期使用后易因未清理的镜像、容器、卷及日志文件导致磁盘空间过度占用。本工具通过自动化清理流程，帮助用户安全释放闲置资源，优化磁盘空间利用率。

核心功能

• 闲置资源清理：自动识别并删除未引用的Docker镜像、停止的容器、孤立卷及构建缓存
• 虚拟机磁盘压缩：对Docker Desktop VM磁盘文件（如.qcow2/.vmdk）进行压缩，释放文件系统碎片及已删除数据残留空间
• 安全操作机制：默认仅清理无风险闲置资源，避免误删活跃容器或关键数据
• 轻量级设计：镜像体积小、启动快速，无复杂依赖，支持即插即用

使用场景

• Docker Desktop磁盘占用过高导致系统磁盘空间不足
• 通过Docker Desktop仪表盘观察到"磁盘使用"指标异常（已用空间远高于实际必要资源）
• 系统提示磁盘空间不足，且排查发现Docker相关目录（如C:\ProgramData\DockerDesktop或~/Library/Containers/com.docker.docker）占用大量空间
• 作为定期维护任务，防止磁盘空间长期过度占用

使用方法

基础使用

通过以下命令执行完整空间回收流程：

bash
docker run --rm -v /var/run/docker.sock:/var/run/docker.sock [镜像名称]

说明：--rm确保容器运行后自动删除；-v /var/run/docker.sock:/var/run/docker.sock挂载Docker守护进程套接字，实现与Docker Desktop通信

自定义清理选项

可通过命令行参数指定清理范围：

• 仅清理未使用镜像和容器：

  bash
  docker run --rm -v /var/run/docker.sock:/var/run/docker.sock [镜像名称] --clean-images --clean-containers
  

• 模拟清理（仅显示操作，不实际删除资源）：

  bash
  docker run --rm -v /var/run/docker.sock:/var/run/docker.sock [镜像名称] --dry-run
  

• 压缩虚拟机磁盘（需额外权限，仅支持macOS/Windows）：

  bash
  docker run --rm --privileged -v /var/run/docker.sock:/var/run/docker.sock -v /path/to/docker/vm:/vm [镜像名称] --compress-vm
  

  注意：--privileged可能需根据系统安全策略调整；/path/to/docker/vm需替换为实际VM存储路径（macOS通常为~/Library/Containers/com.docker.docker/Data/vms/0/）

配置说明

环境变量

• DOCKER_CLEAN_THRESHOLD：设置闲置资源清理阈值（天），默认30天（仅清理超过30天未使用资源）

  bash
  docker run --rm -e DOCKER_CLEAN_THRESHOLD=14 -v /var/run/docker.sock:/var/run/docker.sock [镜像名称]
  

• LOG_LEVEL：控制日志详细程度，可选值：info（默认）、debug（详细调试信息）、quiet（仅显示关键信息）

  bash
  docker run --rm -e LOG_LEVEL=debug -v /var/run/docker.sock:/var/run/docker.sock [镜像名称]
  

命令行参数说明