Docker login/logout 命令（深入浅出）

Docker login/logout 命令详解：安全访问镜像仓库的必备技能

在日常开发中，我们经常需要从私有或公共镜像仓库拉取或推送 Docker 镜像。而这一切的前提，就是正确地登录到镜像仓库。Docker 提供了 docker login 和 docker logout 这两个命令，它们就像是进入镜像仓库的“门禁系统”——只有通过认证，才能自由进出。

如果你是初学者，可能一开始会疑惑：为什么不能直接拉取私有镜像？答案是安全。就像你不能随便进入别人的家一样，Docker 也必须确认你是有权限的人。Docker login/logout 命令 正是完成这一认证流程的核心工具。

本文将带你一步步理解这两个命令的使用方法、常见场景和注意事项，让你在使用 Docker 时不再“卡在登录环节”。

什么是 Docker login/logout 命令？

docker login 命令用于向 Docker 镜像仓库（如 Docker Hub、阿里云容器镜像服务、腾讯云镜像仓库等）进行身份验证。成功登录后，Docker 会将认证信息保存在本地的 ~/.docker/config.json 文件中，后续操作（如 docker pull 或 docker push）就不再需要重复输入密码。

而 docker logout 命令则用于退出当前登录状态，清除本地保存的认证信息。这在多用户环境或共享机器上尤为重要，能有效避免账号泄露风险。

可以这样理解：

docker login 就像你刷门禁卡进入办公楼；
docker logout 就像你离开时把门禁卡交还。

我们先从最常用的 Docker Hub 开始。假设你要推送一个自定义镜像到自己的 Docker Hub 账号，必须先登录。

docker login

执行后，终端会提示你输入用户名和密码：

Login with your Docker ID to push and pull images from Docker Hub. If you don't have a Docker ID, head over to https://hub.docker.com to create one.
Username: your-dockerhub-username
Password: ********
Login Succeeded

💡 注意：输入密码时，终端不会回显字符，这是安全设计，不要担心“没输入”。

命令行参数方式登录（推荐用于 CI/CD）

在自动化脚本或 CI/CD 流程中，手动输入用户名和密码显然不现实。这时可以使用以下方式：

docker login -u your-dockerhub-username -p your-password

例如：

docker login -u myusername -p mysecretpassword123

⚠️ 重要提醒：不建议在脚本中明文写入密码。更安全的做法是使用环境变量或密钥管理工具（如 GitHub Secrets、Vault 等）。

使用 Token 替代密码（更安全）

Docker Hub 从 2022 年起已逐步弃用密码登录，推荐使用个人访问令牌（Personal Access Token）。

登录 Docker Hub 网站；
进入 “Account Settings” → “Security”；
生成一个新 Token，复制它；
使用 Token 登录：

docker login -u your-username -p your-generated-token

这种方式比密码更安全，即使泄露，也可以随时撤销。

如何使用 docker logout 命令

当你在公共电脑上工作，或者切换用户时，及时退出登录是必要的安全措施。

docker logout

执行后，Docker 会清除当前用户的认证信息，下次操作时需要重新登录。

如果你要退出特定仓库的登录状态（例如你同时登录了 Docker Hub 和阿里云镜像仓库），可以指定仓库地址：

docker logout registry.cn-hangzhou.aliyuncs.com

这会仅清除阿里云仓库的登录信息，保留 Docker Hub 的登录状态。

✅ 最佳实践：在 CI/CD 流水线结束时，务必添加 docker logout，防止凭证被意外保留。

实际案例：部署私有镜像到阿里云容器镜像服务

假设你正在使用阿里云容器镜像服务（ACR），需要推送镜像。以下是完整流程：

1. 登录阿里云 ACR

docker login --username=your-aliyun-account registry.cn-hangzhou.aliyuncs.com

系统会提示输入密码（即阿里云的 AccessKey Secret）。

2. 构建并标记镜像

docker build -t registry.cn-hangzhou.aliyuncs.com/your-namespace/your-image:latest .

3. 推送镜像

docker push registry.cn-hangzhou.aliyuncs.com/your-namespace/your-image:latest

🔐 如果你没有登录，执行 push 时会收到错误：unauthorized: authentication required。这正是 Docker login/logout 命令 的作用体现。

4. 完成后登出

docker logout registry.cn-hangzhou.aliyuncs.com

这样就能确保你的密钥不会留在本地。

常见问题与解决方案

问题 1：登录失败，提示 “unauthorized: authentication required”

这通常是因为你未登录，或登录信息已过期。

✅ 解决方法：

检查是否执行过 docker login；
若已登录，尝试重新登录：docker logout 后再 docker login；
确保用户名和密码（或 Token）正确。

问题 2：登录后仍无法推送镜像

检查镜像名称是否正确：

docker push myimage:latest

docker push registry.cn-hangzhou.aliyuncs.com/namespace/myimage:latest

问题 3：在 CI/CD 中如何安全登录？

推荐使用环境变量：

- name: Login to Docker Hub
  run: |
    echo "$DOCKER_PASSWORD" | docker login -u $DOCKER_USERNAME --password-stdin

📌 优点：密码不写入日志，安全可控。

认证信息存储位置与管理

Docker 的认证信息默认保存在：

~/.docker/config.json

你可以打开这个文件查看已登录的仓库信息：

{
  "auths": {
    "https://index.docker.io/v1/": {
      "auth": "base64-encoded-username:password"
    },
    "registry.cn-hangzhou.aliyuncs.com": {
      "auth": "base64-encoded-username:token"
    }
  }
}

注意：auth 字段是 Base64 编码的，不是明文。如果要手动修改，需确保编码正确。

🔒 安全建议：该文件应受权限保护（如 chmod 600 config.json），避免被他人读取。

总结：掌握登录与登出，提升开发效率与安全性

Docker login/logout 命令 虽然看似简单，却是使用 Docker 进行镜像管理的基石。无论是本地开发、团队协作，还是自动化部署，正确使用这两个命令，都能让你避免“认证失败”的尴尬，同时提升安全性。

记住几个关键点：

docker login 是进入镜像仓库的“钥匙”；
docker logout 是离开时的“收尾动作”；
在脚本中使用 Token 比密码更安全；
推送镜像前，务必确认镜像名包含 Registry 地址；
CI/CD 中务必在流程结束时执行 docker logout。

掌握这些细节，你就能在使用 Docker 时游刃有余。别再让一个登录问题卡住你的开发节奏。从今天起，让每一次镜像操作都安全、顺畅。

最后提醒：在公共机器上工作时，养成“登录即登出”的习惯，这是对团队和项目负责的表现。