Docker登录成功后docker-compose拉取私有镜像提示no basic auth credentials问题

核心原因 #

该问题是Debian/Ubuntu系（含Pop_OS）Docker环境的典型问题，核心是Docker凭证的读取上下文不匹配，常见触发场景有三类：

1. docker login 与 docker-compose 执行权限不一致
2. Snap格式安装的Docker/Compose存在沙箱隔离，无法读取用户家目录下的凭证配置
3. 凭证存储的域名与实际拉取镜像的域名不匹配

修复步骤 #

• 步骤1：修复权限不一致问题
  如果你执行docker login时用的是普通用户，执行docker-compose相关命令时加了sudo，会导致root用户无法读取普通用户家目录下的~/.docker/config.json凭证文件。两种修复方案二选一：
  • 统一使用sudo执行所有操作：先执行sudo docker login https://my.registry.com -u user -p pass，再执行sudo docker-compose相关命令
  • 配置普通用户免sudo执行Docker命令：执行sudo usermod -aG docker $USER，执行后注销当前用户重新登录，后续无需加sudo即可执行docker、docker-compose命令，凭证读取上下文会自动匹配
• 步骤2：排查Snap安装来源问题
  Pop_OS软件商店默认提供Snap格式的Docker、docker-compose安装包，Snap的沙箱机制会限制应用读取用户家目录下的隐藏配置文件。
  执行命令验证安装来源：snap list | grep -E "docker|docker-compose"
  如有输出说明为Snap安装版本，执行以下命令卸载后使用官方deb源重装即可：
  sudo snap remove docker docker-compose
  重装完成后重新执行docker login操作即可正常拉取镜像
• 步骤3：排查域名匹配问题
  你当前凭证配置中存储的域名是my.registry.com，但报错中请求的仓库地址为my.registry（无.com后缀），请确认docker-compose.yml中配置的镜像地址前缀是否和登录的域名完全一致，避免出现域名后缀、HTTP/HTTPS协议不匹配导致凭证无法关联的问题

注：如果你使用的是Docker Compose V2（docker compose 命令而非带横杠的docker-compose），上述排查逻辑完全适用

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