首页/云/Docker 容器速查/pull access denied / 需要登录
本包目录(366 条)
基础命令50 条镜像与构建107 条网络与存储52 条Compose 编排55 条资源与安全50 条
容器排障52 条

pull access denied / 需要登录

pull access denied, repository does not exist or may require 'docker login':仓库或镜像名写错、私有仓库未登录、权限不足,三者报错文本相同要逐一排除。

Docker 容器速查云更新于 2026-10-12
排查顺序名字拼写 → 登录状态 → 命名空间权限
登录docker login <registry>
验证重新 pull 并看返回层进度

示例

示例
docker pull library/nginx:1.27
docker login registry.example.com
docker pull registry.example.com/team/app:1.0
docker logout registry.example.com
企业仓库常见坑是中转代理或镜像加速器不允许透传私有仓库请求,需要直连配置。

易错点

  • 同一报错下耗时较多的是名字拼写:先到仓库页面复制完整地址再重试
  • 登录凭据过期后错误文本相同,docker logout 再 login 可快速排除凭据问题

数据来源与参考

  • Docker 官方文档:docker pull 与 docker login(docs.docker.com)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌