直接通过 Docker Registry API 清理过期镜像需三步：启用删除功能、按规则筛选标签、调用 API 删除清单并触发垃圾回收；全程无需进入容器，仅用 HTTP 接口与脚本即可完成。
直接通过 Docker Registry API 清理过期镜像，核心是三步：启用删除功能、按规则筛选标签、调用 API 删除清单并触发垃圾回收。整个过程无需登录容器内部，全部可通过 HTTP 接口 + 简单脚本完成。
确认并启用 Registry 删除功能
Registry 默认禁用删除接口，必须显式开启。检查配置文件 /etc/docker/registry/config.yml 中的 storage 段是否包含：
storage:
delete:
enabled: true
若使用 docker-compose 部署，确保 registry 服务环境变量中设置了：
- REGISTRY_STORAGE_DELETE_ENABLED=true
修改后重启服务：docker-compose up -d registry 或 systemctl restart docker-registry。验证是否生效：
curl -I http://localhost:5000/v2/
若返回 200 OK，说明服务正常；后续操作才可执行。
获取目标镜像的所有标签并过滤过期项
以项目 myapp 为例，先列出所有标签：
curl -s "http://localhost:5000/v2/myapp/tags/list" | jq -r '.tags[]'
再按业务规则排除需保留的标签，例如只保留 latest、prod- 开头或最近 3 个版本。常见过滤逻辑包括：
使用 Python 脚本下载 Docker 镜像并打包为 tar 文件。用户说“下载镜像”“拉取镜像”“pull xxx”“帮我下载 nginx 镜像”等时触发。支持 SOCKS5 代理直连（推荐）和国内镜像站加速两种模式。
- 排除正则匹配的保留标签：
^(latest|prod-|staging-) - 按时间戳排序后取尾部 N 个（需配合仓库支持的
_catalog扩展或外部元数据） - 删除含
-dev、-test、-rc且超过 7 天未拉取的标签（需额外日志分析）
简单示例（删除非 latest 且不含 prod 的旧标签）：
curl -s "http://localhost:5000/v2/myapp/tags/list" | jq -r '.tags[]' | while read tag; do
if [[ ! "$tag" =~ ^(latest|prod-) ]]; then
echo "待删: myapp:$tag"
fi
done
调用 API 删除标签并触发垃圾回收
删除不是直接删 tag 名，而是先查其对应 digest，再删 manifest：
- 获取 digest：
curl -H "Accept: application/vnd.docker.distribution.manifest.v2+json" -I "http://localhost:5000/v2/myapp/manifests/$tag" 2>&1 | grep Docker-Content-Digest | awk '{print $2}' - 删除 manifest：
curl -X DELETE "http://localhost:5000/v2/myapp/manifests/$digest"
注意：删除后镜像层仍占用磁盘，必须手动触发垃圾回收：
docker exec registry /bin/registry garbage-collect /etc/docker/registry/config.yml
若报错 “blob descriptor cache not configured”，需在 config.yml 中注释或移除 cache: blobdescriptor: inmemory 行，否则 GC 可能跳过已缓存层。
自动化脚本整合建议
将上述流程封装为定时任务更稳妥。一个最小可用脚本结构如下：
- 定义白名单正则和项目列表
- 逐个项目拉取标签 → 过滤 → 获取 digest → 发起 DELETE
- 全部删除完成后统一执行一次 GC
- 记录操作日志并输出清理摘要（如“共删 17 个标签，释放约 2.4GB”）
生产环境建议加一层 dry-run 模式开关，并在删除前校验该 digest 是否被其他仓库标签引用（避免误删共享基础镜像）。
