配置 Docker 镜像加速，解决 docker pull 拉取镜像失败、docker search 查询镜像失败等问题

一、概述

记录时间 [2025-08-16]


在 Docker 学习中，可能会遇到诸如 docker 远程仓库无法访问、docker pull 拉取镜像失败、docker search 查询镜像失败等问题。

这是由于国内网络对 docker 远程仓库的访问受到限制。

那么在国内如何获取 docker 镜像呢？

  • 最全面、直接的方式是请求获取 Docker Hub 仓库，但是访问受限。
  • 国内访问受限，需要配置国内镜像源以加速镜像获取。这些镜像源由国内的各大厂商维护。
  • 对于热门 docker 仓库，国内加速镜像更新还算及时。但是，它们不会全量缓存 Docker Hub 仓库，因此有些镜像更新不及时。

本文用于总结 docker 镜像加速相关内容，主要包括汇总国内可用镜像源地址；在 Linux（Centos7）中配置 docker 镜像加速；解决 docker pull 拉取镜像失败、docker search 查询镜像失败等问题。



二、汇总国内可用镜像源

以下整理了一些国内可用镜像源地址，可用于配置 docker 镜像加速。

由于镜像源需要长期维护，可能会出现变更或失效的问题，欢迎读者补充更正。


名称镜像源地址支持
DaoCloud 镜像站https://docker.m.daocloud.io/支持 Docker Hub、GCR、K8S、GHCR、Quay、NVCR 等
网易云https://hub-mirror.c.163.com支持 Docker Hub
Docker 镜像代理https://dockerproxy.com/支持 Docker Hub、GCR、K8S、GHCR
百度云https://mirror.baidubce.com/支持 Docker Hub
南京大学镜像站https://docker.nju.edu.cn/支持 Docker Hub、GCR、GHCR、Quay、NVCR 等
上海交大镜像站https://docker.mirrors.sjtug.sjtu.edu.cn/支持 Docker Hub、GCR 等
阿里云加速地址https://xxx.mirror.aliyuncs.com/支持 Docker Hub，需要登录使用
腾讯云https://mirror.ccs.tencentyun.com
Docker 镜像加速https://docker-0.unsee.tech/可用于 docker search


三、配置国内镜像源

接下来讲述 docker 在 Linux（Centos7）中的配置和使用。

详细配置内容可参考这篇文章——Centos7 中 Docker 使用，镜像、容器，以及操作等常用命令小结


使用镜像源进行镜像加速服务有 2 种方式：

  • 直接使用：对特定镜像进行加速；
  • 长久配置：修改配置文件，全局配置镜像加速。

在 docker 学习中，需要使用镜像加速的地方有：

  • docker pull：从远程仓库拉取镜像；
  • docker search：从远程仓库搜索镜像。

这两个操作有一点区别，文章后面再讲。


1. docker pull

先讲加速 docker pull 操作。

默认从官方 Docker Hub 中获取镜像的时候，命令如下：

docker pull mysql:5.7

表示从远程仓库中下载镜像名为 mysql，版本为 5.7 的 docker 镜像。

默认的访问往往会超时、失败。

配置国内镜像源可以加快 docker pull 拉取镜像的速度。


2. 对特定镜像进行加速

如果只想对特定镜像进行加速，可以直接使用完整的 代理/镜像域名 拼接 官方镜像名。（具体根据镜像源的规则来）

例如：

  • 要拉取镜像 istio/distroless；
  • 选择一个可用镜像源 docker-0.unsee.tech；
  • 进行命令拼接如下。
docker pull docker-0.unsee.tech/istio/distroless

又或者：

docker pull docker.1panel.live/library/python:3.11
docker pull docker.1panel.live/library/mysql:5.7

3. 修改配置文件

针对长久配置，需要修改配置文件，全局配置镜像加速。

配置文件：/etc/docker/daemon.json（如果不存在则需要创建）

创建配置目录

sudo mkdir -p /etc/docker/

写入配置

在 registry-mirrors 中写入所有的可用镜像源地址，实际使用时 docker 会按顺序依次尝试。

建议把常用的镜像源地址写在最前面，后面的充当备用。


sudo tee /etc/docker/daemon.json <<-'EOF'
{"registry-mirrors": ["https://docker.m.daocloud.io/","https://hub-mirror.c.163.com","https://dockerproxy.com/","https://mirror.baidubce.com/","https://docker.nju.edu.cn/","https://docker.mirrors.sjtug.sjtu.edu.cn/","https://mirror.ccs.tencentyun.com","https://docker-0.unsee.tech","https://register.liberx.info/","https://docker.registry.cyou/","https://docker-cf.registry.cyou/","https://dockercf.jsdelivr.fyi/","https://docker.jsdelivr.fyi/","https://dockertest.jsdelivr.fyi/","https://mirror.iscas.ac.cn/","https://docker.rainbond.cc/","https://mirror.aliyuncs.com","https://docker.mirrors.ustc.edu.cn/"]
}
EOF

重启 docker 服务

sudo systemctl daemon-reload && sudo systemctl restart docker

检查镜像配置是否生效：

docker info

在 Registry Mirrors 中可以查看加载完成的镜像源地址。


使用

配置完镜像源后，再使用 docker pull 命令如下：

docker pull mysql:5.7

发现拉取镜像的速度变快了，也不用在镜像前面加前缀了。



四、docker search

1. 配置的镜像源失效

docker search 是用来在 Docker Hub 中搜索可用镜像的命令。

例如：以下命令表示搜索镜像名为 mysql，版本为 5.7 的 docker 镜像。

docker search mysql:5.7

前面说 docker search 和 docker pull 有一点区别，就是：

配置国内镜像源（在 daemon.json 文件中配置的镜像地址）可以加快 docker pull 拉取镜像的速度。

但是，配置国内镜像源是对 docker search 没有用的，因为这个命令使用的仍然是 docker 默认搜索地址，在国内就会造成超时。

这也是造成 “docker pull 能成功，但是 docker search 却失败” 的原因。


2. 解决方法

在使用 docker search 命令搜索镜像时，要加上指定源的域名。


这里使用的是 docker-0.unsee.tech，它是一个提供 Docker Hub 镜像加速服务的网站，功能如下：

  • 帮助用户快速拉取官方镜像；
  • 搜索官方镜像。

具体的使用方法如下：

例如，搜索 mysql5.7 的命令：

docker search docker-0.unsee.tech/mysql:5.7

这个网站的页面如下：

也可以通过搜索框来搜索 Docker Hub 镜像。


在这里插入图片描述



在这里插入图片描述



参考资料

Docker Hub - http://hub.docker.com

Centos7 中 Docker 使用，镜像、容器，以及操作等常用命令小结 - https://blog.csdn.net/Sareur_1879/article/details/137479996

Docker Hub 镜像加速服务 - https://docker-0.unsee.tech/

解决目前DockerHub国内无法访问方法汇总 - https://www.cnblogs.com/ppqppl/articles/18499797

Docker Search失败，但是Pull成功的解决方法 - https://blog.csdn.net/weixin_45391996/article/details/143703963

docker search 超时 - https://developer.aliyun.com/article/1662509

2025最新国内服务器可用docker源仓库地址大全（2025年8月更新） · DockerHub镜像加速全面指南 - https://zhuanlan.zhihu.com/p/1936728250236769211

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.mfbz.cn/a/2785.html

如若内容造成侵权/违法违规/事实不符，请联系我们进行投诉反馈qq邮箱809451989@qq.com，一经查实，立即删除！

相关文章

智能工厂生产监控大屏-vue纯前端静态页面练习

智能工厂生产监控大屏-vue纯前端静态页面练习

学习前端还是非常有意思的&#xff0c;因为前端真的是可见即所得&#xff0c;可以做出来非常好看漂亮的页面&#xff0c;最近我就在使用前端技术 做一些大屏报表&#xff0c;在制作这些大屏报表过程中&#xff0c;又熟练的练习了自己的学到的相关的前端技术&#xff0c;接下来把…
阅读更多...
Android 欧盟网络安全EN18031 要求对应的基本表格填写

Android 欧盟网络安全EN18031 要求对应的基本表格填写

Android 欧盟网络安全EN18031 要求对应的基本表格填写 文章目录Android 欧盟网络安全EN18031 要求对应的基本表格填写一、背景二、18031认证预填表格三、其他1、Android EN 18031 要求对应的基本表格小结2、EN 18031的要求表格内容填写3、一定要做三方认证&#xff1f;4、欧盟网…
阅读更多...
Java Lambda表达式是什么，怎么用

Java Lambda表达式是什么，怎么用

这种代码是什么&#xff0c;怎么阅读/*** 批量插入** param entityList ignore* param batchSize ignore* return ignore*/Transactional(rollbackFor Exception.class)Overridepublic boolean saveBatch(Collection<T> entityList, int batchSize) {String sqlStateme…
阅读更多...
力扣习题：基本计算器

力扣习题：基本计算器

本片内容我们将针对于一个力扣中的一道很经典的习题&#xff1a;基本计算器。 这道题目十分经典&#xff0c;在很多大厂的面试题中都有出现过 因此我们将进一步来学习 该题目代码已经上传作者的个人gitee&#xff1a;CPP 学习代码库: C代码库新库&#xff0c;旧有C仓库满员了喜…
阅读更多...
​​金仓数据库KingbaseES V9R1C10安装教程 - Windows版详细指南​

​​金仓数据库KingbaseES V9R1C10安装教程 - Windows版详细指南​

文章目录一、前言二、软件下载2.1 下载安装包2.2 下载授权文件三. 安装KingbaseES数据库3.1 解压安装包3.2 运行安装程序3.3 安装步骤详解步骤1&#xff1a;欢迎界面步骤2&#xff1a;许可协议步骤3&#xff1a;添加授权文件步骤4&#xff1a;选择安装路径步骤5&#xff1a;选择…
阅读更多...
基于HTML5与Tailwind CSS的现代运势抽签系统技术解析

基于HTML5与Tailwind CSS的现代运势抽签系统技术解析

引言 浪浪山札记&#xff1a;献给所有在暗夜里倔强发光的普通人 一、系统概述 "每日运签"是一个基于现代Web技术构建的交互式运势抽取应用&#xff0c;结合了中国传统文化元素与现代UI设计理念。该系统采用HTML5、CSS3和JavaScript作为核心技术栈&#xff0c;并利用T…
阅读更多...
面试题：如何用Flink实时计算QPS

面试题：如何用Flink实时计算QPS

Flink 实时计算 QPS 面试题题目&#xff1a; 假设某互联网应用日活用户 100 万&#xff0c;每天产生 1 亿条数据&#xff08;日志/事件&#xff09;&#xff0c;要求使用 Apache Flink 实现实时计算系统的 QPS&#xff08;Queries Per Second&#xff09;&#xff0c;并考虑以下…
阅读更多...
快速部署一个鉴黄服务

快速部署一个鉴黄服务

1.安装依赖pip install opennsfw22.代码实现import opennsfw2 as n2# 将自动下载预训练模型 open_nsfw_weights.h5 到 C:\Users\Administrator\.opennsfw2\weights # pip install opennsfw2# 单张预测 image_path 1.jpg nsfw_probability n2.predict_image(image_path) print…
阅读更多...
【软考中级网络工程师】知识点之入侵防御系统：筑牢网络安全防线

【软考中级网络工程师】知识点之入侵防御系统：筑牢网络安全防线

目录一、入侵防御系统基础概念1.1 定义与作用1.2 与其他安全设备的关系二、入侵防御系统工作原理剖析2.1 数据包捕获与预处理2.2 深度包检测&#xff08;DPI&#xff09;技术2.3 威胁特征匹配2.4 行为分析与机器学习辅助检测2.5 威胁处理与响应机制三、入侵防御系统功能全面解析…
阅读更多...
多种适用于 MCU 固件的 OTA 升级方案

多种适用于 MCU 固件的 OTA 升级方案

大家就当看个乐。 Bootloader A区方案 设计说明 ● 存储分区&#xff1a; ○ Bootloader区&#xff1a;存储引导加载程序&#xff0c;负责启动流程、固件验证和升级逻辑。 ○ A区&#xff1a;存储应用程序固件&#xff0c;运行时由Bootloader跳转到A区执行。 ● 升级流程&…
阅读更多...
一种适用于 3D 低剂量和少视角心脏单光子发射计算机断层成像（SPECT）的可泛化扩散框架|文献速递-深度学习人工智能医疗图像

一种适用于 3D 低剂量和少视角心脏单光子发射计算机断层成像（SPECT）的可泛化扩散框架|文献速递-深度学习人工智能医疗图像

Title题目A generalizable diffusion framework for 3D low-dose and few-view cardiacSPECT imaging一种适用于 3D 低剂量和少视角心脏单光子发射计算机断层成像&#xff08;SPECT&#xff09;的可泛化扩散框架01文献速递介绍心血管疾病&#xff08;CVDs&#xff09;是全球范围…
阅读更多...
解决“Win7共享文件夹其他电脑网络无法发现共享电脑名称”的问题

解决“Win7共享文件夹其他电脑网络无法发现共享电脑名称”的问题

要让运行 Windows 7 的电脑被局域网中其他设备&#xff08;包括另一台电脑、手机、NAS 等&#xff09;“发现”&#xff0c;必须同时满足三个条件&#xff1a; 网络发现功能已启用&#xff1b;对应的后台服务已启动&#xff1b;防火墙规则放行。 下面给出最简、最稳妥的 3 步设…
阅读更多...
最新文章

Copyright @ 2022~2023