Minikube无法拉取镜像求助：连接registry.k8s.io失败及ErrImgpull报错

问题概述 #

• 启动Minikube时提示unable to connect to registry.k8s.io
• 部署postgres、vault或自定义镜像时出现ErrImgpull错误
• Minikube内部执行apt-get update时证书验证失败，无法获取HTTPS资源

环境信息 #

• 网络：企业LAN
• 系统：Windows 11 Enterprise
• Minikube版本：v1.34.0（commit: 210b148df93a80eb872ecbeb7e35281b3c582c61）
• Docker Engine：v27.2.0
• Docker Desktop：4.34.2 (167172)

已尝试操作 #

• 执行docker prune、minikube delete、minikube start重置环境
• 将Minikube IP添加至no_proxy/NO_PROXY环境变量

关键调试信息 #

• 主机浏览器可正常访问registry.k8s.io
• SSH进入Minikube后，ping 8.8.8.8网络连通正常
• Minikube内部执行docker login无法连接镜像仓库
• Minikube内apt-get update报错证书验证失败：

  Failed to fetch https://download.docker.com/linux/ubuntu/dists/jammy/InRelease 证书验证失败：证书不受信任，颁发者未知，OCSP状态响应无效，无法握手：证书验证错误。[IP: 18.244.61.11 443]
  W: Failed to fetch https://nvidia.github.io/libnvidia-container/stable/deb/amd64/InRelease 证书验证失败：证书不受信任，颁发者未知，OCSP状态响应无效，无法握手：证书验证错误。[IP: 185.199.111.153 443]
  W: 部分索引文件下载失败，已忽略或使用旧文件替代。

解决方案 #

1. 注入企业代理与根证书 #

企业LAN通常通过代理拦截HTTPS流量并替换证书，Minikube内部未导入企业根证书是核心问题。

• 导出企业根证书
  从Windows系统导出企业CA根证书（保存为PEM格式，例如company-root.crt）。

• 带代理与证书启动Minikube
  替换<PROXY_URL>为企业代理地址（如http://proxy.company.com:8080），<CERT_PATH>为本地证书路径，执行命令：

  minikube start --docker-env HTTP_PROXY=<PROXY_URL> --docker-env HTTPS_PROXY=<PROXY_URL> --docker-env NO_PROXY=localhost,127.0.0.1,minikube.internal,<MINIKUBE_IP> --mount --mount-string="<CERT_PATH>:/usr/local/share/ca-certificates/company-root.crt"
  

• 更新Minikube证书信任
  SSH进入Minikube后执行：

  sudo update-ca-certificates
  

2. 验证镜像拉取 #

在Minikube内部执行以下命令，确认镜像拉取正常：

docker pull registry.k8s.io/pause:3.9

3. 配置Kubernetes组件代理（可选） #

若Kubernetes组件仍无法访问外部仓库，创建proxy-config.yaml文件：

apiVersion: v1
kind: ConfigMap
metadata:
  name: kube-proxy-config
  namespace: kube-system
data:
  config.conf: |
    apiVersion: kubeproxy.config.k8s.io/v1alpha1
    kind: KubeProxyConfiguration
    mode: "ipvs"
    env:
      - name: HTTP_PROXY
        value: "<PROXY_URL>"
      - name: HTTPS_PROXY
        value: "<PROXY_URL>"
      - name: NO_PROXY
        value: "localhost,127.0.0.1,minikube.internal,<MINIKUBE_IP>"

应用配置并重启kube-proxy：

kubectl apply -f proxy-config.yaml
kubectl rollout restart deployment kube-proxy -n kube-system

4. 备选方案：本地镜像导入 #

若代理配置复杂，可提前在主机拉取镜像后导入Minikube：

• 主机拉取镜像：

  docker pull postgres:15
  docker pull hashicorp/vault:latest
  

• 导入到Minikube：

  minikube image load postgres:15
  minikube image load hashicorp/vault:latest
  

内容的提问来源于stack exchange，提问作者user2503849