Colima与Docker Registry配置问题：镜像仓库未生效求助

Docker忽略镜像仓库配置的可能原因 #

• 镜像拉取命令未指定仓库前缀：如果拉取镜像时只写docker pull nginx这类无前缀的名称，Docker默认会优先匹配官方仓库，即便配置了镜像加速也可能触发默认行为。
• Colima配置格式错误或未生效：Colima的镜像仓库配置需写在~/.colima/default/colima.yaml的docker.registry-mirrors节点下，若格式嵌套错误、配置后未重启Colima，都会导致配置不生效。
• Docker配置文件冲突：如果~/.docker/daemon.json的配置与Colima的colima.yaml不一致，可能出现配置覆盖失效的情况；另外未重启Docker/Colima服务，修改后的配置不会加载。
• 旧版registry字段的差异：同事配置里的Registry: https://index.docker.io/v1/是Docker旧版的配置项，新版已改用registry-mirrors，但如果你的自定义仓库未正确设置镜像映射规则，Docker仍会 fallback 到官方仓库。

强制使用自定义镜像仓库的方法 #

1. 修正Colima配置并重启
   编辑~/.colima/default/colima.yaml，确保配置格式正确：

   docker:
     registry-mirrors:
       - "https://你的自定义镜像仓库地址"
   

   执行命令重启Colima：

   colima stop && colima start
   

2. 同步Docker daemon配置
   在~/.docker/daemon.json中添加镜像仓库配置：

   {
     "registry-mirrors": ["https://你的自定义镜像仓库地址"],
     "insecure-registries": [] // 若自定义仓库是HTTP协议，需在此添加仓库地址
   }
   

   重启Colima使配置生效（Colima会同步加载Docker daemon配置）。

3. 拉取镜像时指定仓库前缀
   直接在镜像名前加上自定义仓库地址，比如：

   docker pull 你的自定义镜像仓库地址/library/nginx
   

   这种方式会强制Docker从指定仓库拉取镜像，绕过默认规则。

4. 验证配置是否生效
   执行docker info命令，查看输出中的Registry Mirrors字段，确认你的自定义仓库已被加载。

5. 清理Docker缓存
   若存在旧的镜像元数据缓存，可能导致Docker仍访问官方仓库，执行以下命令清理：

   docker system prune -a
   

   注意：此命令会删除未使用的镜像、容器、网络等资源，执行前请确认无需保留。

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