Docker 镜像拉取失败？教你更换镜像源
为什么你的 Docker 镜像总是拉取失败
在国内服务器上执行 docker pull 时，经常遇到超时、连接重置或下载极慢的情况。
这本质是因为 Docker 官方镜像仓库（docker.io）的服务器位于海外，国内访问链路不稳定。更换镜像源（也叫镜像加速器） 是直接从国内镜像仓库拉取，速度和成功率都会大幅提升。
下面分三步实操。
准备工具和确认环境
- 一台已经安装 Docker 的 Linux 服务器（CentOS / Ubuntu / Debian 均可）
- 有
sudo或 root 权限 - 能正常执行
docker --version（如果还没安装，先参考官网安装）
本文以 阿里云容器镜像加速器 为例，你也可以换成中科大、腾讯云等。
第一步：修改 Docker 配置文件
Docker 的配置文件通常位于 /etc/docker/daemon.json。
如果该文件不存在，手动创建即可。
sudo mkdir -p /etc/docker
sudo vim /etc/docker/daemon.json在文件中写入以下内容（注意 JSON 格式，不要漏掉逗号）：
{
"registry-mirrors": ["https://你的加速器地址.mirror.aliyuncs.com"]
}提示：阿里云加速器地址需要登录容器镜像服务控制台后，在“镜像工具 > 镜像加速器”中获取。其他加速器如中科大：https://docker.mirrors.ustc.edu.cn。
如果需要多个加速器，用逗号隔开：
{
"registry-mirrors": [
"https://你的加速器地址.mirror.aliyuncs.com",
"https://docker.mirrors.ustc.edu.cn"
]
}第二步：重启 Docker 服务
修改配置文件后必须重启 Docker 才能生效。
sudo systemctl daemon-reload
sudo systemctl restart docker检查是否重启成功：
sudo systemctl status docker看到 active (running) 即可。
第三步：验证镜像源是否生效
执行 docker info，在输出中找到 Registry Mirrors 行：
docker info | grep -A 5 "Registry Mirrors"如果显示你刚才配置的加速器地址，说明换源成功。
接着拉取一个常用镜像测试：
docker pull nginx:latest正常应该以几兆甚至几十兆每秒的速度下载，而不是卡在 waiting 或报 timeout。
高频问题与避坑说明
Q1：配置完 daemon.json 后 Docker 启动失败？
最常见原因是 JSON 格式错误。检查是否有多余逗号、引号不匹配。用 python -m json.tool /etc/docker/daemon.json 可以快速验证。
Q2：更换源后还是拉取失败？
- 确保加速器地址正确（首尾没有多余空格）。
- 检查服务器是否能访问外网（如
ping google.com），有些内网机器需要配置代理，镜像源对这类环境同样有效。 - 尝试使用阿里云或腾讯云的加速器，它们在国内稳定性更好。
Q3：多个镜像源会不会冲突？
不会。Docker 会依次尝试每个源，直到成功。建议配置 2~3 个备用源。
Q4：如何临时跳过镜像源？
使用 --pull=always 或指定官方仓库路径，比如 docker pull library/nginx，但一般不需要。
小结
遇到 Docker 镜像拉取失败？更换镜像源是最直接的修复手段。
只需三步：写配置文件、重启 Docker、验证拉取。
整个过程不需要修改其他系统设置，也不会影响已运行的容器。
如果你在操作中遇到其他报错，可以先回看上面的高频问题部分。
建议将加速器地址妥善保存，以后新装环境直接复用。
现在就去试试 docker pull 吧，速度会让你惊喜。
