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
系统公告

机房迁移升级通知

尊敬的用户: IP 段 103.23.148.x、156.224.29.x 原香港一区线路波动、攻击频繁,平台定于 7 月 5 日凌晨分批迁移至香港 GIA 机房,硬件升级 AMD 铂金机型。 迁移均在凌晨操作,最大程度降低业务影响,迁移期间服务器临时关机; 升级后配置不降低、费用不涨价,数据默认同步迁移; 迁移后 IP 全部更换,请及时修改域名解析、防火墙白名单; 建议提前备份重要数据,有问题可联系在线客服。 感谢理解与支持! 泽御云科技 2026.06.30
服务中心
客服
在线客服
24小时为您服务
咨询
联系我们
联系我们,为您的业务提供专属服务。
24/7 技术支持
如果您遇到寻求进一步的帮助,请过工单与我们进行联系。
24/7 即时支持
泽御云
售前客服
泽御云
泽御云
售后客服
泽御云
技术支持
评价
您对当前页面的整体感受是否满意?
😞
非常不满意
😕
不满意
😐
一般
🙂
满意
😊
非常满意