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
总结
以上为个人经验，希望能给大家一个参考，也希望大家多多支持脚本之家。
相关文章
这篇文章主要介绍了在VS Code中使用Docker容器的具体方法,文中将基础概念、环境配置、核心操作及高级应用介绍的非常详细,通过学习可以了解Docker与VSCode集成的重要性,掌握Docker镜像、容器的基本概念,需要的朋友可以参考下2025-11-11
docker 使用mysqldump命令备份导出项目中的mysql数据
这篇文章主要介绍了docker 使用mysqldump命令备份导出项目中的mysql数据本文通过命令给大家介绍的非常详细，具有一定的参考借鉴价值,需要的朋友可以参考下2019-12-12
本篇文章主要介绍了为 Docker 设置代理，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧2017-03-03
这篇文章主要介绍了使用脚本一键打包并上传docker镜像的实现代码,本文给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下2021-02-02
这篇文章主要介绍了docker swarm 集群故障与异常详解，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧2018-02-02
本文主要介绍了Docker搭建SVN服务器的实现步骤,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧2025-11-11
解决vscode docker插件docker.socket权限问题
本文给大家分享关于vscode docker插件docker.socket权限问题，文末给大家提到vscode中docker插件无法连接的问题及解决方案，需要的朋友参考下吧2021-06-06
本文档提供了一个脚本,用于自动扫描、显示和导入`/data/k8s-package`目录下的Docker离线镜像文件,用户可以选择单个或批量导入镜像,并在每次加载后进行确认,脚本运行后,会显示加载结果,并最终列出当前系统中的所有Docker镜像2025-10-10
本文介绍了Dockerfile的定义、构建过程以及Dockerfile的常见指令和体系结构,通过案例展示了如何创建自定义镜像并运行容器2025-12-12
这篇文章主要给大家介绍了关于docker安装nacos并配置数据库的相关资料, Nacos是SpringCloudAlibaba架构中最重要的组件,Nacos 是一个更易于帮助构建云原生应用的动态服务发现、配置和服务管理平台,文中介绍的非常信息,需要的朋友可以参考下2023-09-09
最新评论