Docker构建拉取免费Python镜像报错，提示获取凭证失败求助

为什么拉取免费镜像会触发登录请求报错？ #

这根本不是需要登录，是Docker的凭证存储机制在sudo环境下出了问题。Docker默认使用的凭证助手（比如docker-credential-secretservice）依赖X11会话才能运行，但用sudo执行命令时，环境里没有$DISPLAY变量（服务器大概率是无头环境，未开启图形界面），导致凭证助手启动失败，进而在拉取镜像元数据时抛出了这个错误。

解决方法 #

方法一：临时禁用BuildKit快速解决

执行构建时加上DOCKER_BUILDKIT=0，跳过BuildKit的元数据检查流程：

DOCKER_BUILDKIT=0 sudo docker build .

方法二：修改Docker凭证存储配置（永久解决）

给root用户的Docker配置指定不依赖GUI的凭证存储后端：

1. 创建root用户的Docker配置目录（如果不存在）：

sudo mkdir -p /root/.docker

2. 编辑config.json文件：

sudo nano /root/.docker/config.json

3. 写入以下内容二选一：

• 用文件存储凭证（适合需要保存私有镜像登录信息的场景）：

{
  "credsStore": "file"
}

• 完全禁用凭证存储（只拉取公开镜像的话可以用这个）：

{
  "credsStore": "none"
}

4. 保存退出后，再执行sudo docker build .即可正常拉取镜像。

方法三：不用sudo执行Docker（推荐长期方案）

把当前用户加入docker用户组，无需sudo就能操作Docker，环境变量正常也不会触发这个问题：

sudo usermod -aG docker $USER

执行完后退出当前SSH会话重新登录，之后直接运行docker build .即可。

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