Docker构建命令执行失败，请求排查Ubuntu镜像拉取凭证问题

错误场景 #

执行docker build . -t hello时构建失败，错误信息：

加载docker.io/library/ubuntu:latest元数据失败，提示获取凭证出错，具体错误为：error getting credentials - err: exit status 1, out: no usernames for https://index.docker.io/v1/

解决方法 #

• 检查并清理Docker配置文件
  打开~/.docker/config.json文件，删除其中针对https://index.docker.io/v1/的无效认证条目，保存后重启Docker服务。

• 重新登录或退出Docker Hub
  执行docker login，按提示输入Docker Hub用户名和密码完成登录；若不需要拉取私有镜像，直接执行docker logout清除现有凭证，Docker会自动以匿名方式拉取官方公共镜像。

• 重置Linux环境下的Docker凭证助手
  如果系统使用pass作为凭证助手出现异常：

  1. 卸载凭证助手：sudo apt-get remove docker-credential-pass（Debian/Ubuntu系列）
  2. 编辑~/.docker/config.json，删除"credsStore": "pass"行
  3. 重启Docker：sudo systemctl restart docker

• 配置国内镜像源
  若因网络问题无法访问Docker Hub，可替换为国内镜像源：

  1. 创建或修改/etc/docker/daemon.json，添加内容：

     {
       "registry-mirrors": ["https://hub-mirror.c.163.com"]
     }
     

  2. 重启Docker服务：sudo systemctl daemon-reload && sudo systemctl restart docker

内容的提问来源于stack exchange，提问作者MUHAMMAD SHAHID RAFI C P