Kubernetes镜像源查询

这里查的是预设仓库地址

页面列出预设的 Kubernetes 镜像仓库候选地址。关键词栏按镜像站名称或 URL 筛选，结果中可复制仓库地址以及配套的 kubeadm 拉取命令。它适合快速查看候选仓库入口，不会接收单个镜像全名后解析标签，也不查询某个镜像版本是否已经同步。

imageRepository 与镜像版本

kubeadm 的 image-repository 选项用于指定拉取控制平面镜像所用的仓库，工具生成的命令是 kubeadm config images pull --image-repository <仓库地址>。具体镜像名称和版本还受 kubeadm 版本或配置影响；自定义仓库的子路径也可能与默认仓库不同。Kubernetes 官方文档说明了该参数及镜像拉取命令，并提示自定义仓库路径可能存在差异。

需要某个指定 Kubernetes 版本时，应先依据目标版本生成该版本的镜像清单，再确认候选仓库是否提供清单中的镜像。仓库地址本身只是路径前缀，不包含全部镜像名称与标签；同一个地址能访问，也不代表其中每个版本都存在。

这个仓库参数针对 kubeadm 管理的集群镜像准备。它不会替代应用部署清单中的镜像地址设置，也不会自动改写工作负载所使用的所有容器仓库。

筛选并试用一个候选地址

1. 在关键词栏输入镜像站名称中的词，或输入 URL 片段；清空关键词可重新查看全部候选项。

2. 在结果中核对地址，并复制页面给出的仓库地址或 kubeadm 拉取命令。若只需要配置值，可单独复制地址。

3. 在与目标集群相同的运行环境中先执行拉取验证，并核对目标 Kubernetes 版本所需的镜像清单。确认仓库结构和网络访问符合预期后，再写入正式安装配置。

如需核对目标版本的镜像集合，可在本机使用 kubeadm config images list --kubernetes-version <目标版本> --image-repository <仓库地址> 查看清单，再使用对应的 images pull 命令试拉取。版本号应与计划部署的集群版本一致。

如果命令失败，先把“候选仓库无法连接”和“仓库中缺少目标镜像”分别排查：检查网络与证书，再比对 images list 返回的完整仓库路径和标签。不要只根据列表里出现一个地址就推断某个组件镜像已经准备好。

地址列表不等于镜像可用性检查

候选地址会随镜像维护方策略变化；地址出现在列表中，不代表当前网络可达、目标版本已同步或镜像内容与上游一致。使用前应确认仓库来源可信、HTTPS 证书正常，并在目标环境执行 kubeadm 的镜像清单与拉取验证。工具不会验证仓库状态、镜像摘要、版本标签或下载速度，也不提供 Kubernetes 版本选择；生产环境应使用组织认可且已验证的仓库配置。

修改 kubeadm 使用的仓库不会自动代理其它来源的工作负载镜像。集群仍可能需要拉取应用、网络插件或组织自有镜像；这些内容要按实际部署清单另行配置和验证。