Calico 镜像拉取加速:把镜像前缀换到 DaoCloud 镜像站 docker.m.daocloud.io
【免费下载链接】public-image-mirror很多镜像都在国外。比如 gcr 。国内下载很慢，需要加速。致力于提供连接全世界的稳定可靠安全的容器镜像服务。项目地址: https://gitcode.com/GitHub_Trending/pu/public-image-mirror
部署 Kubernetes 集群时,Calico 镜像拉取慢、中途超时,这篇文章讲如何把 Calico 镜像前缀指到 DaoCloud 镜像站 docker.m.daocloud.io,包括换前缀的具体做法和验证方法,不需要改动其他配置。
镜像拉取不顺,通常先查源,不急着改配置
用 kubeadm 或官方脚本部署 Calico 时,安装器要依次从 Docker Hub 拉取一串镜像。国内网络下,这一步经常是部署速度的第一个瓶颈:拉得慢,安装步骤长时间卡住;拉超时,整个部署流程就要重来。
遇到问题时先别急着改 CNI 参数或集群配置。更稳妥的做法是先确认失败原因:是镜像地址拉不动,还是节点网络本身不通。多数情况下,只需要换一下镜像源就能解决。
为什么把 Calico 镜像指到 DaoCloud 更稳妥
选镜像源主要看三点。同步机制上,DaoCloud 镜像站是上游源仓库的 Mirror,镜像的 sha256 与源保持一致,换前缀后拉到的内容仍然是官方那份,不会引入未知改动。覆盖范围上,仓库公开的白名单文件 allows.txt 里包含docker.io/calico/*,Calico 相关镜像在列,可以直接拉取,不必单独申请。维护成本上,只需改前缀字符串,不用动部署脚本,回退到原源时同样是一行字的事。
可以优先尝试这个源,但别随便找个来路不明的站就换上,源的同步频率和可用性会直接影响部署体验。
Calico 镜像前缀怎么换
做法只有一个:把镜像地址的前缀从docker.io换成docker.m.daocloud.io,后面的仓库名、镜像名和 tag 保持原样。以 v3.26.1 为例,三个核心组件替换后是:
docker.m.daocloud.io/calico/node:v3.26.1 docker.m.daocloud.io/calico/cni:v3.26.1 docker.m.daocloud.io/calico/kube-controllers:v3.26.1如果走的是清单文件,改对应 image 字段即可;走安装参数的话,按各自工具提供的镜像仓库变量传入。组件名和版本号都不用动。
替换后如何快速确认生效
换完前缀,在任一能访问镜像站的节点上做三步确认。第一,直接对一个新地址执行拉取,能完整拉完不报 404、不超时,是最直接的信号。第二,用docker images看 tag 是否对上,再用docker inspect核对摘要值。第三,回到集群侧看事件:Calico 相关 Pod 从 ImagePullBackOff 变为 Running,就说明部署链路已经通了。
常见失败各有方向:报 404 或 manifest unknown,多半是名字或 tag 写错,先和官方源的可用 tag 对一下;首次拉取偏慢,可能是该镜像还未在缓存中,按需触发同步,稍等片刻重试即可;DNS 解析失败则优先排查节点网络,而不是重复换源。
哪些 K8s 组件也适用同样做法
同样的换前缀思路,对 Kubernetes 生态里其他常见组件也有效,但适用范围以各源站的白名单为准:
- registry.k8s.io 下的 etcd、kube-proxy、coredns 等核心组件,换成
k8s.m.daocloud.io前缀,例如 kubeadm 里设置 imageRepository。 - Docker Hub 下的其他公开镜像,包括 kind 测试集群节点镜像,可以用
docker.m.daocloud.io前缀拉取。 - 其他源站的镜像要按 DaoCloud 镜像站文档里对应的前缀规则来配,不要对任何镜像都用 docker.m.daocloud.io。
对应命名空间不在白名单里时,换前缀大概率会得到 404,这种情况就保持原源。
一个稳定的 Kubernetes 镜像源是容器化部署顺利跑起来的重要前提。关键动作其实只有两个:先选一个可靠的源,再改对一处前缀。
【免费下载链接】public-image-mirror很多镜像都在国外。比如 gcr 。国内下载很慢，需要加速。致力于提供连接全世界的稳定可靠安全的容器镜像服务。项目地址: https://gitcode.com/GitHub_Trending/pu/public-image-mirror
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
