Docker客户端连接私有镜像仓库的认证核心是通过docker login自动生成合法凭据并存入~/.docker/config.json，确保地址（含端口）与服务端认证机制匹配；手动配置需严格遵循JSON格式、Base64编码及文件权限600要求。
配置 Docker 客户端连接私有镜像仓库的认证信息，核心是让 docker login 生成的凭据被正确识别和使用。关键不在于手动写编码，而在于确保凭证存放在正确路径、格式合法，并配合服务端启用认证机制。
确认私有仓库已启用认证
客户端配置认证的前提是服务端（如 Harbor、Nginx+Registry 或带 basic auth 的 Registry）已开启用户名密码校验。例如：
- Harbor 默认启用 UI 登录和 API 认证
- 原生 Registry 需搭配
htpasswd文件 +registry:2的auth配置项 - 若未启用认证，
docker login会成功但实际无意义，推送/拉取仍无需验证
使用 docker login 自动生成认证配置
这是最推荐、最可靠的方式，Docker 会自动处理 Base64 编码并写入标准位置：
- 执行命令：
docker login registry.example.com:5000（端口按实际填写） - 输入用户名和密码（如 admin / Harbor12345）
- Docker 自动将加密后的凭据写入
~/.docker/config.json（Linux/macOS）或%USERPROFILE%\.docker\config.json（Windows） - 该文件内容类似：
{"auths":{"registry.example.com:5000":{"auth":"YWRtaW46SGFyYm9yMTIzNDU="}}}
手动配置 config.json（仅限特殊场景）
当无法交互登录（如 CI 环境、容器内运行），可预先生成并挂载配置文件：
- 用
echo -n 'username:password' | base64得到 auth 字符串 - 创建或编辑
~/.docker/config.json，结构必须严格为：{ "auths": { "registry.example.com:5000": { "auth": "base64字符串" } } } - 注意：
auths键名必须与仓库地址完全一致（含端口、协议前缀不写） - 确保文件权限为
600（Linux/macOS）：chmod 600 ~/.docker/config.json
验证是否生效
配置完成后，通过以下方式确认：
- 执行
docker pull registry.example.com:5000/myapp:latest—— 不报unauthorized即表示认证通过 - 检查
cat ~/.docker/config.json中对应仓库是否有auth字段 - 运行
docker info | grep -A 5 'Insecure'可辅助排查是否因 HTTP 仓库未加insecure-registries导致连接失败（此问题常被误判为认证失败）
