当前位置：首页 > news >正文

Linux Docker 新手入门：一文学会配置镜像加速器

news 2025/8/8 7:06:01

文章目录

- - 前言
  - 准备工作
  - 为什么要配置镜像加速器？
  - 配置步骤
  - - 第一步：创建或编辑 Docker 配置文件
    - 第二步：添加镜像源地址
    - 第三步：重启 Docker 服务
    - 第四步：验证配置是否生效
  - 总结

前言

你是否刚在你的 Linux 系统上安装好 Docker，正准备大展身手，却发现使用 docker pull 命令从官方 Docker Hub 拉取镜像时，速度慢如蜗牛，甚至频繁失败？

这通常是由于网络原因，访问国外的 Docker Hub 服务器存在延迟。别担心，这并非无解难题。通过配置国内的镜像加速器，我们可以将请求重定向到国内的镜像服务器，从而极大地提升下载速度，让你的 Docker 使用体验如丝般顺滑。

本文将手把手教你如何在 Linux 系统上为 Docker 配置镜像加速器。

准备工作

在开始配置之前，请确保你已经在你的 Linux 系统（如 CentOS, Ubuntu, Debian 等）上成功安装了 Docker。如果你尚未安装，可以参考 Docker 的官方文档进行安装。

为什么要配置镜像加速器？

Docker 官方的镜像仓库（Docker Hub）部署在国外。当我们执行 docker pull <镜像名> 时，默认会从国外的服务器上下载。受限于国际网络带宽和防火墙等因素，下载过程可能会非常缓慢。

镜像加速器（Registry Mirror）本质上是一个部署在国内的缓存服务器，它会缓存 Docker Hub 上的常用镜像。当你配置了加速器后，Docker 会优先从这个国内的服务器拉取镜像，从而实现“加速”的效果。

配置步骤

配置过程非常简单，我们只需要修改（或创建）一个 Docker 的配置文件即可。以下步骤参考了腾讯云提供的方案，该方法也同样适用于其他国内主流镜像源。

第一步：创建或编辑 Docker 配置文件

首先，我们需要找到 Docker 的守护进程配置文件 daemon.json。这个文件通常位于 /etc/docker/ 目录下。如果该文件或目录不存在，请手动创建它。

你可以使用 vim 或 nano 等你熟悉的文本编辑器来打开它：

sudo vim /etc/docker/daemon.json

第二步：添加镜像源地址

在打开的 daemon.json 文件中，添加以下内容。这里我们使用图片中示例的腾讯云镜像加速地址。

{"registry-mirrors": ["https://mirror.ccs.tencentyun.com"]
}

提示： 如果文件原本就有内容，请确保你添加的是一个合法的 JSON 键值对。例如，如果已有其他配置，应该是这样：

{"other-config": "value","registry-mirrors": ["https://mirror.ccs.tencentyun.com"]
}

除了腾讯云，你也可以选择其他服务商提供的免费镜像加速器，例如：

阿里云加速器 (需要登录阿里云容器镜像服务获取专属地址)
网易云加速器: http://hub-mirror.c.163.com
Docker 中国官方镜像: https://registry.docker-cn.com

只需将上面 JSON 中的 URL 替换成你选择的地址即可。

第三步：重启 Docker 服务

配置修改完成后，我们需要重启 Docker 服务来让新的配置生效。

# 重新加载配置
sudo systemctl daemon-reload
# 重启 Docker 服务
sudo systemctl restart docker

第四步：验证配置是否生效

最后一步，我们需要验证一下加速器是否配置成功。执行以下命令：

sudo docker info

在输出的大量信息中，找到 Registry Mirrors 这一项。如果你能看到你所配置的加速器地址，那就说明配置已经成功生效了！

# ... 省略其他信息 ...
Server Version: 24.0.5
Storage Driver: overlay2
# ... 省略其他信息 ...
Registry: https://index.docker.io/v1/
Registry Mirrors:https://mirror.ccs.tencentyun.com/
Live Restore Enabled: false
# ... 省略其他信息 ...

如上图所示，Registry Mirrors 下方已经出现了我们配置的腾讯云地址，大功告成！