Docker Cleanup

核心功能：分析Docker容器、镜像、卷、网络及构建缓存的磁盘占用，修剪停止的容器、悬空镜像、未使用的卷和网络，生成HTML报告或JSON输出。典型场景：释放Docker磁盘空间、审计环境健康、定期清理资源。通过命令行参数操作，支持预览分析和强制清理模式，输出含统计表格、资源详情等。

ericlooi504

热度 16.02

最近更新 2026-06-27 15:57:41

分类：开发依赖：代码执行应用场景：DevOps / 数据处理 / 自动化脚本 / 报告撰写

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add docker-cleanup

Metadata

name: docker-cleanup
description: Docker resource cleanup, pruning, and disk usage analysis toolkit. Inspect containers, images, volumes, networks, and build cache usage. Prune stopped containers, dangling images, unused volumes, and orphaned networks. Generate HTML cleanup reports. Use when Codex needs to: (1) Free up Docker disk space, (2) Analyze Docker resource usage, (3) Prune stopped containers and dangling images, (4) Remove unused volumes and networks, (5) Generate Docker cleanup reports, (6) Audit Docker environment health.

Docker Cleanup Toolkit (docker-cleanup)

Analyze, prune, and reclaim disk space from Docker resources with a single command.

Quick start

python3 skills/docker-cleanup/scripts/docker_cleanup.py

Output:

🐳 Docker Engine v26.1.3

Type             Count      Size            Reclaimable    
---------------------------------------------------------------
images           12         2.4GB           856MB          
containers       8          1.1GB           0B             
volumes          4          520MB           320MB          
build cache      15         1.8GB           1.5GB          

CONTAINER ID    NAME                    IMAGE                    STATUS               CREATED     
---------------------------------------------------------------------------------------------------
abc123...       my-app                  node:20                  Up 3 days            2d ago      
def456...       old-db                  postgres:15              Exited (0) 5 days    1w ago      

⚠ Dangling images: 3
  sha256:x1y2 → 450MB
  sha256:p3q4 → 120MB

Commands

Command	Description
`python3 docker_cleanup.py`	Default: analyze only (dry-run, no changes)
`python3 docker_cleanup.py --containers`	Prune stopped containers
`python3 docker_cleanup.py --images`	Prune dangling images
`python3 docker_cleanup.py --volumes`	Prune unused volumes
`python3 docker_cleanup.py --networks`	Prune unused networks
`python3 docker_cleanup.py --all`	Full system prune (all of the above)
`python3 docker_cleanup.py --all --force`	Auto-confirm all pruning
`python3 docker_cleanup.py --json`	JSON output for programmatic use
`python3 docker_cleanup.py --report`	Generate HTML report
`python3 docker_cleanup.py --analyze`	Explicit analysis mode

Typical workflows

1. Quick check (no changes made)

python3 skills/docker-cleanup/scripts/docker_cleanup.py

2. Dangling images cleanup

python3 skills/docker-cleanup/scripts/docker_cleanup.py --images --force

3. Full spring cleaning

python3 skills/docker-cleanup/scripts/docker_cleanup.py --all --force

4. Audit + report

python3 skills/docker-cleanup/scripts/docker_cleanup.py --report
# Creates: docker-cleanup-report-20260515-090500.html

5. Monitor with JSON

python3 skills/docker-cleanup/scripts/docker_cleanup.py --json

Exit codes

0: Success (or no issues found)
1: Docker not running or errors occurred

Requirements

Docker Engine (any recent version)
Python 3.6+ (stdlib only)
Linux / macOS / Windows (WSL)