为什么docker pull卡半天?LinuxMirrors一键更换Docker镜像加速器,国内可用镜像源全清单
为什么docker pull卡半天?LinuxMirrors一键更换Docker镜像加速器,国内可用镜像源全清单
执行 docker pull 却长时间卡在 "Pulling" 或 "Waiting",转半天没动静?这通常是国内网络无法直连 Docker Hub 导致的。开源项目 LinuxMirrors 提供了一键更换 Docker 镜像加速器 的脚本,一条命令就能把 Docker 的镜像拉取源切换到国内可用镜像源,从此告别 docker pull 卡顿。
为什么 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 源慢的问题:
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 一条命令换好镜像加速器,拉镜像的速度立竿见影——建议把上面这份国内可用镜像源清单收藏起来,换机器时直接复用 🎯

