国内 Docker 镜像加速实操:以 Kafka 镜像为例【免费下载链接】public-image-mirror很多镜像都在国外。比如 gcr 。国内下载很慢需要加速。致力于提供连接全世界的稳定可靠安全的容器镜像服务。项目地址: https://gitcode.com/GitHub_Trending/pu/public-image-mirror在国内拉取 Apache Kafka(bitnami 版)这类 Docker 镜像时,经常会遇到下载慢或中途断开。本文用 DaoCloud 的 public-image-mirror 项目,带你把镜像地址改写成国内链路,完成一次可复现的拉取。先说结论加速地址的通用写法:在原始镜像地址前加前缀m.daocloud.io,例如m.daocloud.io/docker.io/bitnami/kafka:3.9.0。另一种写法是前缀替换:README 中列了 11 个源站,docker.io可替换为docker.m.daocloud.io,gcr.io替换为gcr.m.daocloud.io,依此类推。什么情况下别用:目标镜像不在白名单 allows.txt 里(它记录了所有允许同步的镜像规则,当前有 1300 余行),或者你拉的是私有、内网自建的镜像,这两类都走不了这条链路。原理一张图整条链路是懒加载的:只有第一次请求才会触发回源,同步后的缓存内容会保留 30 天。上手路径白名单检查有两种方式。粗查用 grep,精确判断用仓库自带的 hack/verify-allows.sh(按白名单规则判断某个镜像地址是否在允许范围内,镜像地址不带 tag):grep -n bitnami allows.txt bash hack/verify-allows.sh allows.txt docker.io/bitnami/kafka第一条出现docker.io/bitnami/*这种通配行,说明整个命名空间都支持;第二条退出码为 0 即代表该镜像地址在白名单中。地址改写时,把原始地址和加速地址对照着换即可:原始地址加速地址规则docker.io/bitnami/kafka:3.9.0m.daocloud.io/docker.io/bitnami/kafka:3.9.0加前缀docker.io/bitnami/kafka:3.9.0docker.m.daocloud.io/bitnami/kafka:3.9.0前缀替换 docker.iogcr.io/某个镜像:taggcr.m.daocloud.io/某个镜像:tag前缀替换 gcr.io拉取后做一遍自检:docker pull m.daocloud.io/docker.io/bitnami/kafka:3.9.0 docker images | grep bitnami第一条末尾出现Downloaded newer image即拉取成功;第二条列表里能看到 tag 为3.9.0的那行,即本地镜像就绪。拉不到怎么办现象常见原因处理404 manifest unknowntag 不存在;或用了 latest 这类可变 tag,而 manifest 有 1 小时缓存延迟确认 tag 真实存在;把 latest 换成固定版本 tag拉取报 403 或始终无同步任务镜像不在白名单查 allows.txt;确需新增,向 public-image-mirror 仓库的 issues 提请求请求没走加速链路,仍连海外源站前缀写错:m.daocloud.io和docker.m.daocloud.io是两种规则,别混用,加前缀时docker.io段不能省略按「上手路径」的对照表重新改写地址第一次拉取很慢,之后正常懒加载机制:首次请求要回源同步属正常现象,可稍后再拉,或错峰执行集群级配置单台机器验证没问题后,可以把加速写进 containerd(1.6 及以下版本)的全局配置:# /etc/containerd/config.toml [plugins.io.containerd.grpc.v1.cri.registry.mirrors.docker.io] endpoint [https://docker.m.daocloud.io]注意 README 里的一条提醒:docker 的 registry-mirrors 只配置 docker.io,不要把其他源站指向它;containerd 1.7 及以上可改用certs.d/docker.io/hosts.toml方式,思路相同。预热不需要额外工具,直接拉一次目标镜像就会触发回源同步:docker pull m.daocloud.io/docker.io/bitnami/kafka:3.9.0同步过程中可以去队列状态页看任务进度(只保留最近一小时的记录)。上生产前,建议把三件事做掉:低峰预热:README 建议把拉取任务放在北京时间 01-07 点的闲时,白天高峰期链路比较拥挤核对哈希:同步完成后确认镜像 sha256 与源站一致,再更新部署清单保留直连回退:缓存只保留 30 天,过期会重新同步,重要业务保留一条可直连源站的回退通道延伸阅读README.md:完整的前缀替换表和各客户端(Docker、containerd、Podman)的配置位置,动手前先翻一遍。队列状态页:https://queue.m.daocloud.io/status/ —— 拉取卡住、怀疑没同步到位时,来这里查最近一小时的同步记录。public-image-mirror 仓库的 issues 页面:需要新增镜像或新增前缀替换规则时,在这里提交请求,入口见源仓库 README。Kafka 只是一个例子,白名单里的其他镜像照着「查白名单、改地址、拉取自检」这三步做就行。【免费下载链接】public-image-mirror很多镜像都在国外。比如 gcr 。国内下载很慢需要加速。致力于提供连接全世界的稳定可靠安全的容器镜像服务。项目地址: https://gitcode.com/GitHub_Trending/pu/public-image-mirror创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
