30秒搞定gcr.io/etcd镜像加速：DaoCloud同步方案全解析
项目地址: https://gitcode.com/GitHub_Trending/pu/public-image-mirror 镜像拉取痛点与解决方案
你是否还在为gcr.io/etcd镜像下载缓慢而困扰？在国内网络环境下，直接拉取国外仓库镜像往往需要等待数分钟甚至超时失败。DaoCloud开源项目public-image-mirror提供了一种高效解决方案，通过镜像同步机制将gcr.io等国外仓库资源缓存到国内节点，平均拉取时间从5分钟缩短至30秒以内。
项目核心原理
该项目通过以下流程实现镜像加速：
关键实现依赖两个核心文件：
- 允许同步列表：allows.txt中第868行明确配置
gcr.io/**，表示允许同步gcr.io下所有镜像 - 同步执行脚本：hack/merge-mirror.sh负责将源镜像同步到国内仓库
快速使用指南
基础替换法
直接在原镜像地址前添加m.daocloud.io/前缀：
# 原地址
docker pull gcr.io/etcd-development/etcd:v3.5.10
# 加速地址
docker pull m.daocloud.io/gcr.io/etcd-development/etcd:v3.5.10
前缀替换法
对于gcr.io仓库，可使用专用前缀gcr.m.daocloud.io替换：
# 等效加速地址
docker pull gcr.m.daocloud.io/etcd-development/etcd:v3.5.10
高级配置方案
Kubernetes环境配置
在Kubernetes集群中，通过修改容器运行时配置实现全局加速：
# /etc/containerd/config.toml 配置片段
[plugins."io.containerd.grpc.v1.cri".registry.mirrors]
[plugins."io.containerd.grpc.v1.cri".registry.mirrors."gcr.io"]
endpoint = ["https://gcr.m.daocloud.io"]
验证同步状态
使用项目提供的验证工具检查镜像是否已同步：
./hack/verify-allows.sh allows.txt gcr.io/etcd-development/etcd
返回0表示验证通过，该镜像已在同步白名单中。
常见问题解决
镜像标签不存在
若出现manifest unknown错误，可能是缓存延迟导致。可通过项目提供的同步队列状态页查询同步进度，通常等待不超过1小时即可完成缓存。
同步验证失败
当执行验证脚本返回非0值时，需检查：
- allows.txt是否包含目标镜像路径
- 镜像名称是否符合hack/verify-allows.sh中的匹配规则
- 可提交Issue至项目仓库申请添加新镜像
项目贡献与反馈
该项目采用MIT许可协议，欢迎通过以下方式参与贡献：
- 提交PR完善allows.txt同步列表
- 改进同步脚本hack/merge-mirror.sh
- 报告同步异常的镜像信息
同类加速资源
除镜像加速外，DaoCloud还提供：
- 二进制文件加速：public-binary-files-mirror
- Helm仓库加速：通过
helm repo add使用https://m.daocloud.io/chartrepo
提示：建议将拉取操作安排在闲时（北京时间01:00-07:00），此时同步服务器负载较低，成功率更高。
如果觉得本方案对你有帮助，请点赞收藏本项目，关注后续支持的镜像仓库更新！
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
