martin/docker-cleanup-volumes

docker-cleanup-volumes

WARNING: 使用风险自负，始终先使用--dry-run参数测试。若与系统或Docker版本不兼容，可能会删除所有卷。

概述

docker-cleanup-volumes是一个Shell脚本工具，用于删除Docker中孤立的卷，清理/var/lib/docker/volumes和/var/lib/docker/vfs/dir目录下不再被任何容器引用的卷。支持Docker 1.4.1至1.10.x版本，帮助维护Docker环境整洁并释放存储空间。

核心功能与特性

• 识别并删除孤立Docker卷（不再被任何容器使用的卷）
• 提供--dry-run参数：模拟删除操作，仅输出将被删除的卷，不实际执行删除
• 提供--verbose参数：输出详细操作信息，便于调试和确认
• 灵活的运行方式：可作为独立脚本运行，也可通过Docker容器运行
• 兼容性：支持Docker 1.4.x至1.9.x版本（Docker 1.9+推荐使用内置命令）

使用场景与适用范围

适用于需要清理Docker环境中冗余存储的场景，特别是在Docker 1.9版本之前的环境中。系统管理员或开发人员可通过该工具定期清理不再使用的卷，避免存储空间浪费。

Docker 1.9及以上版本说明

Docker 1.9及以上版本已内置卷管理命令，可替代此工具。内置命令会删除/var/lib/docker/volumes目录中所有非卷目录，使用前确保该目录中无需要保留的文件：

列出孤立卷

bash
$ docker volume ls -qf dangling=true

清理孤立卷

bash
$ docker volume rm $(docker volume ls -qf dangling=true)

更优的清理方式（Linux系统）

bash
$ docker volume ls -qf dangling=true | xargs -r docker volume rm

注意事项

1. 环境限制：不要在boot2docker、docker machine或任何使用虚拟机运行Docker的工具中直接运行，除非在虚拟机内部执行（即不要从Mac系统直接运行此脚本或Docker命令）。
2. 数据备份：使用前建议备份卷数据，以防脚本与系统不兼容导致数据丢失。
3. 测试建议：首次使用或主机Docker版本升级后，务必先使用--dry-run参数运行，确认脚本正常工作且不会误删不应删除的卷。

使用方法

独立脚本使用

直接运行脚本，支持--dry-run和--verbose参数：

bash
$ sudo ./docker-cleanup-volumes.sh [--dry-run] [--verbose]

• --dry-run：模拟删除，仅输出将被删除的卷
• --verbose：输出详细操作信息

通过Docker容器运行

运行"latest"版本镜像（兼容主机Docker 1.4.x至1.9.x）：

bash
$ docker run -v /var/run/docker.sock:/var/run/docker.sock -v /var/lib/docker:/var/lib/docker --rm martin/docker-cleanup-volumes --dry-run

若/var/lib/docker已符号链接到其他位置，需通过readlink提供实际路径：

bash
$ docker run -v /var/run/docker.sock:/var/run/docker.sock -v $(readlink -f /var/lib/docker):/var/lib/docker --rm martin/docker-cleanup-volumes --dry-run

使用主机Docker二进制文件运行

通过挂载主机Docker二进制文件，确保容器与主机Docker版本一致：

bash
$ docker run -v $(which docker):/bin/docker -v /var/run/docker.sock:/var/run/docker.sock -v $(readlink -f /var/lib/docker):/var/lib/docker --rm martin/docker-cleanup-volumes --dry-run