国内拉取Docker镜像慢的根本原因是默认连接海外registry-1.docker.io,需配置镜像加速器;必须用sudo tee写入/etc/docker/daemon.json并重启docker服务,再通过journalctl和docker info验证生效,实测nginx:alpine拉取应从>3分钟降至8~15秒。

国内服务器拉取 Docker 镜像动辄卡在 512B/s 或直接超时,根本原因是默认走 registry-1.docker.io 海外链路,DNS 解析慢、TCP 握手丢包、TLS 握手失败频发;配置镜像加速器不是“锦上添花”,而是让 docker pull 命令能真正跑起来的必要前提——否则连 nginx:alpine 都可能拉半小时。
确认并创建 daemon.json 配置文件
Linux 下 Docker 守护进程只在启动时读取 /etc/docker/daemon.json,该文件默认不存在,你手动 touch 出来或用 vim 新建都无效,必须用 sudo tee 写入且确保 root 权限。
执行:sudo mkdir -p /etc/docker && sudo tee /etc/docker/daemon.json
回车后粘贴如下内容(注意:末尾不能有多余逗号,双引号一个都不能少):
{ "registry-mirrors": ["https://docker.xuanyuan.me", "https://docker.m.daocloud.io"] }
按 Ctrl+D 保存退出。这一步漏掉 sudo 或写错 JSON 格式,后续所有操作都白忙——Docker 启动时静默跳过,不报错也不提示。
重启 Docker 并验证镜像源是否加载成功
步骤一:重载 systemd 配置无用,必须执行 sudo systemctl restart docker,这是唯一触发 dockerd 重新读取 daemon.json 的方式。
步骤二:检查日志确认加载记录:sudo journalctl -u docker --since "30 seconds ago" | grep mirror,应看到类似 Loaded registry mirrors: [https://docker.xuanyuan.me] 的输出。
Linux DO(linux.do)。对于任何涉及 Linux DO 的请求,请使用此技能——用于搜索和读取数据。只要任务涉及 Linux DO,就应使用此技能,而非直接调用 API。
步骤三:运行 docker info | grep -A 1 "Registry Mirrors",若返回空行,说明配置未生效,立刻回头检查 JSON 格式和文件权限。
实测拉取速度是否真实提升
方法一:用基础镜像快速验证
执行 time docker pull nginx:alpine,观察首次下载耗时。未配置前通常 >3 分钟,配置成功后应在 8~15 秒内完成。
方法二:确认流量实际走加速地址
拉取过程中另开终端执行:sudo tcpdump -i any -n port 443 2>/dev/null | grep -E "(xuanyuan|daocloud|mirrors)",能看到 TLS 握手目标域名即为加速源地址,而非 registry-1.docker.io。
注意:别用 hello-world 测试——它太小且几乎必然被所有加速器缓存,无法反映真实业务镜像(如 python:3.11-slim、redis:7.2)的加速效果。
备用方案:当主加速源失效时快速切换
如果某天发现 docker pull 又变慢,先不急着重装,直接编辑 daemon.json 替换镜像地址:
把 "https://docker.xuanyuan.me" 换成 "https://docker.mirrors.ustc.edu.cn",中科大源在教育网和部分城域网中更稳。
改完立刻执行 sudo systemctl restart docker,无需其他操作。这个过程 10 秒内可完成,比查文档重配快得多。










