容器与云原生 / 系统课时
退出与清理仓库凭据
退出与清理仓库凭据
本课解决镜像仓库使用结束后的凭据清理问题。你将退出指定仓库,并在不打印密码或令牌的前提下检查 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:// 或仓库路径。
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预期输出
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、来源证明、镜像摘要和仓库权限检查组合成发布前的标准验收清单。