使用Docker Go客户端拉取私有镜像失败，Docker CLI拉取正常

你遇到的核心矛盾是：Docker CLI能正常拉取私有不安全仓库的镜像，但Go客户端拉取时报错No such image，且已经配置了insecure-registries。结合你的代码和配置，给出以下排查方向和解决办法：

1. 验证镜像的平台manifest是否存在 #

你在Go代码中指定了Platform: "linux/amd64"，但CLI拉取时未指定平台参数，默认拉取当前主机架构的镜像。先确认仓库中是否存在linux/amd64平台的镜像manifest：

docker manifest inspect x.x.x.x:5000/myimage:latest

如果输出中没有linux/amd64的条目，说明你构建推送的镜像实际没有该平台的manifest，需要用buildx重新构建并推送跨平台镜像：

docker buildx build --platform=linux/amd64 -t x.x.x.x:5000/myimage:latest --push .

2. 调整Go客户端的ImagePull参数 #

尝试两种调整方式：

• 去掉Platform参数：和CLI行为保持一致，测试是否能拉取：

r, err := cli.ImagePull(ctx, imageId, types.ImagePullOptions{})

• 显式传递RegistryAuth参数：即使仓库是匿名访问，也可以传递空的认证字符串（若仓库需要认证，需先通过docker login获取auth字符串并base64编码）：

import "encoding/base64"
import "encoding/json"

// 匿名访问时传递空配置
authConfig := types.AuthConfig{}
authBytes, _ := json.Marshal(authConfig)
authStr := base64.URLEncoding.EncodeToString(authBytes)

r, err := cli.ImagePull(ctx, imageId, types.ImagePullOptions{
  Platform:     "linux/amd64",
  RegistryAuth: authStr,
})

3. 确认Docker daemon配置生效 #

虽然CLI能拉取，但仍建议确认daemon.json配置后是否重启了daemon：

sudo systemctl restart docker

4. 检查Go SDK版本兼容性 #

确保你使用的github.com/docker/docker/client版本与本地Docker daemon版本匹配，尽量使用最新稳定版，避免因版本差异导致的参数解析问题。

内容的提问来源于stack exchange，提问作者Héctor Valls