5分钟搞定容器镜像加速public-image-mirror 国内镜像拉取提速实战指南【免费下载链接】public-image-mirror很多镜像都在国外。比如 gcr 。国内下载很慢需要加速。致力于提供连接全世界的稳定可靠安全的容器镜像服务。项目地址: https://gitcode.com/GitHub_Trending/pu/public-image-mirrorpublic-image-mirror 是 DaoCloud 开源的容器镜像加速项目核心思路极简给原始镜像地址加上m.daocloud.io/前缀就能为 gcr.io、docker.io、quay.io 等海外镜像仓库提供国内高速通道把镜像拉取等待时间从分钟级压到秒级。本文带你从原理到落地5 分钟上手并附上 4 个真实踩坑案例。核心速览三句话讲完怎么用加前缀推荐docker.io/library/busybox→m.daocloud.io/docker.io/library/busybox换前缀docker.io/library/busybox→docker.m.daocloud.io/library/busybox放心用加速服务不篡改镜像所有 sha256 与源仓库完全一致破局思路为什么你的镜像总是卡在 Waiting先还原一个熟悉到麻木的场景你执行docker pull gcr.io/...进度条停在 0% 十几分钟最后超时甩给你一个报错。这不是你网速不行而是镜像仓库的物理位置在国外。国内网络访问海外 Registry数据要走漫长的跨国链路再叠加路由拥塞几十 MB 的小镜像也能拉到怀疑人生。问题的本质是取货点离你太远。与其自己搭代理、改网关、维护一堆不可控的通道不如在离你近的地方设一个中转站。public-image-mirror 就是这个中转站它按需同步海外各大 Registry 的镜像懒加载机制你只需要在原始地址前加一个国内前缀Docker 就会从国内节点拉取速度直接上一个数量级。最难得的是它的简单不需要改一行业务代码不需要理解复杂的 Registry 协议规则就是一条纯粹的名称映射。gcr.io 镜像拉取加速、quay 仓库加速、k8s 官方组件加速……全都能用同一套逻辑覆盖。落地三步走第一步先用一条命令验证加速通道不必急着改任何配置先跑一条命令感受效果docker run -d -P m.daocloud.io/docker.io/library/nginx预期效果几秒内完成拉取并启动容器首次拉取因懒加载会稍慢之后命中缓存就飞快。看到容器 ID 输出说明加速通道已经打通可以放心进入下一步。第二步完成 Docker 与 Kubernetes 镜像加速配置单条命令只治标。想让日常所有拉取都自动走加速通道建议按场景做长效配置。Docker 场景编辑/etc/docker/daemon.json加入{ registry-mirrors: [ https://docker.m.daocloud.io ] }然后systemctl restart docker重启生效。请注意registry-mirrors只对 docker.io 生效其他仓库要用加前缀的方式。Kubernetes 场景安装集群时直接指定国内源在 kubeadm 配置里加一行imageRepository: k8s.m.daocloud.ioPodman 场景在/etc/containers/registries.conf中为每个仓库单独配置 mirror例如 gcr.io 对应gcr.m.daocloud.io、quay.io 对应quay.m.daocloud.io支持度比 Docker 更完整。预期效果配置完成后你日常的docker pull、集群初始化、容器运行时拉取全部走加速路径不再需要手动改写任何镜像地址。第三步验证加速确实生效拉取完成后用一条命令确认镜像来源与完整性docker inspect docker.m.daocloud.io/library/busybox --format {{.RepoDigests}}预期效果输出的 digest 与官方源仓库的 sha256 完全一致说明加速服务只是搬运工、绝不动镜像内容可以放心用于生产环境。避坑清单四个踩过的坑坑一白天拉镜像依然慢现象加了前缀还是经常超时、进度条龟速。 原因公共加速服务在北京时间白天高峰段非常拥挤大家都在抢带宽。 解决办法把批量拉取任务放到凌晨 01-07 点执行优先用sha256:指定镜像其次用明确版本号的 tag最后才考虑latest——可变 tag 每次变更都会触发后台重新同步等于主动给缓存添堵。坑二上游更新了拉到的却是旧镜像现象项目刚发新版本加速地址拉下来还是老内容。 原因Manifest 有 1 小时内存缓存tag 变更后需要约 1 小时才会同步新数据。 解决办法耐心等一小时再拉关键场景直接用 sha256 digest 精确定位不受 tag 漂移影响。坑三某个镜像突然报 404现象以前能正常拉取某天突然报 manifest unknown 或 blob 404。 原因缓存内容只保留 30 天过期后需要重新同步且 blob 存在 1 分钟内存缓存窗口恰好撞上删除会被误判为不存在。 解决办法直接重试一次拉取触发懒加载重新同步即可恢复。坑四把 gcr.io 配进了 Docker 的 registry-mirrors现象daemon.json 配了一堆镜像源gcr 的镜像依旧拉不动。 原因Docker 的registry-mirrors机制只对 docker.io 生效配其他仓库地址是无效的。 解决办法非 docker.io 的仓库统一走加前缀方式例如m.daocloud.io/gcr.io/...省心且可靠。延伸与进阶基础配置顺手之后你可以把加速能力放大到整个团队甚至整个机房内网镜像缓存部署企业环境建议在机房部署一个本地缓存代理所有节点统一走内网拉取彻底摆脱公网波动和高峰拥挤。部署步骤见仓库内文档 docs/local-cache/README.md一条docker compose up -d即可启动之后只需在原始地址前加内网地址/前缀。Pod 镜像自动改写不想逐个改 yaml 和 Helm可以部署 repimage Webhook自动把所有新建 Pod 的镜像地址替换为加速地址对存量编排零侵入适合大规模集群。AI 模型加速项目还支持 Ollama 与 DeepSeek 模型的加速拉取和运行玩本地大模型同样受益。如果你发现某个镜像不在支持列表里白名单记录在仓库根目录allows.txt可以去提交 Issue 附上仓库路径维护者评估后就会添加——这也是参与项目贡献最直接的方式。现在就动手克隆仓库git clone https://gitcode.com/GitHub_Trending/pu/public-image-mirror先跑通第一条加速命令再按你的场景完成配置。遇到问题优先翻本文的避坑清单解决不了就去项目里提交 Issue把你的经验分享回来帮到下一个卡在 Waiting 的人。【免费下载链接】public-image-mirror很多镜像都在国外。比如 gcr 。国内下载很慢需要加速。致力于提供连接全世界的稳定可靠安全的容器镜像服务。项目地址: https://gitcode.com/GitHub_Trending/pu/public-image-mirror创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
5分钟搞定容器镜像加速：public-image-mirror 国内镜像拉取提速实战指南
5分钟搞定容器镜像加速public-image-mirror 国内镜像拉取提速实战指南【免费下载链接】public-image-mirror很多镜像都在国外。比如 gcr 。国内下载很慢需要加速。致力于提供连接全世界的稳定可靠安全的容器镜像服务。项目地址: https://gitcode.com/GitHub_Trending/pu/public-image-mirrorpublic-image-mirror 是 DaoCloud 开源的容器镜像加速项目核心思路极简给原始镜像地址加上m.daocloud.io/前缀就能为 gcr.io、docker.io、quay.io 等海外镜像仓库提供国内高速通道把镜像拉取等待时间从分钟级压到秒级。本文带你从原理到落地5 分钟上手并附上 4 个真实踩坑案例。核心速览三句话讲完怎么用加前缀推荐docker.io/library/busybox→m.daocloud.io/docker.io/library/busybox换前缀docker.io/library/busybox→docker.m.daocloud.io/library/busybox放心用加速服务不篡改镜像所有 sha256 与源仓库完全一致破局思路为什么你的镜像总是卡在 Waiting先还原一个熟悉到麻木的场景你执行docker pull gcr.io/...进度条停在 0% 十几分钟最后超时甩给你一个报错。这不是你网速不行而是镜像仓库的物理位置在国外。国内网络访问海外 Registry数据要走漫长的跨国链路再叠加路由拥塞几十 MB 的小镜像也能拉到怀疑人生。问题的本质是取货点离你太远。与其自己搭代理、改网关、维护一堆不可控的通道不如在离你近的地方设一个中转站。public-image-mirror 就是这个中转站它按需同步海外各大 Registry 的镜像懒加载机制你只需要在原始地址前加一个国内前缀Docker 就会从国内节点拉取速度直接上一个数量级。最难得的是它的简单不需要改一行业务代码不需要理解复杂的 Registry 协议规则就是一条纯粹的名称映射。gcr.io 镜像拉取加速、quay 仓库加速、k8s 官方组件加速……全都能用同一套逻辑覆盖。落地三步走第一步先用一条命令验证加速通道不必急着改任何配置先跑一条命令感受效果docker run -d -P m.daocloud.io/docker.io/library/nginx预期效果几秒内完成拉取并启动容器首次拉取因懒加载会稍慢之后命中缓存就飞快。看到容器 ID 输出说明加速通道已经打通可以放心进入下一步。第二步完成 Docker 与 Kubernetes 镜像加速配置单条命令只治标。想让日常所有拉取都自动走加速通道建议按场景做长效配置。Docker 场景编辑/etc/docker/daemon.json加入{ registry-mirrors: [ https://docker.m.daocloud.io ] }然后systemctl restart docker重启生效。请注意registry-mirrors只对 docker.io 生效其他仓库要用加前缀的方式。Kubernetes 场景安装集群时直接指定国内源在 kubeadm 配置里加一行imageRepository: k8s.m.daocloud.ioPodman 场景在/etc/containers/registries.conf中为每个仓库单独配置 mirror例如 gcr.io 对应gcr.m.daocloud.io、quay.io 对应quay.m.daocloud.io支持度比 Docker 更完整。预期效果配置完成后你日常的docker pull、集群初始化、容器运行时拉取全部走加速路径不再需要手动改写任何镜像地址。第三步验证加速确实生效拉取完成后用一条命令确认镜像来源与完整性docker inspect docker.m.daocloud.io/library/busybox --format {{.RepoDigests}}预期效果输出的 digest 与官方源仓库的 sha256 完全一致说明加速服务只是搬运工、绝不动镜像内容可以放心用于生产环境。避坑清单四个踩过的坑坑一白天拉镜像依然慢现象加了前缀还是经常超时、进度条龟速。 原因公共加速服务在北京时间白天高峰段非常拥挤大家都在抢带宽。 解决办法把批量拉取任务放到凌晨 01-07 点执行优先用sha256:指定镜像其次用明确版本号的 tag最后才考虑latest——可变 tag 每次变更都会触发后台重新同步等于主动给缓存添堵。坑二上游更新了拉到的却是旧镜像现象项目刚发新版本加速地址拉下来还是老内容。 原因Manifest 有 1 小时内存缓存tag 变更后需要约 1 小时才会同步新数据。 解决办法耐心等一小时再拉关键场景直接用 sha256 digest 精确定位不受 tag 漂移影响。坑三某个镜像突然报 404现象以前能正常拉取某天突然报 manifest unknown 或 blob 404。 原因缓存内容只保留 30 天过期后需要重新同步且 blob 存在 1 分钟内存缓存窗口恰好撞上删除会被误判为不存在。 解决办法直接重试一次拉取触发懒加载重新同步即可恢复。坑四把 gcr.io 配进了 Docker 的 registry-mirrors现象daemon.json 配了一堆镜像源gcr 的镜像依旧拉不动。 原因Docker 的registry-mirrors机制只对 docker.io 生效配其他仓库地址是无效的。 解决办法非 docker.io 的仓库统一走加前缀方式例如m.daocloud.io/gcr.io/...省心且可靠。延伸与进阶基础配置顺手之后你可以把加速能力放大到整个团队甚至整个机房内网镜像缓存部署企业环境建议在机房部署一个本地缓存代理所有节点统一走内网拉取彻底摆脱公网波动和高峰拥挤。部署步骤见仓库内文档 docs/local-cache/README.md一条docker compose up -d即可启动之后只需在原始地址前加内网地址/前缀。Pod 镜像自动改写不想逐个改 yaml 和 Helm可以部署 repimage Webhook自动把所有新建 Pod 的镜像地址替换为加速地址对存量编排零侵入适合大规模集群。AI 模型加速项目还支持 Ollama 与 DeepSeek 模型的加速拉取和运行玩本地大模型同样受益。如果你发现某个镜像不在支持列表里白名单记录在仓库根目录allows.txt可以去提交 Issue 附上仓库路径维护者评估后就会添加——这也是参与项目贡献最直接的方式。现在就动手克隆仓库git clone https://gitcode.com/GitHub_Trending/pu/public-image-mirror先跑通第一条加速命令再按你的场景完成配置。遇到问题优先翻本文的避坑清单解决不了就去项目里提交 Issue把你的经验分享回来帮到下一个卡在 Waiting 的人。【免费下载链接】public-image-mirror很多镜像都在国外。比如 gcr 。国内下载很慢需要加速。致力于提供连接全世界的稳定可靠安全的容器镜像服务。项目地址: https://gitcode.com/GitHub_Trending/pu/public-image-mirror创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
