Docker镜像完整性校验需三重验证：先核对manifest的SHA-256 digest是否匹配，再验证镜像能否正常加载运行，最后比对本地层摘要与远程manifest层列表一致性，辅以传输阶段文件哈希初筛。
拉取 Docker 镜像时做完整性校验，核心是确认你拿到的镜像和远程仓库发布的完全一致——既没被传输损坏，也没被恶意篡改。这不是单靠文件大小或一次哈希就能覆盖的事，得结合镜像层、manifest 和运行行为三重验证。
看 manifest digest 是否匹配
这是最权威的校验依据。Docker 官方用 SHA-256 digest 唯一标识镜像内容，与 tag 无关，且不可伪造（除非私钥泄露）。
- 拉取前查原始 digest（如果已知）：比如从 CI 日志或发布文档中获取
sha256:abc123... - 拉取后立即检查：
docker inspect --format='{{index .RepoDigests 0}}' nginx:latest，输出应为nginx@sha256:xxx - 若镜像未通过 digest 拉取（如只用了 tag），可先
docker pull nginx@sha256:xxx强制按 digest 获取，再比对本地 ID 是否一致
验证镜像能否正确加载和运行
仅 digest 匹配还不够——有些损坏可能发生在本地缓存或 registry 返回异常响应时，导致镜像元数据错乱但 digest 仍“看起来正常”。
- 用
docker load -i myimage.tar加载导出包，观察是否报invalid format或config file not found - 加载成功后执行
docker run --rm <image> <cmd>，例如nginx:latest nginx -v，确认能输出预期版本而非崩溃或报错 - 检查关键字段：
docker inspect <image> | jq '.Config.Cmd, .Config.Entrypoint'，确保与官方说明或构建时设定一致
比对层摘要与本地缓存一致性
Docker 拉取时会逐层校验每个 blob 的 digest，但这个过程默认静默。你可以主动触发并观察日志。
- 启用详细日志：
docker --debug pull nginx:latest，留意输出中类似Downloaded layer sha256:xxx的行 - 手动核对层信息：
docker image inspect nginx:latest | jq '.RootFS.Layers'，得到一串 digest 列表 - 用
skopeo inspect docker://docker.io/library/nginx:latest查远程 manifest 中的 Layers 字段，两组 digest 应完全相同
补充：传输阶段用文件哈希初筛
适用于离线分发或 air-gapped 环境，虽不能替代 digest 校验，但能快速发现传输中断或磁盘写入错误。
- 导出时生成：
docker save -o app.tar app:v1 && sha256sum app.tar > app.tar.sha256 - 接收方验证：
sha256sum -c app.tar.sha256，显示OK才继续docker load - 注意：MD5 不推荐用于安全场景，SHA-256 是最低要求；校验对象是
.tar文件本身，不是镜像运行态
