Docker彻底删除私有库镜像

关注

原创最新推荐文章于 2026-07-01 13:11:03 发布 7.2k 阅读 AI 写同款· GEO 优化 ›

Docker：上传镜像至仓库时报错文章目录①故障现象②解决思路 ①故障现象笔者在练习 Docker 时，上传镜像至 Docker Hub 官网仓库时老是报错，这里贴出报错代码：情况一： [root@docker ~]# docker push nginx:centos7 The push refers to repository [docker.io/library/nginx] 85fcec7ef3ef: Layer already exists 3e5288f7a70f: Layer already exists 56bc37 阅读详情

首先看看网上一般的做法

私有库默认是不支持删除镜像的，需要修改config.yml配置文件，在storage节点下加入 delete: enabled: true ，然后重启私有库。
在这里插入图片描述
docker 提供的镜像删除api为：

DELETE ip:端口/v2/<repository>/manifests/<reference>

repository 为镜像的repository
reference 为镜像push成功后生成的 digest：sha256 值

获取 digest :

curl --header "Accept: application/vnd.docker.distribution.manifest.v2+json" -I -XGET  <私有库ip>:端口号/v2/<镜像repository>/manifests/<镜像tag>

注意：
--header "Accept: application/vnd.docker.distribution.manifest.v2+json" 这个header 是必须要加的，不加的话Content-Type 是v1+prettyjws，获取的digest是错误的！！

   例：curl --header "Accept: application/vnd.docker.distribution.manifest.v2+json" -I -XGET 192.168.120.107:5000/v2/my-registry/manifests/1.0

在这里插入图片描述
删除镜像:

例：curl -I -X DELETE http://192.168.120.107:5000/v2/my-repository/manifests/sha256:4d523adb3c653bab7dfd0326081860b3cba24dc393f69d6731daa513c435ec0c

删除后我们查看下私有库

curl 192.168.120.107:5000/ v2/my-repository/tags/list

就会发现刚删除的那个tag不见了。但是如果在执行命令的前后车库内私有库镜像存储目录的文件大小，会发现并没有多大的变化
显然数据并没有被真的删除，我们还需要运行docker提供的垃圾回收命令。

垃圾回收

我们需要登录私有库所在的服务器，然后执行命令：

docker exec -it <私有库的容器ID或者容器名> sh -c ' registry garbage-collect /etc/docker/registry/config.yml'

当然，也可以进入到私有库的容器中，再执行：

docker exec -it <私有库的容器ID或者容器名> sh

registry garbage-collect /etc/docker/registry/config.yml

这种方法特别麻烦，只能删tag,不会删repository，删除之后会在blobs目录下留下很多空文件夹，而且如果一个repository下有多个tag,而这些tag的数据相同的话，删除其中一个tag会同时把所有tag都删了

虽然网上有删除私有库镜像的python脚本，但是我感觉并不好用。
我是不会满足于此的，于是我自己写了个sh脚本，先来看看效果。
在这里插入图片描述

脚本还有一些人性化的提示，而且sh脚本通俗易懂，容易扩展，脚本我也上传到gitHub上了，有兴趣的可以下载试试。
gitHub地址：https://github.com/hushuai86/docker-delete

下载运行：

#先下载脚本到/usr/local/bin/目录下
curl https://raw.githubusercontent.com/hushuai86/docker-delete/master/docker-delete-2.0.sh | sudo tee /usr/local/bin/docker-delete >/dev/null

#赋予可执行权限
chmod a+x /usr/local/bin/docker-delete

#私有库镜像存储目录路径全局环境变量（该路径就是运行私有库容器时，用-v 命令将私有库容器内 /var/lib/registry目录挂载到本机的路径）
#例： /opt/data/registry是我运行容器时私有库镜像存储目录挂载到本地的目录
echo "export DOCKER_REGISTRY_DIR=/opt/data/registry" >>/etc/profile

#运行私有库容器ID全局环境变量设置（正在运行的私有库容器的 ID）
#例： 89b9b3c9054ay是我的私有库库容器的id
echo "export DOCKER_REGISTRY_CONTAINER_ID=89b9b3c9054a" >>/etc/profile

#使配置生效
source /etc/profile

然后就可以使用docker-delete命令了，如果你觉得脚本有哪些用着不舒服的地方，可以编辑脚本自己改改

原理解析：
（在以下的截图中 /opt/data/registry是我运行容器时私有库镜像存储目录挂载到本地的目录）
私有库镜像存储目录下有两个文件夹 blobs和 repositories
在这里插入图片描述
其中repositories目录下是以镜像repository命名的几个文件
也就是说想要知道私有库有哪些镜像，直接看这个文件夹有哪些子文件夹就知道了
而在每个镜像repository文件夹/_manifests/tags目录下可以看到该镜像有哪些tag
在这里插入图片描述
但是镜像的真实数据并不在repositories目录下，而是以数据块的方式存储在blobs目录下，一个镜像被分成多个数据块，也就是执行垃圾回收命令时输出的 ‘marking blob …‘那样的关联关系，而镜像和数据块之间的关联关系就是在 repositories/镜像repository/_manifests/revisions/sha256/ 目录下的sha256值。
在这里插入图片描述
在以sha256值命名的目录下有个link的文件，内容就是这个sha256值

经过我测试发现，只要这个link文件被删除，然后在私有库容器内执行垃圾回收命令‘ registry garbage-collect /etc/docker/registry/config.yml’，那么这个sha256值关联的blobs就会被彻底删除

但是，一个镜像可能有很多个tag,那么这个sha256值关联的 blobs数据到底属于哪个 tag呢？
我们进到镜像的某个tag/index/sha256/ 目录，会发现有个 sha256值命名的文件夹，而且这个sha256值在之前的revisions/sha256/ 下存在。在这个文件夹下也有个link文件，保存了该sha256值。
在这里插入图片描述
所以根据我的理解，当我们调用docker提供的API 删除一个tag时，会在这个镜像的tag/index/sha256/<sha256值>/link文件中获取sha256值，然后看是不是还有其他tag也关联了这个sha256值，如果有的话，只删除这个tag文件夹，如果没有的话，那么在删除这个tag的文件的同时还会删掉 revisions/sha256/ 目录下的改sha256对应的link文件，这样的话，当在容器内执行垃圾回收的命令时，就会彻底删除该sha256值关联的blobs数据。