docker image下载不成功的解决方案问题根源cr.kagent.dev是海外私有镜像仓库国内网络直连超时/拉取失败Kagent Chart 全局配置registry: cr.kagent.dev所有组件镜像都走这个地址。提供4套可落地方案按简单到生产排序。方案1安装时直接覆盖镜像仓库最快无需改valuesKagent 全局有global.registry参数一键替换镜像域名两种用法1.1 命令行 --set 覆盖临时# 先装crdshelminstallkagent-crds oci://ghcr.io/kagent-dev/kagent/helm/kagent-crds-naiops --create-namespace\--setglobal.registrydockerproxy.com/cr.kagent.dev# 再装主程序带上你的valueshelminstallkagent oci://ghcr.io/kagent-dev/kagent/helm/kagent-naiops-fkagent-values.yaml\--setglobal.registrydockerproxy.com/cr.kagent.dev代理规则cr.kagent.dev/xxx→dockerproxy.com/cr.kagent.dev/xxx公开免费镜像代理。1.2 修改你的 kagent-values.yaml永久推荐在 values 文件顶部加入全局镜像替换所有组件自动生效global:registry:dockerproxy.com/cr.kagent.devtag:0.9.10然后正常执行安装helminstallkagent oci://ghcr.io/kagent-dev/kagent/helm/kagent-naiops-fkagent-values.yaml方案2集群节点配置Docker全局镜像加速器不修改helm所有节点统一加国内镜像源节点自动代理海外仓库无需改chart配置。编辑/etc/docker/daemon.json{registry-mirrors:[https://docker.mirrors.ustc.edu.cn,https://dockerproxy.com,https://docker.m.daocloud.io]}重启dockersystemctl daemon-reload systemctl restartdocker缺点仅能加速docker.io/gcr.io对cr.kagent.dev私有域名加速有限优先用方案1。方案3本地预拉镜像私有仓库 Harbor生产稳定适合长期离线/严格内网集群本地能联网机器拉取代理镜像dockerpull dockerproxy.com/cr.kagent.dev/kagent-dev/kagent/controller:0.9.10# 重命名为私有仓库地址dockertag dockerproxy.com/cr.kagent.dev/kagent-dev/kagent/controller:0.9.10 harbor.xxx.com/kagent-dev/kagent/controller:0.9.10# 推送到内网harbordockerpush harbor.xxx.com/kagent-dev/kagent/controller:0.9.10helm安装指定内网仓库helminstallkagent...--setglobal.registryharbor.xxx.com方案4DaoCloud 镜像代理备选dockerproxy失效时用替换registry值为global:registry:m.daocloud.io/cr.kagent.dev命令行示例helminstallkagent...--setglobal.registrym.daocloud.io/cr.kagent.dev关键补充CRDS 也要同步替换 registrykagent-crds chart 同样有global.registry必须同步加参数否则crds控制器镜像依然拉失败helminstallkagent-crds oci://ghcr.io/kagent-dev/kagent/helm/kagent-crds-naiops\--setglobal.registrydockerproxy.com/cr.kagent.dev校验镜像是否替换成功部署完成后查看pod镜像地址kubectl get pod-naiops-ojsonpath{.items[0].spec.containers[0].image}输出应不再是cr.kagent.dev/xxx而是dockerproxy.com/cr.kagent.dev/xxx。常见报错兜底代理镜像拉取404换m.daocloud.io/cr.kagent.dev集群私有仓库需要认证在values添加global.imagePullSecretsglobal:imagePullSecrets:-harbor-secret