Docker拉取Jenkins镜像失败：manifest not found问题求助

安全阿岳

2026-7-12

解决Jenkins镜像拉取时manifest not found问题

问题复现

拉取Jenkins镜像时出现如下错误：

manifest for docker.io/jenkins/jenkins:latest not found.

执行拉取命令的完整输出：

[jenkins@localhost jenkins-data]$ docker pull docker.io/jenkins/jenkins
Using default tag: latest
Trying to pull repository docker.io/jenkins/jenkins ...
manifest for docker.io/jenkins/jenkins:latest not found

更换镜像或指定版本标签后仍出现相同问题。

解决方案

清理本地Docker缓存，避免旧缓存干扰
执行命令清理无用的镜像、容器和缓存：
```
docker system prune -a
```
之后尝试拉取Jenkins LTS稳定版本（不建议用latest标签，LTS版本更稳定且标签明确）：
```
docker pull jenkins/jenkins:lts
```
检查Docker镜像源配置
如果你的Docker配置了国内镜像加速器，部分加速器可能存在镜像同步延迟或缺失的情况。可以临时注释掉/etc/docker/daemon.json中的加速器配置，重启Docker服务后再尝试拉取：
```
sudo systemctl restart docker
```
直接指定具体版本号拉取
先获取Jenkins镜像的可用版本标签：
```
curl https://registry-1.docker.io/v2/jenkins/jenkins/tags/list
```
然后选择一个具体版本拉取，例如：
```
docker pull jenkins/jenkins:2.440.3-lts
```
检查网络连通性
确认本地网络可以正常访问Docker Hub，执行ping测试：
```
ping docker.io
```
如果网络不通，需要排查网络防火墙、代理设置等问题。