容器与云原生 / 系统课时
登录镜像仓库
登录镜像仓库
本课将完成 Docker 公共或私有镜像仓库登录,并避免把密码直接写进命令历史。你还会检查登录结果、理解凭据保存位置,并掌握退出登录和凭据辅助程序的基本用法。
学习目标
- 使用交互方式或标准输入登录镜像仓库
- 验证当前凭据是否具备拉取或推送权限
- 了解凭据文件与 credential helper 的安全差异
登录前准备
登录前需要确认仓库地址、用户名以及密码或访问令牌。Docker Hub 使用默认仓库时可以省略地址;企业 Harbor、云厂商仓库或自建 Registry 通常必须填写域名,必要时还包括端口。
先确认 Docker 客户端可用:
docker version --format 'Client {{.Client.Version}}'预期输出中的版本号以实际环境为准:
Client <VERSION>访问令牌通常比账户密码更适合自动化,因为它可以单独吊销并限制权限。不要把密码、令牌或完整认证配置提交到 Git 仓库。
交互式登录
在可信终端中,可以直接执行登录命令,再按提示输入用户名和密码。输入密码时终端不会回显字符。
docker login <REGISTRY>预期交互如下,其中提示内容可能因仓库类型略有不同:
Username: <USERNAME>
Password:
Login Succeeded登录 Docker Hub 时可使用 docker login。登录私有仓库时应填写纯仓库地址,例如 registry.example.com 或 registry.example.com:<PORT>,不要附加 https:// 和镜像路径。
使用标准输入传递令牌
在脚本或 CI 中,应通过 --password-stdin 从标准输入读取令牌,避免令牌直接出现在命令参数和 Shell 历史中。下面示例先读取令牌,再执行登录。
read -rsp 'Registry token: ' REGISTRY_TOKEN
printf '\n'
printf '%s' "$REGISTRY_TOKEN" | docker login <REGISTRY> --username <USERNAME> --password-stdin
unset REGISTRY_TOKEN预期结果:
Registry token:
Login Succeeded--password-stdin 只能降低命令行泄露风险,不能自动保护 CI 日志和环境变量。自动化环境应使用平台提供的 Secret,并禁止在调试输出中打印变量值。
验证登录权限
登录成功只说明凭据被仓库接受,不能证明账号拥有目标镜像的全部权限。可先拉取一个有权访问的镜像,再根据需要推送测试标签。
docker pull <REGISTRY>/<NAMESPACE>/<IMAGE>:<TAG>预期输出会显示镜像被下载或本地已经是最新版本:
<TAG>: Pulling from <NAMESPACE>/<IMAGE>
Digest: sha256:<DIGEST>
Status: Downloaded newer image for <REGISTRY>/<NAMESPACE>/<IMAGE>:<TAG>实际状态也可能是 Image is up to date。若返回 unauthorized 或 denied,应依次检查仓库地址、用户名、令牌有效期、项目成员关系以及镜像仓库权限,而不是反复重试同一密码。
管理本地凭据
Docker 会在用户目录的 ~/.docker/config.json 中记录认证配置。未配置凭据辅助程序时,认证信息可能以可逆编码形式保存在该文件中,因此不应复制、上传或共享它。
推荐为桌面系统启用系统钥匙串对应的 credential helper。配置片段如下,具体 helper 名称取决于操作系统和已安装程序。
{
"credsStore": "<HELPER_NAME>"
}配置生效后,再次执行 docker login <REGISTRY>,凭据会交由辅助程序保存。可通过以下命令退出指定仓库并删除对应登录状态:
docker logout <REGISTRY>预期输出:
Removing login credentials for <REGISTRY>共享服务器上应为每个操作用户使用独立账户和独立 Docker 配置目录,避免多人共用同一份长期有效凭据。
常见登录失败
出现 x509: certificate signed by unknown authority 时,问题通常不是账号密码,而是客户端不信任私有仓库证书。应正确安装仓库 CA 证书,不要把关闭 TLS 校验作为生产解决方案。
出现 unauthorized: authentication required 时,先确认登录的主机名与镜像地址中的主机名完全一致。registry.example.com 与 registry.example.com:<PORT> 会被视为不同登录目标。
本课总结
- 手工登录可使用交互式输入,自动化场景应使用
--password-stdin - 登录成功后仍需通过拉取或推送验证具体仓库权限
- credential helper 比直接在
config.json中保存可逆认证信息更安全
下一课预告
下一课将学习为镜像设置规范标签,并把本地镜像推送到已经登录的远程仓库。