Golang轻量镜像清理工具通过Docker API安全精准清理：跳过有标签、被运行容器引用或7天内创建的镜像，优先删悬空镜像；支持dry-run、keep-days、repo-prefix等控制参数，记录日志与释放空间统计，避免误删。
用 Golang 写个轻量、可控的镜像清理工具，比直接敲 docker system prune -a 更安全、更精准——关键在于：只删明确过期/未被使用的镜像，保留带标签的、正在运行容器依赖的、或最近几天拉取过的镜像。
识别哪些镜像该清理
清理前先“看清楚”，避免误删。Golang 可调用 Docker API（推荐）或解析 docker images 命令输出（简单场景可用）：
- 跳过有 tag 且不是
: - 跳过被任意运行中容器引用的镜像（通过
docker ps --format '{{.Image}}'或 API 获取容器列表比对） - 跳过创建时间在 N 天内的镜像（比如 7 天内拉取/构建的，用
Created时间戳判断） - 优先清理悬空镜像（dangling=true），它们是构建缓存残留或旧层，无 tag 也无容器引用
用 Docker Engine API 安全操作
比 exec.Command 调 shell 更稳定、可读性更好。引入官方 SDK：github.com/docker/docker/api/types 和 github.com/docker/docker/client
- 初始化 client：用
client.NewClientWithOpts(client.FromEnv, client.WithAPIVersionNegotiation()) - 列出镜像：
cli.ImageList(ctx, types.ImageListOptions{All: true})，拿到每张镜像的 ID、RepoTags、Created、Size 等 - 检查是否 dangling：
len(img.RepoTags) == 1 && img.RepoTags[0] == ": " - 删除镜像：
cli.ImageRemove(ctx, img.ID, types.ImageRemoveOptions{Force: false, PruneChildren: true})，设Force: false让它自动跳过被引用的镜像，更安全
加点实用控制逻辑
真正落地时，需要开关和确认机制，避免“一键删光”：
立即学习“go语言免费学习笔记（深入）”；
- 命令行支持 flag：如
-dry-run（只打印将删哪些）、-keep-days 7、-include-dangling - 统计清理收益：删前记录总大小，删后再次统计，最后输出 “释放 XXX MB”
- 失败不中断：某镜像删失败（比如被占用），记录 warn 日志继续下一个，别 panic
- 支持按仓库名过滤：如
-repo-prefix "myapp"，只清理自己项目相关的临时镜像
部署成定时任务很简单
编译为单二进制（GOOS=linux GOARCH=amd64 go build -o docker-clean），扔进服务器 crontab：
0 3 * * * /opt/bin/docker-clean -keep-days 5 -include-dangling -log-file /var/log/docker-clean.log >> /dev/null 2>&1
配合 systemd timer 或 GitHub Actions（CI 构建后自动清理构建节点）也很自然。不需要额外依赖，一个二进制 + Docker daemon 就够了。
基本上就这些。不复杂但容易忽略的是：别绕过 API 直接 rm /var/lib/docker，也别在生产环境默认开 --force。留痕、可控、可逆，才是自动化清理的底线。
