为什么docker pull卡半天?LinuxMirrors一键更换Docker镜像加速器,国内可用镜像源全清单

原创2026-09-23 23:13:351,875 阅读

为什么docker pull卡半天?LinuxMirrors一键更换Docker镜像加速器,国内可用镜像源全清单

执行 docker pull 却长时间卡在 "Pulling" 或 "Waiting",转半天没动静?这通常是国内网络无法直连 Docker Hub 导致的。开源项目 LinuxMirrors 提供了一键更换 Docker 镜像加速器 的脚本,一条命令就能把 Docker 的镜像拉取源切换到国内可用镜像源,从此告别 docker pull 卡顿。

Docker镜像加速器一键更换脚本执行命令截图

为什么 docker pull 会卡半天?

Docker 默认从官方容器镜像仓库 Docker Hub 拉取镜像。在国内网络环境下,Docker Hub 访问不稳定甚至完全无法连通,于是拉取过程会出现这些典型症状:

  • docker pull 长时间卡在某一层的下载进度条上
  • 报错 timeout、context deadline exceeded、connection reset by peer
  • 同一个镜像在别人的机器上秒拉,自己这里半天不动

解决办法就是配置「Docker 镜像加速器」:在 /etc/docker/daemon.json 中写入 registry-mirrors 字段,让 Docker 优先从国内镜像站拉取镜像。

手动编辑 JSON 配置文件容易写错格式导致 Docker 服务起不来,而 LinuxMirrors 的 Docker 安装与换源脚本(docs/other/index.md)可以把这个过程完全自动化 ✅

一键安装 Docker 并更换镜像加速器

脚本与官方安装逻辑一致,通过系统包管理器安装 Docker Engine 和 Docker Compose,并自动完成 Docker CE 软件源 和 Registry 镜像仓库(镜像加速器) 的双源切换,支持 ARM 架构,兼容 Debian 系与 RedHat 系及大量衍生发行版:

bash <(curl -sSL https://linuxmirrors.cn/docker.sh)

已经装过 Docker?只换镜像加速器

如果你的 Docker 已经装好了,只是拉取慢,用 --only-registry 参数即可仅更换镜像加速器,不会动已有的 Docker 安装:

bash <(curl -sSL https://linuxmirrors.cn/docker.sh) --only-registry

💡 该模式通过 jq 安全修改配置文件,不会直接覆盖 daemon.json,NAS 等场景也可放心使用。

国内可用镜像源全清单

脚本内置了一批经过验证的 国内可用 Docker 镜像加速器,运行时会交互式供你选择:

站点名称 地址 说明
毫秒镜像 docker.1ms.run 企业镜像站,CDN 智能分发速度极快,推荐使用
Docker Proxy dockerproxy.net 可用性高但速度较慢
DaoCloud 道客 docker.m.daocloud.io 老牌企业镜像站,现为白名单模式
1Panel 镜像 docker.1panel.live 企业产品自用镜像

此外还收录了云厂商加速器和海外仓库,方便不同网络环境的读者:

  • 阿里云:杭州、上海、北京、深圳、成都、香港等全地域节点(registry.cn-*.aliyuncs.com)
  • 腾讯云:mirror.ccs.tencentyun.com
  • 谷歌云:gcr.io(北美)、asia.gcr.io(亚洲)、eu.gcr.io(欧洲)
  • Docker Hub 官方:registry.hub.docker.com

⚠️ 注意:云厂商的镜像加速器仅对自家云平台内网实例生效,家里或机房里的普通服务器用不到,优先选择清单前 4 个公开加速器。

高级用法:手动指定镜像仓库地址

想自己指定某个加速器(或配置多个做冗余)?用 --source-registry 参数,多个地址用英文逗号分割:

bash <(curl -sSL https://linuxmirrors.cn/docker.sh) \
  --only-registry \
  --source-registry "docker.1ms.run,docker.1panel.live,docker.m.daocloud.io"

一键写入多个镜像源后,Docker 会在它们之间自动容灾切换,某个镜像站抽风时还能继续拉取 🚀

验证更换是否成功

执行以下命令查看当前生效的加速器地址,再随便拉一个小镜像试试速度:

docker info | grep -A 3 "Registry Mirrors"
docker pull hello-world

顺带一提:Linux 系统软件源也能一键换

LinuxMirrors 不止能做 Docker 换源,它本身是一个 GNU/Linux 系统软件源更换脚本,覆盖 Debian、Ubuntu、CentOS 等 30+ 发行版,一条命令解决 apt / yum 源慢的问题:

Linux系统软件源一键更换命令截图

bash <(curl -sSL https://linuxmirrors.cn/main.sh)

更多文档与资料

资源 路径
Docker 安装与换源脚本说明 docs/other/index.md
使用方法(一键执行命令) docs/use/index.md
Docker 安装换源主脚本 DockerInstallation.sh
Docker 精简版脚本 DockerInstallationLite.sh
自动化安装示例 docs/other/example2.md
完整命令选项说明 docs/other/index.md

docker pull 卡半天的问题,本质就是网络到 Docker Hub 的路被堵了。用 LinuxMirrors 一条命令换好镜像加速器,拉镜像的速度立竿见影——建议把上面这份国内可用镜像源清单收藏起来,换机器时直接复用 🎯

登录后查看全文