Docker登录私有JFrog仓库成功但运行Jenkins镜像失败排查求助

核心原因 #

报错context deadline exceeded是Docker尝试访问官方Docker Hub（registry-1.docker.io）时网络超时，而之所以会访问官方源，要么是私有仓库中没有jenkins:latest镜像，要么是私有镜像源的配置未正确生效，导致Docker无法从私有仓库拉取，转而请求官方源但网络不通。

具体排查项 #

1. 检查私有仓库是否存在目标镜像 #

• 直接指定私有仓库地址尝试拉取：

  docker pull registry.x.xx-xx-xxxxx.xx.xx.xxxx.net/jenkins:latest
  

• 如果拉取失败，说明私有仓库内无该镜像，需要先将jenkins镜像推送到私有仓库，或确认镜像名称/tag是否正确（比如是否是jenkins/jenkins:latest而非jenkins:latest）。

2. 验证Docker守护进程配置是否生效 #

• 修改daemon.json后必须重启Docker服务才能生效：

  sudo systemctl restart docker
  

• 重启后执行docker info，查看输出中的Registry Mirrors和Insecure Registries字段，确认私有仓库地址已被正确加载。如果未显示，检查配置文件的JSON语法（比如逗号、引号是否遗漏），或确认配置文件路径是否正确（多数系统为/etc/docker/daemon.json）。

3. 测试私有仓库的网络连通性 #

• 在Docker主机上执行：

  curl -v https://registry.x.xx-xx-xxxxx.xx.xx.xxxx.net/v2/
  

• 如果curl超时或报错，说明主机到私有仓库的网络存在问题（比如防火墙拦截、路由异常、DNS解析失败），需排查网络链路。

4. 调整Docker镜像拉取的优先级规则 #

• Docker默认会在镜像源无对应镜像时，自动 fallback 到官方源。如果你的网络无法访问Docker Hub，可通过配置限制Docker仅从私有仓库拉取：
  修改/etc/docker/daemon.json：

  {
    "insecure-registries": ["registry.x.xx-xx-xxxxx.xx.xx.xxxx.net"],
    "registry-mirrors": ["registry.x.xx-xx-xxxxx.xx.xx.xxxx.net"],
    "allow-registries": ["registry.x.xx-xx-xxxxx.xx.xx.xxxx.net"]
  }
  

  配置后重启Docker，即可禁止Docker请求官方源。

5. 确认私有仓库登录凭证有效性 #

• 重新执行登录命令，确认凭证未过期或失效：

  docker login -u <你的用户名> registry.x.xx-xx-xxxxx.xx.xx.xxxx.net
  

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