镜像拉取慢如龟速？告别等待！public-image-mirror加速Jenkins Agent NodeJS镜像同步实战指南

【免费下载链接】public-image-mirror 很多镜像都在国外。比如 gcr 。国内下载很慢，需要加速。 项目地址: https://gitcode.com/GitHub_Trending/pu/public-image-mirror

在国内使用国外镜像仓库（如gcr.io）时，开发者常常面临下载速度慢、拉取失败等问题，严重影响开发效率。public-image-mirror项目提供了一种简洁高效的镜像加速方案，通过镜像同步和前缀替换技术，帮助用户快速获取所需的国外镜像资源，特别适用于Jenkins Agent NodeJS等开发环境的镜像拉取场景。

🌟 核心功能：解决镜像拉取难题

public-image-mirror的核心价值在于提供稳定可靠的镜像加速服务，主要特点包括：

• 简洁名称映射：通过简单的前缀添加或替换，即可将国外镜像地址转换为加速地址
• 实时同步更新：每天检查同步情况，确保镜像资源的及时性
• 懒加载机制：所有镜像的sha256哈希值与源保持一致，保证安全性
• 多场景支持：适用于Docker、Kubernetes、Containerd等多种环境

🚀 快速上手：3步实现Jenkins Agent镜像加速

1️⃣ 克隆项目仓库

git clone https://gitcode.com/GitHub_Trending/pu/public-image-mirror

2️⃣ 应用前缀替换规则

以Jenkins Agent NodeJS镜像为例，原始镜像地址为：

gcr.io/jenkins-x/jx-boot:latest

使用public-image-mirror提供的前缀替换后，地址变为：

gcr.m.daocloud.io/jenkins-x/jx-boot:latest

3️⃣ 验证加速效果

修改Jenkins配置文件，使用加速后的镜像地址，重新启动Agent后，镜像拉取速度将显著提升。根据项目实测，原本需要30分钟以上的拉取过程可缩短至2-3分钟。

🛠️ 高级配置：不同环境下的最佳实践

Docker环境配置

编辑Docker配置文件/etc/docker/daemon.json，添加镜像加速器：

{
  "registry-mirrors": [
    "https://docker.m.daocloud.io"
  ]
}

重启Docker服务使配置生效：

sudo systemctl daemon-reload
sudo systemctl restart docker

Kubernetes环境配置

在Kubernetes集群中，可以通过修改kubeadm配置文件加速镜像拉取：

apiVersion: kubeadm.k8s.io/v1beta3
kind: ClusterConfiguration
dns:
  imageRepository: k8s.m.daocloud.io/coredns
imageRepository: k8s.m.daocloud.io

对于已运行的集群，可使用repimage工具自动替换所有Pod的镜像地址：

kubectl create -f https://files.m.daocloud.io/github.com/wzshiming/repimage/releases/download/latest/repimage.yaml
kubectl rollout status deployment/repimage -n kube-system

本地缓存部署

对于内网环境，可部署本地缓存服务进一步提升访问速度，详细文档请参考docs/local-cache目录下的说明。

📊 支持的镜像仓库

public-image-mirror支持多种主流镜像仓库的加速，包括但不限于：

源站	加速地址	备注
gcr.io	gcr.m.daocloud.io	国外镜像加速
docker.io	docker.m.daocloud.io	Docker官方仓库
k8s.gcr.io	k8s-gcr.m.daocloud.io	Kubernetes镜像
registry.k8s.io	k8s.m.daocloud.io	新版Kubernetes仓库
mcr.microsoft.com	mcr.m.daocloud.io	Microsoft容器仓库

💡 使用小贴士

1. 选择合适的拉取时间：建议将拉取任务安排在闲时（北京时间01-07点），避开网络高峰期
2. 使用明确版本号：避免使用latest标签，选择具体版本号可提高拉取成功率
3. 监控同步状态：通过同步队列和服务状态监控了解服务运行情况
4. 定期更新缓存：镜像缓存有效期为90天，过期后需重新同步

通过public-image-mirror项目，开发者可以轻松解决国外镜像拉取慢的问题，显著提升Jenkins Agent NodeJS等开发环境的部署效率。无论是个人开发者还是企业团队，都能从中获得稳定、高效的镜像加速体验。

【免费下载链接】public-image-mirror 很多镜像都在国外。比如 gcr 。国内下载很慢，需要加速。 项目地址: https://gitcode.com/GitHub_Trending/pu/public-image-mirror