Windows 2019环境下Docker拉取本地Windows镜像失败，尝试连接微软服务器

出现这个问题的核心原因是：你的自定义镜像中仍有部分层的引用指向微软官方仓库，而非你的本地仓库。这通常由以下几种情况导致：

1. 本地仓库的基础镜像不完整：你推送到本地仓库的servercore:ltsc2019-amd64可能未包含所有依赖层，部分层仅存在于微软MCR仓库中。目标机器拉取自定义镜像时，Docker会尝试从原始源（微软）获取缺失层，因此出现连接微软服务器的报错。
2. 镜像Manifest文件未完全更新：构建自定义镜像时，虽然FROM指令指向本地仓库，但镜像的Manifest文件可能仍保留微软仓库的层地址引用，拉取时Docker会优先尝试这些原始地址。
3. 目标机器拉取时未指定完整本地仓库路径：如果拉取命令仅用镜像名和标签（而非完整本地仓库地址），Docker可能默认从官方仓库拉取缺失层。

解决步骤 #

• 确保本地仓库的基础镜像完整
  先完整拉取微软官方的servercore:ltsc2019-amd64到本地，再推送到私有仓库，确保所有层同步：

  docker pull mcr.microsoft.com/windows/servercore:ltsc2019-amd64
  docker tag mcr.microsoft.com/windows/servercore:ltsc2019-amd64 <你的本地仓库地址>/servercore:ltsc2019-amd64
  docker push <你的本地仓库地址>/servercore:ltsc2019-amd64
  

• 重新构建并推送自定义镜像
  确保Dockerfile的FROM指令使用完整本地仓库路径：

  FROM <你的本地仓库地址>/servercore:ltsc2019-amd64
  # 你的其他构建指令...
  

  重新构建并推送到本地仓库：

  docker build -t <你的本地仓库地址>/your-custom-image:tag .
  docker push <你的本地仓库地址>/your-custom-image:tag
  

• 目标机器拉取时使用完整仓库地址
  在目标机器执行拉取命令时，必须指定完整的本地仓库路径：

  docker pull <你的本地仓库地址>/your-custom-image:tag
  

• 排查目标机器的Docker配置
  检查目标机器的Docker配置文件（通常为daemon.json），确认是否存在代理、镜像加速等设置导致Docker优先访问官方仓库，同时确保目标机器能正常访问本地仓库网络。

• 查看详细拉取日志定位问题
  使用 verbose 模式拉取镜像，查看具体哪些层尝试从微软仓库获取：

  docker pull --verbose <你的本地仓库地址>/your-custom-image:tag
  

  根据日志找到缺失的层，手动将这些层推送到本地仓库即可解决。

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