首页/云/Docker 容器速查/docker logout 退出仓库登录
镜像与构建107 条

docker logout 退出仓库登录

退出注册表并删除本地保存的对应认证信息:可指定注册表地址,不指定时默认退出 Docker Hub;退出只清本地凭据。

Docker 容器速查云更新于 2026-10-13

命令是干什么的

docker logout 退出注册表并删除本地保存的对应认证信息:可以指定注册表地址,不指定时默认退出默认仓库。它只清理本机凭据,不影响远端账号的状态,因此退出之后该账号在其他机器上依然处于登录状态,远端授权需要另行处理。

基本信息

用途清理本机保存的仓库凭据
语法docker logout [注册表地址]
影响范围仅本机的客户端配置文件
不影响远端账号、令牌与权限
验证方式执行一次拉取,返回未授权即为预期

典型使用场景

  • 共享构建机上使用完仓库凭据后清理
  • 切换不同账号前先退出旧账号
  • 排查拉取失败时确认当前是否处于登录状态
  • 安全巡检时统一清理不再使用的凭据
  • 机器交接或退役前清理本地凭据

退出与验证

退出与验证
docker logout registry.example.com                  # 退出指定仓库
docker logout                                        # 退出默认仓库
docker pull registry.example.com/team/app/web:1.0    # 验证:返回未授权说明凭据已清理
jq '.auths | keys' ~/.docker/config.json             # 确认认证条目已移除

动作与结果

动作结果注意
退出指定仓库删除该仓库凭据地址要写完整
退出默认仓库删除默认仓库凭据与指定地址的条目互不影响
退出后拉取返回未授权属于预期结果
远端账号不受影响其他机器仍保持登录
退出后可以用一次拉取动作验证:返回未授权说明本地凭据已清理,符合预期。
共享机器上忘记退出会留下可复用的凭据文件,是实际运维中常见的安全遗漏。

凭据清理场景

  • 构建机任务结束后统一退出,避免凭据被后续任务复用
  • 人员交接前清理本地仓库登录,防止账号被他人继续使用
  • 安全巡检时列出认证条目清单,逐个确认是否仍在用
  • 退役或重装机器前先退出并确认配置文件中已无相关条目

易错点

  • 共享构建机忘记退出:凭据文件被后续使用者复用,属于常见安全遗漏
  • 退出后拉取失败先怀疑镜像不存在:应先确认是否处于未登录状态,避免误判
  • 以为退出会回收远端授权:远端账号状态不变,需要另行处理令牌与权限
  • 只在一个终端退出:其他会话或工具可能仍持有凭据副本,需要整体核对

数据来源与参考

  • Docker 官方 CLI 参考:docker logout(docs.docker.com)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌