容器与云原生 / 系统课时

登录镜像仓库

登录镜像仓库

本课将完成 Docker 公共或私有镜像仓库登录,并避免把密码直接写进命令历史。你还会检查登录结果、理解凭据保存位置,并掌握退出登录和凭据辅助程序的基本用法。

学习目标

  • 使用交互方式或标准输入登录镜像仓库
  • 验证当前凭据是否具备拉取或推送权限
  • 了解凭据文件与 credential helper 的安全差异

登录前准备

登录前需要确认仓库地址、用户名以及密码或访问令牌。Docker Hub 使用默认仓库时可以省略地址;企业 Harbor、云厂商仓库或自建 Registry 通常必须填写域名,必要时还包括端口。

先确认 Docker 客户端可用:

bash
docker version --format 'Client {{.Client.Version}}'

预期输出中的版本号以实际环境为准:

text
Client <VERSION>

访问令牌通常比账户密码更适合自动化,因为它可以单独吊销并限制权限。不要把密码、令牌或完整认证配置提交到 Git 仓库。

交互式登录

在可信终端中,可以直接执行登录命令,再按提示输入用户名和密码。输入密码时终端不会回显字符。

bash
docker login <REGISTRY>

预期交互如下,其中提示内容可能因仓库类型略有不同:

text
Username: <USERNAME>
Password:
Login Succeeded

登录 Docker Hub 时可使用 docker login。登录私有仓库时应填写纯仓库地址,例如 registry.example.com 或 registry.example.com:<PORT>,不要附加 https:// 和镜像路径。

使用标准输入传递令牌

在脚本或 CI 中,应通过 --password-stdin 从标准输入读取令牌,避免令牌直接出现在命令参数和 Shell 历史中。下面示例先读取令牌,再执行登录。

bash
read -rsp 'Registry token: ' REGISTRY_TOKEN
printf '\n'

printf '%s' "$REGISTRY_TOKEN" | docker login <REGISTRY> --username <USERNAME> --password-stdin

unset REGISTRY_TOKEN

预期结果:

text
Registry token:
Login Succeeded

--password-stdin 只能降低命令行泄露风险,不能自动保护 CI 日志和环境变量。自动化环境应使用平台提供的 Secret,并禁止在调试输出中打印变量值。

验证登录权限

登录成功只说明凭据被仓库接受,不能证明账号拥有目标镜像的全部权限。可先拉取一个有权访问的镜像,再根据需要推送测试标签。

bash
docker pull <REGISTRY>/<NAMESPACE>/<IMAGE>:<TAG>

预期输出会显示镜像被下载或本地已经是最新版本:

text
<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 名称取决于操作系统和已安装程序。

json
{
  "credsStore": "<HELPER_NAME>"
}

配置生效后,再次执行 docker login <REGISTRY>,凭据会交由辅助程序保存。可通过以下命令退出指定仓库并删除对应登录状态:

bash
docker logout <REGISTRY>

预期输出:

text
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 中保存可逆认证信息更安全

下一课预告

下一课将学习为镜像设置规范标签,并把本地镜像推送到已经登录的远程仓库。

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

目录与阅读设置

阅读设置

17

记录一个想法

登录镜像仓库

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

登录哪都通