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

发布于:2025-08-08 ⋅ 阅读:(59) ⋅ 点赞:(0)

前言

你是否刚在你的 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/ 目录下。如果该文件或目录不存在,请手动创建它。

你可以使用 vimnano 等你熟悉的文本编辑器来打开它:

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 下方已经出现了我们配置的腾讯云地址,大功告成!

总结

现在,再次尝试 docker pull 一个镜像,例如 docker pull hello-world 或者 docker pull ubuntu,你将会体验到飞一般的下载速度。

为 Docker 配置镜像加速器是在国内使用 Docker 的必备操作之一,也是你 Docker 之旅的平稳起点。希望这篇教程对你有所帮助!


网站公告

今日签到

点亮在社区的每一天
去签到