本文收集了部分导致镜像拉取失败的场景和对应的解决方案，帮忙您处理镜像拉取失败问题。

镜像地址不正确或没有对应镜像的权限

问题描述

执行 docker pull 命令时提示报错 Error response from daemon: unauthorized。

问题原因

镜像地址不正确或没有对应镜像的权限。

解决方案

• 拉取公有镜像时报错：
  请检查镜像地址是否准确，并重新尝试上传镜像。
• 拉取私有镜像时报错：
  • 可能您的账号没有该私有镜像所在镜像仓库实例、命名空间等的权限。请先联系主账号配置相应的权限，配置完权限后请重新尝试。
  • 请检查镜像地址是否准确，并重新尝试上传镜像。

私有镜像域名配置错误

问题描述

容器服务工作负载拉取私有镜像时报错 imagepullbackoff。

问题原因

容器服务中使用私有镜像的工作负载配置了 imagePullSecrets，但 imagePullSecrets 中的域名和工作负载中的域名不一致。

解决方案

将 Secret 保密字典中的镜像仓库域名设置为和工作负载的域名一致，操作步骤如下。

1. 查看工作负载中的域名。
   

2. 查看工作负载中的保密字典。
   

3. 将 Secret 保密字典中的镜像仓库域名设置为和工作负载的域名一致，操作详情参见 管理保密字典。