WSL2无Docker Desktop环境下Docker凭证存储配置问题咨询

方案A：pass凭证存储（纯Linux环境）修复 #

该方案完全运行在WSL2 Linux子系统内，无需调用Windows侧组件，是优先推荐的解决方案。常见的登录成功但pull报错的核心原因为Docker daemon运行身份与pass存储所属用户不匹配，按以下步骤修复即可：

• 先确认当前普通用户的pass配置正常：执行pass ls可正常列出存储内容，无权限报错，docker-credential-pass二进制已正确安装，执行docker-credential-pass version可返回正常版本号
• 确认~/.docker/config.json配置正确：

{
  "credsStore": "pass"
}

• 配置Docker以普通用户身份运行，解决权限不匹配问题：
  1. 停止Docker服务：sudo systemctl stop docker
  2. 创建Docker用户组（不存在时执行）：sudo groupadd docker
  3. 将当前用户加入Docker组：sudo usermod -aG docker $USER
  4. 激活用户组变更：newgrp docker
  5. 编辑/etc/docker/daemon.json，添加rootless配置：

  {
    "rootless": true
  }
  

  6. 重启Docker服务：sudo systemctl start docker
• 验证修复：重新执行docker login，登录完成后执行pull操作，无unauthorized报错即为修复成功

方案B：wincred.exe凭证存储调用慢问题原因与修复 #

问题原因 #

wincred.exe是Windows原生程序，WSL2调用Windows二进制时默认会触发DNS反向解析，当WSL2自动生成的DNS配置无法解析Windows主机名时，会触发1分钟左右的DNS超时等待，表现为认证环节卡顿。

修复步骤 #

• 编辑WSL2内/etc/wsl.conf，禁用自动生成DNS配置：

[network]
generateResolvConf = false

• 删除原有软链接形式的resolv配置：sudo rm /etc/resolv.conf
• 新建/etc/resolv.conf，填入稳定的公共DNS服务：

nameserver 8.8.8.8
nameserver 1.1.1.1

• 在Windows终端执行wsl --shutdown关闭WSL虚拟机，重启后配置生效
• 可选优化：如果仍有卡顿，可将Windows主机的IP与主机名映射添加到/etc/hosts，完全跳过解析流程
  1. 获取Windows主机IP：cat /etc/resolv.conf | grep nameserver | awk '{print $2}'
  2. 获取Windows主机名：hostname.exe | tr -d '\r'
  3. 将[WindowsIP] [Windows主机名]的对应关系添加到/etc/hosts末尾即可

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