Docker 容器清理工具

功能说明

一款命令行工具，用于清理 Docker 资源以释放磁盘空间。支持以下操作：

• 列出并删除已停止的容器
• 删除悬空镜像（即未打标签的镜像）
• 删除未被任何容器使用的镜像
• 删除未被使用的卷（volumes）
• 删除未被使用的网络（networks）
• 执行“全部清理”操作（等同于 docker system prune）

该工具默认启用安全、交互式模式：在执行任何删除操作前，会明确列出将被移除的资源，并请求用户确认。

适用场景

• Docker 占用的磁盘空间持续增长，需主动释放空间
• 存在大量已停止且不再需要的容器
• 存在老旧、未被使用的镜像，占用大量磁盘空间
• 希望以可控、安全的方式清理 Docker 资源
• 需要在脚本或 CI/CD 流水线中自动化执行 Docker 清理任务

使用方法

交互式清理（首次使用推荐）：

python3 scripts/main.py clean

仅删除已停止的容器：

python3 scripts/main.py clean --containers

仅删除悬空镜像：

python3 scripts/main.py clean --images --dangling

删除未被使用的镜像（即所有未被任何容器引用的镜像）：

python3 scripts/main.py clean --images --unused

删除未被使用的卷：

python3 scripts/main.py clean --volumes

删除未被使用的网络：

python3 scripts/main.py clean --networks

强制清理（跳过确认步骤）：

python3 scripts/main.py clean --all --force

模拟运行（仅显示将被清理的资源，不实际执行删除）：

python3 scripts/main.py clean --all --dry-run

示例

示例 1：交互式清理

python3 scripts/main.py clean

输出：

Docker Cleanup Tool
===================

Found resources:
- Stopped containers: 3 (using 1.2GB)
- Dangling images: 5 (using 850MB)
- Unused images: 2 (using 450MB)
- Unused volumes: 1 (using 100MB)
- Unused networks: 0

Total disk space that can be freed: 2.6GB

What would you like to clean up?
1. Remove stopped containers
2. Remove dangling images
3. Remove unused images
4. Remove unused volumes
5. Remove unused networks
6. All of the above
7. Cancel

Enter choice [1-7]: 2

About to remove 5 dangling images (850MB):
- python:3.9-alpine (dangling)
- node:16-slim (dangling)
- ...

Are you sure? (y/N): y
Removing images...
✅ Cleanup complete! Freed 850MB of disk space.

示例 2：面向脚本的 JSON 输出

python3 scripts/main.py status --format json

输出：

{
  "containers": {
    "running": 2,
    "stopped": 3,
    "stopped_size_mb": 1200
  },
  "images": {
    "total": 15,
    "dangling": 5,
    "dangling_size_mb": 850,
    "unused": 2,
    "unused_size_mb": 450
  },
  "volumes": {
    "total": 4,
    "unused": 1,
    "unused_size_mb": 100
  },
  "networks": {
    "total": 3,
    "unused": 0
  },
  "total_reclaimable_mb": 2600
}

运行要求

• Python 3.x
• Docker：必须已安装，且 Docker daemon 正在运行
• Docker CLI：必须已安装并位于系统 PATH 中（可直接执行 docker 命令）
• Docker SDK for Python：非必需，但建议安装以获得更优性能

安装 Docker SDK for Python（可选）：

pip install docker

限制与注意事项

• 本工具为命令行工具，非自动集成插件
• 依赖 Docker daemon 正常运行且可访问
• 部分操作需提升权限（如使用 sudo）
• 无法清理正在被运行中容器使用的资源
• 镜像大小估算为近似值，可能存在偏差
• 若网络或卷正被使用，其清理操作可能失败
• 不清理 Docker 构建缓存（请使用 docker builder prune）
• 不自动清理 Docker Compose 相关资源
• 性能受本地 Docker 资源数量影响
• 大规模清理操作可能耗时较长