Docker镜像拉取失败咨询：已下载数据位置及断点续传可能性

一、已下载数据的存储位置 #

不同操作系统下的默认存储路径如下：

• Linux：核心数据存放在/var/lib/docker/目录内，具体分为：
  • 镜像层内容：/var/lib/docker/image/<storage-driver>/imagedb/content/sha256/（<storage-driver>通常是overlay2）
  • 层元数据：/var/lib/docker/image/<storage-driver>/layerdb/sha256/
  • 临时下载文件：可能在/var/lib/docker/tmp/或/var/lib/docker/buildkit/（启用BuildKit时）
• macOS（Docker Desktop）：数据存储在Docker后台虚拟机中，路径与Linux一致。可通过screen ~/Library/Containers/com.docker.docker/Data/vms/0/tty命令进入虚拟机查看，也能在Docker Desktop设置中找到数据存储目录的映射路径。
• Windows（Docker Desktop）：
  • WSL2后端：数据在WSL2文件系统内，路径为\\wsl$\docker-desktop-data\version-pack-data\community\docker\image\windows\imagedb\content\sha256\
  • Hyper-V后端：数据存放在Hyper-V虚拟机中，核心路径与Linux类似

二、能否从失败处重启拉取？ #

Docker 1.10及以上版本原生支持断点续传，无需从头开始：

• 再次执行docker pull <image-name>:<tag>时，Docker会通过SHA256哈希校验本地已下载的镜像层，仅下载缺失的部分，已完成的层直接复用。
• 若使用Docker 18.09+默认启用的BuildKit，断点续传逻辑更完善，即使拉取中断产生临时文件，下次拉取时也会自动识别并续传未完成的层。

如果遇到异常情况（如本地缓存的层损坏），Docker会自动检测并重新下载对应损坏的层，无需手动清理；若需强制清理临时文件，可删除/var/lib/docker/tmp/（Linux）或对应系统下的临时目录内容。

内容的提问来源于stack exchange，提问作者L.DZ