GitHub Actions拉取Docker Hub私有镜像报错，求正确镜像地址

你的报错核心原因是镜像地址格式错误，Docker Hub当前不再需要/v1路径前缀，修正后就能正常拉取私有镜像。

修正镜像地址 #

把你当前的镜像地址从：

image: docker://index.docker.io/v1/<repository_name>/<image_name>:latest

改成以下两种正确格式之一：

格式1（推荐，省略默认镜像源前缀） #

image: <你的Docker Hub用户名>/<image_name>:latest

比如如果你的用户名是myuser，镜像名是django-dev，就是：

image: myuser/django-dev:latest

格式2（完整镜像源路径） #

image: docker.io/<你的Docker Hub用户名>/<image_name>:latest
# 或者等价的 index.docker.io/<你的Docker Hub用户名>/<image_name>:latest

修正后的完整container配置示例：

container:
  image: ${{ secrets.DOCKERHUB_USERNAME }}/<image_name>:latest
  credentials:
    username: ${{ secrets.DOCKERHUB_USERNAME }}
    password: ${{ secrets.DOCKERHUB_PASSWORD }}

额外排查要点 #

如果修正地址后还是报错，检查以下几点：

• 确认GitHub仓库的Secrets中，DOCKERHUB_USERNAME和DOCKERHUB_PASSWORD的内容完全正确，没有多余空格或拼写错误
• 登录Docker Hub后台，确认<image_name>:latest这个镜像确实存在于你的私有仓库中，标签没有写错
• 验证当前Docker Hub账号对该私有仓库拥有拉取权限（比如你是仓库所有者，或者已被仓库管理员添加为协作者）

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