清理 Docker 缓存残留镜像应按顺序执行：先删已停止容器，再清悬挂镜像，接着清理未被引用的命名镜像，然后删除孤儿卷，最后清除构建缓存；每步均可预览确认，避免误删。
清理 Docker 缓存残留镜像，关键不是“删得快”，而是“判得准”——既要清掉构建留下的无主层、旧标签镜像和未挂载卷，又不能误删还在用的运行依赖或业务数据。
先识别哪些算“缓存残留镜像”
真正该清的不是所有旧镜像，而是三类明确无关联的资源：
-
悬挂镜像（dangling images）：构建时没打标签，或重打标签后旧层变成
<none>:<none>，在docker images中显示为无名无主； -
未被任何容器引用的命名镜像：比如你 pull 过
redis:7.0和redis:7.2，但当前所有容器（含已退出）都只用7.2，那7.0就属于可清理的“残留”； -
孤儿卷（dangling volumes）：容器删了但卷没删，或创建后从未挂载，
docker volume ls中显示为<none>，且docker volume inspect查不到挂载点或关联容器。
分步执行，避免误删
不推荐直接跑 docker system prune -a --volumes -f ——它会一并删掉你可能还想保留的命名镜像和卷。更稳妥的做法是按依赖顺序清理：
- 先清已停止容器：
docker container prune -f（释放对镜像的隐式引用）； - 再清悬挂镜像：
docker image prune -f（安全，不影响带名镜像）； - 接着清未被引用的命名镜像：
docker image prune -a -f（建议在确认无需回滚后执行）； - 然后清孤儿卷：
docker volume prune -f（确保容器已全删完再运行）； - 最后清构建缓存：
docker builder prune -f（BuildKit 缓存常占数 GB，容易被忽略）。
加过滤或预览，心里更有底
不想盲删？可用这些命令提前确认：
Docker Image Puller
下载
使用 Python 脚本下载 Docker 镜像并打包为 tar 文件。用户说“下载镜像”“拉取镜像”“pull xxx”“帮我下载 nginx 镜像”等时触发。支持 SOCKS5 代理直连（推荐）和国内镜像站加速两种模式。
- 查悬挂镜像：
docker images -f "dangling=true"； - 查所有未被容器使用的镜像（含命名）：
docker image prune -a --dry-run； - 查谁在用某镜像（防 conflict 报错）：
docker ps -a --filter "ancestor=nginx:1.25" --format "{{.ID}} {{.Status}}"； - 查孤儿卷：
docker volume ls -f "dangling=true"。
定时自动清理更省心
把上面命令写成一行脚本，加入 cron 定时任务即可：
每天凌晨 2 点执行（加绝对路径防环境变量缺失）：
0 2 * * * /usr/bin/docker container prune -f && /usr/bin/docker image prune -f && /usr/bin/docker image prune -a -f && /usr/bin/docker volume prune -f && /usr/bin/docker builder prune -f 2>/dev/null
说明：用 && 串联，前一步失败则后续不执行；2>/dev/null 屏蔽错误日志，保持 cron 日志干净。
