DockerHub网页登录正常，但Linux终端docker login命令认证失败求助

密码含感叹号的处理 #

用单引号包裹密码是正确的做法——单引号会让shell完全忽略内部的特殊字符（包括!），不会触发bash的历史命令扩展或其他转义行为。但要确认你输入的密码和网页端完全一致，比如检查大小写、特殊字符的全半角（比如中文感叹号和英文感叹号的区别）。

常见登录失败原因 #

• 凭据缓存干扰：Docker会在~/.docker/config.json中缓存登录凭据，之前的错误记录可能导致新登录失效。先清理缓存再重试：

  docker logout
  rm -rf ~/.docker/config.json
  

  之后重新执行登录命令。
• 两步验证开启：如果你的Docker Hub账户开启了两步验证，命令行登录不能使用原密码，必须改用个人访问令牌（PAT）。登录Docker Hub网页端，进入「Account Settings」→「Security」→「New Access Token」创建令牌，用这个令牌代替密码执行docker login。
• 网络访问限制：Linux机器可能处于代理、防火墙或内网环境，导致无法正常连接Docker Hub的registry服务器。可以先测试连通性：

  curl -v https://registry-1.docker.io/v2/
  

  正常情况下会返回401 Unauthorized（未授权），如果是超时、连接失败，说明网络存在问题，需要排查代理或防火墙规则。

关于server参数的说明 #

默认情况下，docker login不指定--server参数时，就是登录Docker Hub，对应服务器地址是registry-1.docker.io，所以不需要额外指定。如果要明确指定服务器，直接执行：

docker login --server registry-1.docker.io -u DOCKER_USER -p 'my!pass'

也可以通过查看~/.docker/config.json文件确认已登录的服务器信息。

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