如何将ECR拉取缓存配置为DockerHub镜像源？

核心问题 #

你当前配置的registry-mirrors URL格式错误，ECR拉取缓存的镜像源不需要追加/v2/dh-cache后缀，错误路径导致Docker请求无法被ECR缓存正确处理，因此拉取成功但镜像未存入缓存。

正确配置步骤 #

1. 确认ECR拉取缓存基础配置

   • 确保你的ECR仓库类型为拉取缓存，且上游源已设置为registry-1.docker.io（DockerHub官方地址）。

2. 修正Docker守护进程配置

   • 编辑Docker配置文件（Linux下为/etc/docker/daemon.json，Docker Desktop可在设置中找到对应配置项），将镜像源URL改为ECR缓存仓库的根地址：

     {
       "registry-mirrors": [
         "https://xxxxxxx.dkr.ecr.xxxxxx.amazonaws.com"
       ]
     }
     

   • 重启Docker服务：Linux执行sudo systemctl restart docker，Docker Desktop直接重启应用。

3. 验证缓存生效

   • 拉取一个DockerHub公开镜像，例如：docker pull nginx:latest
   • 登录AWS ECR控制台，进入你的拉取缓存仓库，检查是否已生成对应的镜像记录。
   • 查看Docker日志确认请求路由：Linux执行sudo journalctl -u docker.service | grep mirror，确认拉取请求是否指向了ECR缓存地址。

额外排查点 #

• IAM权限检查：EC2实例需具备ecr:GetDownloadUrlForLayer、ecr:BatchGetImage、ecr:BatchCheckLayerAvailability权限；ECR拉取缓存的服务角色需有权限同步DockerHub镜像（创建缓存时默认配置，若手动修改过角色需重新确认）。
• 日志排查：如果缓存仍未生成，查看Docker daemon日志中的错误信息，排查是否存在权限不足、上游连接超时等问题。
• 拉取命令规范：避免直接指定DockerHub域名拉取（如docker pull registry-1.docker.io/library/nginx），这种方式会绕过镜像源，必须使用短名称拉取（如docker pull nginx）。
• 镜像存在性验证：确保你拉取的镜像标签在DockerHub上存在，ECR不会缓存无效的上游请求。

内容的提问来源于stack exchange，提问作者Tim Brown