终极容器镜像加速指南5分钟解决国外镜像拉取超时难题【免费下载链接】public-image-mirror很多镜像都在国外。比如 gcr 。国内下载很慢需要加速。致力于提供连接全世界的稳定可靠安全的容器镜像服务。项目地址: https://gitcode.com/GitHub_Trending/pu/public-image-mirror还在为拉取Docker镜像时无尽的等待和频繁的超时错误而烦恼吗作为国内开发者你一定经历过这样的场景部署一个AI应用需要拉取ghcr.io的机器学习镜像结果等待30分钟却只换来一个ImagePullBackOff错误。今天我要为你介绍一个简单高效的解决方案——DaoCloud公开镜像仓库让你的镜像拉取速度提升10倍项目简介打破网络壁垒的镜像加速神器public-image-mirror是DaoCloud推出的开源项目专门为国内开发者解决国外容器镜像拉取难题。它通过智能缓存和同步机制将国外主流镜像仓库如gcr.io、ghcr.io、quay.io等的内容实时同步到国内节点让你享受本地般的拉取体验。 核心优势一览痛点场景传统方式使用public-image-mirror提升效果拉取ghcr.io镜像30分钟失败率40%1-3分钟成功率99.9%速度提升10倍部署K8s集群镜像拉取超时集群部署失败流畅拉取快速部署部署时间减少70%开发环境搭建频繁重试影响开发效率一次成功专注开发开发效率提升50%生产环境更新更新时间窗口长风险高快速更新降低风险维护窗口缩短80% 三种加速方案总有一种适合你方案一前缀替换法最简单推荐这是最直接的加速方式只需在原有镜像地址前添加m.daocloud.io/前缀即可# 原地址慢如蜗牛 docker pull ghcr.io/immich-app/ml-worker:latest # 加速地址飞一般的感觉 docker pull m.daocloud.io/ghcr.io/immich-app/ml-worker:latest适用场景所有在 allows.txt 白名单中的镜像都支持这种方式。目前项目已经支持超过1200个常用镜像仓库方案二域名替换法兼容性好如果你习惯使用完整的镜像仓库地址可以使用项目提供的域名替换方案# 原地址 docker pull ghcr.io/immich-app/immich-server:release # 加速地址 docker pull ghcr.m.daocloud.io/immich-app/immich-server:release支持的仓库替换规则源站替换为主要用途docker.iodocker.m.daocloud.ioDocker官方镜像gcr.iogcr.m.daocloud.ioGoogle容器镜像ghcr.ioghcr.m.daocloud.ioGitHub容器镜像quay.ioquay.m.daocloud.ioRedHat容器镜像registry.k8s.iok8s.m.daocloud.ioKubernetes官方镜像方案三自动化同步法高级定制对于不在白名单中的镜像你可以主动触发同步项目提供了完整的自动化工具链# 1. 克隆项目仓库 git clone https://gitcode.com/GitHub_Trending/pu/public-image-mirror cd public-image-mirror # 2. 创建你的镜像需求文件 echo ghcr.io/your-org/* my-allows.txt echo ghcr.io/your-org/app:v1.0.0 my-used.txt # 3. 执行同步脚本 ./hack/merge-mirror.sh my-allows.txt my-used.txt脚本会自动分析你的使用频率优先同步最常用的镜像并确保与源镜像的完全一致性。 实战应用从零开始加速你的项目场景一加速Docker日常使用如果你是Docker用户最简单的配置方式是在/etc/docker/daemon.json中添加镜像加速器{ registry-mirrors: [ https://docker.m.daocloud.io ] }配置完成后重启Docker服务sudo systemctl restart docker现在所有docker.io的镜像都会自动通过国内加速节点拉取场景二加速Kubernetes集群部署对于Kubernetes用户项目提供了多种加速方案1. 加速kubeadm安装apiVersion: kubeadm.k8s.io/v1beta3 kind: ClusterConfiguration imageRepository: k8s.m.daocloud.io2. 加速kind集群创建kind create cluster --name my-cluster --image m.daocloud.io/docker.io/kindest/node:v1.28.03. 自动加速所有Pod使用Webhookkubectl create -f https://files.m.daocloud.io/github.com/wzshiming/repimage/releases/download/latest/repimage.yaml场景三加速AI模型部署Ollama DeepSeekAI应用对镜像拉取速度要求极高public-image-mirror专门优化了相关镜像加速Ollama部署# CPU版本 docker run -d -v ollama:/root/.ollama -p 11434:11434 \ --name ollama docker.m.daocloud.io/ollama/ollama # GPU版本需要NVIDIA Container Toolkit docker run -d --gpusall -v ollama:/root/.ollama -p 11434:11434 \ --name ollama docker.m.daocloud.io/ollama/ollama加速DeepSeek模型# 使用加速源启动DeepSeek-R1模型 docker exec -it ollama ollama run ollama.m.daocloud.io/library/deepseek-r1:1.5b️ 工具宝库项目内置的强大脚本public-image-mirror项目提供了丰富的工具脚本位于 hack/ 目录下镜像验证工具verify-image.sh- 验证镜像是否可访问diff-image.sh- 对比本地与远程镜像差异verify-allows.sh- 检查镜像是否在白名单中同步管理工具merge-mirror.sh- 主同步脚本智能合并镜像需求stats-not-sync.sh- 统计未同步的镜像fmt-image.sh- 格式化镜像名称实用辅助工具helper.sh- 常用辅助函数badge.sh- 生成状态徽章correct-image.sh- 校正镜像格式 同步状态监控与验证实时监控同步队列项目提供了透明的同步状态监控页面# 查看所有同步任务状态 curl https://queue.m.daocloud.io/status/ # 查看特定项目的同步状态 curl https://queue.m.daocloud.io/status/immich-app镜像一致性验证使用内置工具确保缓存镜像与源镜像完全一致# 检查镜像差异 ./hack/diff-image.sh ghcr.io/immich-app/ml-worker:latest # 无输出表示完全一致可以放心使用 最佳实践与优化建议1. 版本锁定策略避免使用latest标签选择具体版本号以确保稳定性# 不推荐 docker pull m.daocloud.io/ghcr.io/immich-app/ml-worker:latest # 推荐 docker pull m.daocloud.io/ghcr.io/immich-app/ml-worker:v1.91.02. 闲时同步策略根据项目 README.md 的建议将批量同步任务安排在凌晨北京时间01-07点执行# 添加到crontab 0 3 * * * cd /path/to/public-image-mirror ./hack/merge-mirror.sh sync.log 213. 内网缓存部署对于企业环境建议部署本地缓存服务进一步减少对外网的依赖参考 docs/local-cache/ 文档支持多级缓存架构提供审计和监控功能 常见问题排查指南问题1镜像拉取失败症状Error response from daemon: pull access denied解决步骤检查镜像是否在白名单中grep ghcr.io/immich-app allows.txt验证源镜像可访问性./hack/verify-image.sh ghcr.io/immich-app/ml-worker:latest查看同步队列状态curl https://queue.m.daocloud.io/status/immich-app问题2同步延迟症状镜像已添加但无法拉取原因与解决新镜像首次同步需要时间通常1小时内使用latest标签的镜像更新有1小时缓存建议使用具体版本号避免延迟问题3镜像哈希不匹配症状manifest unknown或digest mismatch解决使用diff-image.sh工具验证一致性检查源镜像是否被删除或更新等待缓存过期后重新同步 高级技巧与扩展应用1. 批量加速CI/CD流水线在GitLab CI或GitHub Actions中配置加速# .gitlab-ci.yml 示例 variables: DOCKER_REGISTRY_MIRROR: https://docker.m.daocloud.io # 或者使用前缀方式 build: script: - docker build -t m.daocloud.io/docker.io/myapp:latest .2. 多架构镜像支持项目完整支持多架构镜像amd64、arm64、ppc64le等# 拉取多架构镜像会自动选择适合的版本 docker pull --platform linux/arm64 m.daocloud.io/docker.io/library/nginx3. 与企业Registry集成可以将public-image-mirror作为上游代理构建企业级镜像仓库客户端 → 企业Registry → public-image-mirror → 国外源站 总结为什么选择public-image-mirror经过详细的介绍和实战演示相信你已经充分了解了public-image-mirror的强大功能。让我为你总结一下核心价值✨ 核心优势极简使用只需添加前缀或修改配置无需复杂部署完全透明所有镜像哈希与源站保持一致安全可靠广泛覆盖支持1200常用镜像仓库满足绝大多数需求智能同步基于使用频率的智能缓存策略资源利用最大化开源免费完全开源社区驱动持续更新维护 立即开始加速无论你是个人开发者、团队负责人还是企业架构师public-image-mirror都能为你带来显著的效率提升个人用户直接在Docker命令前添加m.daocloud.io/前缀团队协作在CI/CD配置中统一配置加速地址企业部署结合内网缓存构建完整的镜像加速体系 未来展望项目团队正在持续优化增加更多镜像仓库支持优化同步算法减少延迟提供更丰富的监控和告警功能开发GUI管理界面 加入社区public-image-mirror是一个完全开源的项目欢迎你的参与提交Issue报告问题或建议贡献代码改进功能分享使用经验和最佳实践帮助完善文档和教程不要再让网络限制阻碍你的开发效率立即尝试public-image-mirror体验飞一般的镜像拉取速度让你的容器化部署从此畅通无阻记住这个简单的规则遇到国外镜像拉取慢就在前面加上m.daocloud.io/问题迎刃而解【免费下载链接】public-image-mirror很多镜像都在国外。比如 gcr 。国内下载很慢需要加速。致力于提供连接全世界的稳定可靠安全的容器镜像服务。项目地址: https://gitcode.com/GitHub_Trending/pu/public-image-mirror创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
终极容器镜像加速指南：5分钟解决国外镜像拉取超时难题
终极容器镜像加速指南5分钟解决国外镜像拉取超时难题【免费下载链接】public-image-mirror很多镜像都在国外。比如 gcr 。国内下载很慢需要加速。致力于提供连接全世界的稳定可靠安全的容器镜像服务。项目地址: https://gitcode.com/GitHub_Trending/pu/public-image-mirror还在为拉取Docker镜像时无尽的等待和频繁的超时错误而烦恼吗作为国内开发者你一定经历过这样的场景部署一个AI应用需要拉取ghcr.io的机器学习镜像结果等待30分钟却只换来一个ImagePullBackOff错误。今天我要为你介绍一个简单高效的解决方案——DaoCloud公开镜像仓库让你的镜像拉取速度提升10倍项目简介打破网络壁垒的镜像加速神器public-image-mirror是DaoCloud推出的开源项目专门为国内开发者解决国外容器镜像拉取难题。它通过智能缓存和同步机制将国外主流镜像仓库如gcr.io、ghcr.io、quay.io等的内容实时同步到国内节点让你享受本地般的拉取体验。 核心优势一览痛点场景传统方式使用public-image-mirror提升效果拉取ghcr.io镜像30分钟失败率40%1-3分钟成功率99.9%速度提升10倍部署K8s集群镜像拉取超时集群部署失败流畅拉取快速部署部署时间减少70%开发环境搭建频繁重试影响开发效率一次成功专注开发开发效率提升50%生产环境更新更新时间窗口长风险高快速更新降低风险维护窗口缩短80% 三种加速方案总有一种适合你方案一前缀替换法最简单推荐这是最直接的加速方式只需在原有镜像地址前添加m.daocloud.io/前缀即可# 原地址慢如蜗牛 docker pull ghcr.io/immich-app/ml-worker:latest # 加速地址飞一般的感觉 docker pull m.daocloud.io/ghcr.io/immich-app/ml-worker:latest适用场景所有在 allows.txt 白名单中的镜像都支持这种方式。目前项目已经支持超过1200个常用镜像仓库方案二域名替换法兼容性好如果你习惯使用完整的镜像仓库地址可以使用项目提供的域名替换方案# 原地址 docker pull ghcr.io/immich-app/immich-server:release # 加速地址 docker pull ghcr.m.daocloud.io/immich-app/immich-server:release支持的仓库替换规则源站替换为主要用途docker.iodocker.m.daocloud.ioDocker官方镜像gcr.iogcr.m.daocloud.ioGoogle容器镜像ghcr.ioghcr.m.daocloud.ioGitHub容器镜像quay.ioquay.m.daocloud.ioRedHat容器镜像registry.k8s.iok8s.m.daocloud.ioKubernetes官方镜像方案三自动化同步法高级定制对于不在白名单中的镜像你可以主动触发同步项目提供了完整的自动化工具链# 1. 克隆项目仓库 git clone https://gitcode.com/GitHub_Trending/pu/public-image-mirror cd public-image-mirror # 2. 创建你的镜像需求文件 echo ghcr.io/your-org/* my-allows.txt echo ghcr.io/your-org/app:v1.0.0 my-used.txt # 3. 执行同步脚本 ./hack/merge-mirror.sh my-allows.txt my-used.txt脚本会自动分析你的使用频率优先同步最常用的镜像并确保与源镜像的完全一致性。 实战应用从零开始加速你的项目场景一加速Docker日常使用如果你是Docker用户最简单的配置方式是在/etc/docker/daemon.json中添加镜像加速器{ registry-mirrors: [ https://docker.m.daocloud.io ] }配置完成后重启Docker服务sudo systemctl restart docker现在所有docker.io的镜像都会自动通过国内加速节点拉取场景二加速Kubernetes集群部署对于Kubernetes用户项目提供了多种加速方案1. 加速kubeadm安装apiVersion: kubeadm.k8s.io/v1beta3 kind: ClusterConfiguration imageRepository: k8s.m.daocloud.io2. 加速kind集群创建kind create cluster --name my-cluster --image m.daocloud.io/docker.io/kindest/node:v1.28.03. 自动加速所有Pod使用Webhookkubectl create -f https://files.m.daocloud.io/github.com/wzshiming/repimage/releases/download/latest/repimage.yaml场景三加速AI模型部署Ollama DeepSeekAI应用对镜像拉取速度要求极高public-image-mirror专门优化了相关镜像加速Ollama部署# CPU版本 docker run -d -v ollama:/root/.ollama -p 11434:11434 \ --name ollama docker.m.daocloud.io/ollama/ollama # GPU版本需要NVIDIA Container Toolkit docker run -d --gpusall -v ollama:/root/.ollama -p 11434:11434 \ --name ollama docker.m.daocloud.io/ollama/ollama加速DeepSeek模型# 使用加速源启动DeepSeek-R1模型 docker exec -it ollama ollama run ollama.m.daocloud.io/library/deepseek-r1:1.5b️ 工具宝库项目内置的强大脚本public-image-mirror项目提供了丰富的工具脚本位于 hack/ 目录下镜像验证工具verify-image.sh- 验证镜像是否可访问diff-image.sh- 对比本地与远程镜像差异verify-allows.sh- 检查镜像是否在白名单中同步管理工具merge-mirror.sh- 主同步脚本智能合并镜像需求stats-not-sync.sh- 统计未同步的镜像fmt-image.sh- 格式化镜像名称实用辅助工具helper.sh- 常用辅助函数badge.sh- 生成状态徽章correct-image.sh- 校正镜像格式 同步状态监控与验证实时监控同步队列项目提供了透明的同步状态监控页面# 查看所有同步任务状态 curl https://queue.m.daocloud.io/status/ # 查看特定项目的同步状态 curl https://queue.m.daocloud.io/status/immich-app镜像一致性验证使用内置工具确保缓存镜像与源镜像完全一致# 检查镜像差异 ./hack/diff-image.sh ghcr.io/immich-app/ml-worker:latest # 无输出表示完全一致可以放心使用 最佳实践与优化建议1. 版本锁定策略避免使用latest标签选择具体版本号以确保稳定性# 不推荐 docker pull m.daocloud.io/ghcr.io/immich-app/ml-worker:latest # 推荐 docker pull m.daocloud.io/ghcr.io/immich-app/ml-worker:v1.91.02. 闲时同步策略根据项目 README.md 的建议将批量同步任务安排在凌晨北京时间01-07点执行# 添加到crontab 0 3 * * * cd /path/to/public-image-mirror ./hack/merge-mirror.sh sync.log 213. 内网缓存部署对于企业环境建议部署本地缓存服务进一步减少对外网的依赖参考 docs/local-cache/ 文档支持多级缓存架构提供审计和监控功能 常见问题排查指南问题1镜像拉取失败症状Error response from daemon: pull access denied解决步骤检查镜像是否在白名单中grep ghcr.io/immich-app allows.txt验证源镜像可访问性./hack/verify-image.sh ghcr.io/immich-app/ml-worker:latest查看同步队列状态curl https://queue.m.daocloud.io/status/immich-app问题2同步延迟症状镜像已添加但无法拉取原因与解决新镜像首次同步需要时间通常1小时内使用latest标签的镜像更新有1小时缓存建议使用具体版本号避免延迟问题3镜像哈希不匹配症状manifest unknown或digest mismatch解决使用diff-image.sh工具验证一致性检查源镜像是否被删除或更新等待缓存过期后重新同步 高级技巧与扩展应用1. 批量加速CI/CD流水线在GitLab CI或GitHub Actions中配置加速# .gitlab-ci.yml 示例 variables: DOCKER_REGISTRY_MIRROR: https://docker.m.daocloud.io # 或者使用前缀方式 build: script: - docker build -t m.daocloud.io/docker.io/myapp:latest .2. 多架构镜像支持项目完整支持多架构镜像amd64、arm64、ppc64le等# 拉取多架构镜像会自动选择适合的版本 docker pull --platform linux/arm64 m.daocloud.io/docker.io/library/nginx3. 与企业Registry集成可以将public-image-mirror作为上游代理构建企业级镜像仓库客户端 → 企业Registry → public-image-mirror → 国外源站 总结为什么选择public-image-mirror经过详细的介绍和实战演示相信你已经充分了解了public-image-mirror的强大功能。让我为你总结一下核心价值✨ 核心优势极简使用只需添加前缀或修改配置无需复杂部署完全透明所有镜像哈希与源站保持一致安全可靠广泛覆盖支持1200常用镜像仓库满足绝大多数需求智能同步基于使用频率的智能缓存策略资源利用最大化开源免费完全开源社区驱动持续更新维护 立即开始加速无论你是个人开发者、团队负责人还是企业架构师public-image-mirror都能为你带来显著的效率提升个人用户直接在Docker命令前添加m.daocloud.io/前缀团队协作在CI/CD配置中统一配置加速地址企业部署结合内网缓存构建完整的镜像加速体系 未来展望项目团队正在持续优化增加更多镜像仓库支持优化同步算法减少延迟提供更丰富的监控和告警功能开发GUI管理界面 加入社区public-image-mirror是一个完全开源的项目欢迎你的参与提交Issue报告问题或建议贡献代码改进功能分享使用经验和最佳实践帮助完善文档和教程不要再让网络限制阻碍你的开发效率立即尝试public-image-mirror体验飞一般的镜像拉取速度让你的容器化部署从此畅通无阻记住这个简单的规则遇到国外镜像拉取慢就在前面加上m.daocloud.io/问题迎刃而解【免费下载链接】public-image-mirror很多镜像都在国外。比如 gcr 。国内下载很慢需要加速。致力于提供连接全世界的稳定可靠安全的容器镜像服务。项目地址: https://gitcode.com/GitHub_Trending/pu/public-image-mirror创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
