执行Docker load前如何检查docker save导出的镜像是否已存在于主机

校验方法 #

你可以通过提取待加载镜像包的唯一哈希ID，和本地已有镜像的ID做匹配实现校验，Docker 镜像的内容完全由哈希值唯一标识，和标签、仓库名无关。

前置注意

你当前的恢复命令有个容易踩的坑：docker save导出的镜像包应该搭配docker load命令导入，如果你用docker import导入，会把镜像识别为全新的文件系统层生成新的镜像ID，会导致后续的哈希校验失效。如果是docker export导出的容器包才需要用docker import导入。

方法1：兼容所有Docker版本（需安装jq）

直接解析镜像tar包内的manifest文件获取原镜像的完整哈希，不需要实际加载镜像：

1. 提取待加载镜像包的哈希ID

TARGET_IMAGE_ID=$(tar -xf /backitup/myimage.tar manifest.json -O | jq -r '.[0].Config' | sed 's/\.json$//')

2. 比对本地镜像库，确认是否已存在相同镜像

if docker images -q --no-trunc | grep -q "$TARGET_IMAGE_ID"; then
  echo "本地已存在相同镜像，跳过加载"
else
  echo "本地无匹配镜像，执行加载"
  docker load -i /backitup/myimage.tar
fi

方法2：Docker 20.10+ 版本可用，无需额外依赖

用Docker内置的--dry-run参数预览加载结果，不会实际写入本地镜像库：

# 预览加载结果，提取镜像ID
LOADED_IMAGE_ID=$(docker load -i /backitup/myimage.tar --dry-run | grep -oP 'Loaded image ID: sha256:\K[a-f0-9]+')

# 本地校验
if docker images -q --no-trunc | grep -q "$LOADED_IMAGE_ID"; then
  echo "本地已存在相同镜像，跳过加载"
else
  echo "本地无匹配镜像，执行加载"
  docker load -i /backitup/myimage.tar
fi

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