Windows10 Docker Desktop拉取7GB大镜像失败，报unauthorized错误

版本Bug说明 #

Docker Desktop 20.10.21确实存在用户反馈的大体积镜像拉取接近完成时触发认证失败的问题，属于该版本已知的兼容性问题，主要和大文件拉取时的认证令牌超时、网络传输稳定性相关。

可行解决办法 #

• 切换国内镜像加速源：在Docker Desktop的「Settings > Docker Engine」配置中添加国内合规的镜像加速源，减少跨网络传输的延迟和中断概率，配置示例：

  {
    "registry-mirrors": ["国内镜像加速源地址"]
  }
  

  配置后重启Docker服务生效。
• 更换Docker版本：回退到20.10.x系列中更稳定的版本（如20.10.18），或升级到较新的稳定版本（如24.x系列），避开当前版本的bug。
• 手动导入镜像：从可正常拉取的环境将镜像导出为tar包，再通过本地命令导入：

  docker load -i 镜像文件名.tar
  

• 刷新仓库认证：如果拉取的是私有镜像，重新登录仓库刷新认证令牌：

  docker login 目标仓库地址
  

  输入正确的账号凭据后再尝试拉取。

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