本地已存在Docker镜像，执行docker build时为何仍远程拉取元数据？

原因分析 #

• 镜像标识不匹配：本地镜像名称为aliyunfc/runtime-custom.debian10:3.1.0，而构建时Docker尝试加载的是带完整仓库域名的docker.io/aliyunfc/runtime-custom.debian10:3.1.0。Docker会将带完整域名与不带域名的镜像视为不同的标识，因此即便本地存在对应镜像，仍会触发远程元数据查询。
• 默认元数据检查机制：Docker构建时默认会向远程仓库查询镜像的最新元数据（比如标签是否绑定了新的镜像ID），这个行为不会因为本地已有镜像而停止，目的是确保使用的镜像信息是最新状态。

解决办法 #

• 调整Dockerfile中的FROM指令，去掉仓库前缀，直接使用与本地镜像一致的名称：

  FROM aliyunfc/runtime-custom.debian10:3.1.0
  

• 构建时添加--pull=false参数，强制Docker仅使用本地镜像，跳过远程元数据检查：

  docker build --pull=false -t fc-debian10-php83:1.0 .
  

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