容器与云原生 / 系统课时

退出与清理仓库凭据

退出与清理仓库凭据

本课解决镜像仓库使用结束后的凭据清理问题。你将退出指定仓库,并在不打印密码或令牌的前提下检查 Docker 配置,确认本地文件、凭据存储器和自动化环境没有继续保留不需要的访问权限。

学习目标

  • 使用 docker logout 退出 Docker Hub 或私有镜像仓库
  • 判断凭据保存在配置文件还是系统凭据存储器中
  • 安全检查遗留认证信息并处理常见遗漏

凭据存在哪里

Docker CLI 默认使用 $HOME/.docker/config.json,也可能通过 DOCKER_CONFIG 或 --config 指向其他目录。Docker Desktop 通常把凭据保存到操作系统原生钥匙串;未配置凭据存储器时,认证信息可能以 Base64 编码形式出现在 config.json,这不是加密。:contentReference[oaicite:4]{index=4}

credsStore 和 credHelpers 表示凭据应交给哪个外部程序管理,它们本身通常不是密码。退出后不要仅凭这些字段仍然存在,就判断凭据没有清理成功。

退出并安全检查

下面的示例退出一个私有仓库,然后只报告可能保存内联认证信息的仓库名称,不输出 auth、令牌或密码内容。将 REGISTRY 改为实际主机名和可选端口,不要附加 https:// 或仓库路径。

bash
REGISTRY="registry.example.com"
CONFIG_DIR="${DOCKER_CONFIG:-$HOME/.docker}"
CONFIG_FILE="$CONFIG_DIR/config.json"

docker logout "$REGISTRY"

python3 - "$CONFIG_FILE" <<'PY'
import json
import pathlib
import sys

path = pathlib.Path(sys.argv[1])
if not path.exists():
    print("config file: <not found>")
    raise SystemExit(0)

data = json.loads(path.read_text(encoding="utf-8"))
inline_registries = []

for server, entry in data.get("auths", {}).items():
    if isinstance(entry, dict) and any(
        key in entry for key in ("auth", "identitytoken", "registrytoken")
    ):
        inline_registries.append(server)

print("inline credential registries:", sorted(inline_registries))
print("default credential store:", data.get("credsStore", "<none>"))
print("registry credential helpers:", sorted(data.get("credHelpers", {}).keys()))
PY

预期输出

text
Removing login credentials for registry.example.com
inline credential registries: []
default credential store: <CREDENTIAL_STORE_OR_NONE>
registry credential helpers: <CONFIGURED_REGISTRY_LIST>

<CREDENTIAL_STORE_OR_NONE> 和 <CONFIGURED_REGISTRY_LIST> 取决于本机配置。关键验收条件是目标仓库不再出现在 inline credential registries 中,并且 docker pull 或 docker push 在需要认证时会重新要求登录。

常见遗留与修复

如果退出后仍能访问私有镜像,先确认当前命令是否使用了另一个 DOCKER_CONFIG、另一个操作系统用户或不同的 Docker 上下文。仓库主机名必须与登录时一致,带端口的私有仓库也要在退出时保留相同端口。

docker logout 只清理当前 Docker CLI 使用的本地凭据,不会删除 CI/CD 平台中的 Secret、Shell 环境变量、云端访问令牌或服务器端个人访问令牌。停止使用某个账号时,还应在仓库平台撤销对应令牌,并清理流水线变量和部署主机上的独立配置。

不要直接删除整个 .docker 目录作为常规处理方式,其中还可能包含上下文、插件和输出配置。只有在确认目录用途并完成备份后,才应手工修改;优先使用 docker logout 让 Docker 调用正确的凭据存储器执行删除。:contentReference[oaicite:5]{index=5}

本课总结

  • docker logout <REGISTRY> 应使用与登录时一致的仓库主机名和端口
  • config.json 可能保存内联认证信息,也可能只保存凭据存储器配置
  • 本地退出不会撤销 CI Secret 或云端令牌,停用账号时必须分别清理

下一课预告

完成凭据清理后,可以进一步把 SBOM、来源证明、镜像摘要和仓库权限检查组合成发布前的标准验收清单。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

退出与清理仓库凭据

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通