Docker镜像加速器配置提速:零基础手把手配置指南

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

在国内使用 Docker 拉取镜像时,默认从 Docker Hub 下载,由于服务器在海外,经常出现进度条卡顿、下载超时甚至失败的情况。
配置镜像加速器相当于让 Docker 从国内镜像源拉取数据,速度能提升几十倍。
本文针对零基础用户,从检查环境到最终验证,每一步都写清楚命令和配置文件,确保你能一次成功。

准备工作:确认 Docker 已安装并能正常使用

执行下面命令查看 Docker 是否运行:

docker info

如果输出中显示 "Server Version: xxx",说明 Docker 已启动。
如果提示找不到命令,需要先安装 Docker。
安装方法(Ubuntu / Debian 为例):

sudo apt update
sudo apt install docker.io -y

CentOS 用户用 yum install docker -y,安装后启动并设为开机自启:

sudo systemctl start docker
sudo systemctl enable docker

注意:Windows 或 macOS 用户请跳过命令步骤,直接打开 Docker Desktop 设置界面配置。

动手配置:编辑 daemon.json 文件

Docker 的配置存储在 /etc/docker/daemon.json(Linux)或用户目录下的 .docker/daemon.json(Windows/macOS)。
如果文件不存在,直接新建一个。

  1. 用 vim 或 nano 创建/编辑配置:
sudo vim /etc/docker/daemon.json
  1. 粘贴以下内容(以阿里云、中科大和网易的加速器为例):
{
  "registry-mirrors": [
    "https://yourid.mirror.aliyuncs.com",
    "https://docker.mirrors.ustc.edu.cn",
    "https://hub-mirror.c.163.com"
  ]
}
说明:阿里云加速器需要登录容器镜像服务控制台获取专属地址(免费)。用 https://yourid.mirror.aliyuncs.com 替换,其中 yourid 是你的阿里云账号 ID。中科大的 https://docker.mirrors.ustc.edu.cn 和网易的 https://hub-mirror.c.163.com 可直接使用,无需注册。
  1. 保存文件(vim 按 Esc,输入 :wq 回车)。
  2. 重新加载配置并重启 Docker:
sudo systemctl daemon-reload
sudo systemctl restart docker

Windows/macOS 用户在 Docker Desktop 设置中找到 "Docker Engine" 选项卡,
把上面的 JSON 粘贴进去,
点击 "Apply & Restart" 即可。

常见坑和解决方法

  • daemon.json 格式错误:Docker 启动失败,报错 parse error。检查 JSON 是否多了逗号或引号不匹配。可以用在线 JSON 校验工具或者运行 docker info 看是否报错。
  • 重启后提示 "systemctl daemon-reload" 找不到:部分旧系统用 service docker restart 即可。如果都不行,直接重启机器。
  • 加速器地址写错:拉镜像时依然慢或报错 timeout。检查地址是否包含 http:// 或缺少 https://,Docker 建议使用 https
  • 只有部分镜像加速:某些私有镜像库(如 gcr.ioquay.io)不在加速范围内,需要单独配置代理或镜像。

额外提醒:如果你之前用 --registry-mirror 启动参数,优先使用 daemon.json 配置,两者冲突可能导致无效。
建议统一使用配置文件方式。

验证加速效果

拉取一个常见镜像测试速度:

time docker pull nginx:latest

对比配置之前的时间(通常需要几分钟),配置后一般 10~30 秒就能完成。
如果看到进度条快速跑完,说明加速器生效。

也可以同时拉取多个镜像感受差异:

docker pull alpine
docker pull busybox

最后检查一下当前使用的镜像源是否生效:

docker info | grep -A 1 "Registry Mirrors"

输出会列出你配置的加速器地址。
至此,Docker 镜像加速器配置提速全部完成。
后续如果更换网络环境或加速器失效,按本文步骤更新 daemon.json 中的地址即可。

分享到:
上一篇
零基础Python自动化运维脚本案例:自动备份网站目录
下一篇
Docker Compose模板合集复用
1
系统公告

高考专属福利来袭|凭准考证免费领香港 CN2 云服务器

值高考落幕之际,泽御云开启考生专属回馈 + 产品限时特惠双重活动,助力学子暑期学习建站 高考 考生专属福利 全体应届高考生,凭高考准考证即可免费申领【香港 CN2 轻量云服务器,4 核 4G AMD 处理器】,免费使用周期 30 天,可用于搭建个人站点、编程实操、技术实训,祝各位考生金榜题名,前程似锦! 泽御云资质齐全合规自营机房,线路覆盖香港 CN2、国内 BGP、内蒙电信、美国精品线路,售后全天候技术支持。 官方网站:www.zeyuyun.com,活动限时有效,优惠逾期不再保留。
服务中心
客服
在线客服
24小时为您服务
咨询
联系我们
联系我们,为您的业务提供专属服务。
24/7 技术支持
如果您遇到寻求进一步的帮助,请过工单与我们进行联系。
24/7 即时支持
泽御云
售前客服
泽御云
泽御云
售后客服
泽御云
技术支持
评价
您对当前页面的整体感受是否满意?
😞
非常不满意
😕
不满意
😐
一般
🙂
满意
😊
非常满意