Docker如何更换镜像源提高拉取速度

news2025/4/22 11:48:42

在这里插入图片描述

在国内，由于网络政策和限制，直接访问DockerHub速度很慢，尤其是在拉取大型镜像时。为了解决这个问题，常用的方法就是更换镜像源。本文将详细介绍如何更换Docker镜像源，并提供当前可用的镜像源。

换源方法

方法1：临时换源

如果只是偶尔需要使用其他镜像源，可以在每次拉取镜像时指定镜像源。示例如下：

sudo docker pull 镜像源地址/镜像名

例如，拉取hello-world镜像：

sudo docker pull docker.m.daocloud.io/hello-world

注意：

每次拉取镜像时都需要指定镜像源。如果忘记指定，Docker将默认从DockerHub拉取镜像，速度会很慢。
这种方法适合偶尔需要临时换源，但每次都要手动指定镜像源，操作繁琐。

方法2：永久换源（推荐）

为了避免每次都手动指定镜像源，我们可以修改Docker配置文件，永久性地更换镜像源。只需设置一次，之后每次拉取镜像都会自动使用新的镜像源。

1. 创建配置目录

首先需要创建一个配置目录，通常在/etc/docker下：

sudo mkdir -p /etc/docker

解释： mkdir -p会检查目录是否存在，如果不存在则创建，因此可以直接执行，不会报错。

2. 修改`daemon.json`配置文件

然后需要在该目录下创建（或修改）daemon.json文件，并将镜像源地址写入文件。可以使用命令行直接输入配置：

sudo tee /etc/docker/daemon.json <<-'EOF'
{
    "registry-mirrors": [
    	"https://docker.m.daocloud.io",
    	"https://docker.imgdb.de",
    	"https://docker-0.unsee.tech",
    	"https://docker.hlmirror.com",
    	"https://docker.1ms.run",
    	"https://func.ink",
    	"https://lispy.org",
    	"https://docker.xiaogenban1993.com"
    ]
}
EOF

或者，你可以使用文本编辑器打开文件并粘贴配置：

sudo nano /etc/docker/daemon.json

然后粘贴以下内容：

{
    "registry-mirrors": [
    	"https://docker.m.daocloud.io",
    	"https://docker.imgdb.de",
    	"https://docker-0.unsee.tech",
    	"https://docker.hlmirror.com",
    	"https://docker.1ms.run",
    	"https://func.ink",
    	"https://lispy.org",
    	"https://docker.xiaogenban1993.com"
    ]
}

3. 重启Docker服务

修改完配置后，必须重启Docker服务才能使新的镜像源生效：

sudo systemctl daemon-reload && sudo systemctl restart docker

解释： daemon-reload命令告诉系统重新加载配置文件，restart docker则会重启Docker服务，应用新的配置。

4. 验证配置

最后，验证是否配置成功，可以通过拉取一个简单的镜像来测试，例如hello-world：

sudo docker pull hello-world

如果配置成功，你应该看到如下输出（镜像拉取成功）：

Hello from Docker!
This message shows that your installation appears to be working correctly.

如果出现其他错误信息，说明配置可能没有生效或者镜像源无法访问。

常见问题及解决方案

1. `docker search`无法使用

镜像源的加速功能仅支持docker pull，即拉取镜像。当使用docker search命令时，镜像源并不加速此操作。因为search命令需要访问DockerHub官方仓库，而镜像源仅能加速拉取操作。

解决方法： 如果需要使用docker search，可以考虑使用VPN或科学上网来访问DockerHub，或者直接从官方仓库查找镜像。

2. 换源后报错

如果在换源之后依然遇到问题，可能会出现以下错误信息：

Error response from daemon: Get https://registry-1.docker.io/v2/: dial tcp: lookup registry-1.docker.io on 127.0.0.11:53: no such host

这通常是因为配置文件未正确加载或者镜像源不可用。此时，建议执行以下操作：

检查配置文件： 确保/etc/docker/daemon.json文件格式正确，且镜像源地址无误。
重启Docker服务： 确保执行了sudo systemctl daemon-reload && sudo systemctl restart docker命令。
测试镜像源： 使用sudo docker pull hello-world来测试镜像源是否可用。

3. 如何测试镜像源是否可用

可以通过拉取hello-world镜像来测试镜像源是否正常工作。虽然它不代表所有镜像都可用，但它是一个标准的基础镜像，适合用于测试。

sudo docker pull hello-world

如果能够成功拉取，说明镜像源工作正常。如果失败，可能是网络问题或镜像源不可用。

换源速通版

为了快速配置，直接复制以下命令：

# 创建目录
sudo mkdir -p /etc/docker

# 配置镜像源
sudo tee /etc/docker/daemon.json <<-'EOF'
{
    "registry-mirrors": [
    	"https://docker.m.daocloud.io",
    	"https://docker.imgdb.de",
    	"https://docker-0.unsee.tech",
    	"https://docker.hlmirror.com",
    	"https://docker.1ms.run",
    	"https://func.ink",
    	"https://lispy.org",
    	"https://docker.xiaogenban1993.com"
    ]
}
EOF

# 重启Docker服务
sudo systemctl daemon-reload && sudo systemctl restart docker

# 验证配置
sudo docker pull hello-world