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)。
如果文件不存在,直接新建一个。
- 用 vim 或 nano 创建/编辑配置:
sudo vim /etc/docker/daemon.json
- 粘贴以下内容(以阿里云、中科大和网易的加速器为例):
{
"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可直接使用,无需注册。
- 保存文件(vim 按
Esc,输入:wq回车)。 - 重新加载配置并重启 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.io、quay.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 中的地址即可。