在另一台主机构建Docker镜像时未使用缓存的问题排查

核心原因：Docker默认不会自动使用远程拉取的镜像作为构建缓存 #

在主机2执行docker build时，Docker默认仅检查本地已有的构建缓存层，不会自动关联你从Docker Hub拉取的mycompany/myrepo:latest镜像作为缓存源。即便该镜像包含所有构建所需的中间层，Docker也不会主动将其纳入构建缓存复用的范围。

解决方法：显式指定构建缓存源 #

在主机2执行构建命令时，添加--cache-from参数，明确告诉Docker可以用远程拉取的镜像作为缓存参考：

docker build --cache-from mycompany/myrepo:latest -t mycompany/myrepo:latest .

添加该参数后，Docker会检查指定镜像的所有层，匹配Dockerfile中的对应指令，从而复用已有缓存，无需重新执行所有构建步骤。

补充说明 #

• Docker构建缓存的匹配逻辑：每一条指令都会生成唯一哈希值，该哈希包含指令内容、构建上下文文件的哈希以及上一层镜像的哈希，只有当这些哈希完全匹配时，才会命中缓存。
• 主机2拉取的最终镜像虽包含中间层，但本地没有构建过程中生成的缓存关联记录，因此默认不会复用这些层。--cache-from参数打破了这个限制，允许Docker将指定镜像的层作为构建缓存使用。

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