Docker Hub镜像Pull失败的解决全过程
更新时间：2025年09月12日 08:37:12 作者：lijiachang030718
文章解决Ubuntu环境下Docker拉取镜像失败问题,分析网络限制、DNS污染及下载速度慢等原因,提出配置国内镜像加速器的解决方案,包括编辑daemon.json并重启Docker服务
引言
在云原生技术火热的当下，Docker可谓是其基础，由于其简单以及方便性，让开发人员不必再为环境配置问题而伤脑筋，因为可将其看作一个虚拟机程序去理解。所以掌握好它可谓是很重要的事情，本文章将解决作者使用Docker时，遇到的一个基础问题，这也是困扰了很多人的问题，在此写篇文章分享给大家。
一、问题
在Ubuntu Linux环境下，docker pull ubuntu:20.04 会报错或卡住（或其它镜像），没办法从Docker Hub下载镜像。
二、原因
- 网络限制：Docker Hub 的服务器位于国外（registry-1.docker.io），某些地区可能因网络策略（如防火墙、国际带宽限制）导致连接超时或阻断。
- DNS 污染：部分网络环境中，Docker Hub 的域名解析可能被干扰，无法获取正确的 IP 地址。
- 下载速度慢：即使能连接，国际带宽的延迟和限速也会导致下载耗时过长甚至失败。
三、解决方法
概括：配置国内镜像加速器
vim /etc/docker/daemon.json，没有则自行创建- 将下面文本覆盖到上述文件中
{
"registry-mirrors": [
"https://2a6bf1988cb6428c877f723ec7530dbc.mirror.swr.myhuaweicloud.com",
"https://docker.m.daocloud.io",
"https://hub-mirror.c.163.com",
"https://mirror.baidubce.com",
"https://your_preferred_mirror",
"https://dockerhub.icu",
"https://docker.registry.cyou",
"https://docker-cf.registry.cyou",
"https://dockercf.jsdelivr.fyi",
"https://docker.jsdelivr.fyi",
"https://dockertest.jsdelivr.fyi",
"https://mirror.aliyuncs.com",
"https://dockerproxy.com",
"https://mirror.baidubce.com",
"https://docker.m.daocloud.io",
"https://docker.nju.edu.cn",
"https://docker.mirrors.sjtug.sjtu.edu.cn",
"https://docker.mirrors.ustc.edu.cn",
"https://mirror.iscas.ac.cn",
"https://docker.rainbond.cc"
]
}
- 重新加载docker配置文件
systemctl daemon-reload
- 重启docker服务
systemctl restart docker.service
总结
以上为个人经验，希望能给大家一个参考，也希望大家多多支持脚本之家。
相关文章
这篇文章介绍了Linux安装Docker的方法，文中通过示例代码介绍的非常详细。对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下2022-07-07
docker创建centos容器并在容器里下载MySQL本地连接MySQL
这篇文章主要介绍了docker创建centos容器并在容器里下载MySQL本地连接MySQL，文章内容介绍详细需要的小伙伴可以参考一下2022-03-03
这篇文章主要介绍了Docker安全机制内核安全与容器之间的网络安全，具有一定参考价值，需要的朋友可以了解下。2017-09-09
本文主要介绍了Docker容器中启用SSH服务的方法步骤,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧2025-01-01
这篇文章主要介绍了Windows安装docker-desktop的详细步骤,本文通过图文并茂的形式给大家介绍的非常详细,感兴趣的朋友跟随小编一起看看吧2024-03-03
这篇文章主要介绍了解决虚拟机挂起后再恢复后Docker部署的应用无法连接问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教2024-04-04
这篇文章主要为大家详细介绍了Docker使用自定义网桥的相关资料 ,具有一定的参考价值，感兴趣的小伙伴们可以参考一下2016-10-10
在K8S部署的容器中,SSH连接时环境变量被重置导致软件缺失,解决方法是修改容器的/etc/profile文件,通过for循环或直接导出环境变量,再执行source命令使配置生效,确保变量从1号进程正确传递2025-08-08
使用docker -v 和 Publish over SSH插件实现war包自动部署到docker的操作步骤
这篇文章主要介绍了利用docker -v 和 Publish over SSH插件实现war包自动部署到docker的操作步骤，非常不错，具有参考借鉴价值,需要的朋友可以参考下2018-01-01
这篇文章主要介绍了docker搭建logstash和使用方法详解,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友参考下吧2023-12-12
最新评论