如何彻底删除Docker Registry指定镜像的所有标签并清除catalog残留

你删除镜像所有标签后仍然能在/v2/_catalog接口查询到镜像名称，是因为Docker Registry默认仅做软删除：标签删除操作只会移除标签引用，不会自动清理仓库元数据、未被引用的镜像层文件，空的仓库目录也会保留。
按照以下步骤操作即可彻底删除无残留：

• 步骤1：确认Registry已开启删除权限
  需确保Registry配置文件中删除功能已开启，对应config.yml配置如下：

  storage:
    delete:
      enabled: true
  

  容器部署的Registry可在启动时添加环境变量REGISTRY_STORAGE_DELETE_ENABLED=true开启该权限，修改配置后需重启Registry生效。
• 步骤2：执行垃圾回收清理冗余数据
  调用Registry内置的垃圾回收工具，清理所有无引用的镜像层、manifest元数据，添加-m参数可同时清理空仓库的元数据记录：

  # 容器部署的Registry执行该命令，替换为实际的容器名/ID
  docker exec <registry_container_id_or_name> registry garbage-collect -m /etc/docker/registry/config.yml
  

• 步骤3：（可选）手动清理空仓库目录
  如果执行完垃圾回收后镜像名称仍然出现在catalog结果中，可直接删除Registry存储路径下对应镜像的空目录：

  # 默认存储路径为/var/lib/registry，自定义路径替换为实际路径
  rm -rf /var/lib/registry/docker/registry/v2/repositories/<your_image_name>
  

操作完成后调用http://YourPrivateRegistyIP:5000/v2/_catalog即可验证残留记录已被清除。

注意：执行垃圾回收期间建议停止Registry的镜像推送操作，避免出现数据损坏。

内容的提问来源于stack exchange，提问作者ofirule