使用 K3s 部署 Geti 项目时网络代理异常的排查与解决方案

使用 K3s 部署 Geti 项目时网络代理异常的排查与解决方案

一、问题概述与背景分析

1.1 问题现象描述

在企业内网环境中，使用 K3s 部署 Intel Geti 项目时，经常遇到以下类型的异常：

• 镜像拉取失败：K3s 无法从 Docker Hub、registry.k3s.io 或 GCR（Google Container Registry）等外部容器镜像仓库拉取 Geti 所需的镜像
• Pod 启动超时：Pod 处于ContainerCreating或ImagePullBackOff状态
• 网络连接失败：Geti 平台的组件无法通过代理服务器访问外部 API 服务
• 安装脚本执行失败：K3s 安装过程中因无法访问https://get.k3s.io而失败
• Cert-manager 或 Ingress 相关问题：证书获取或路由配置受代理影响

这些问题通常源于 K3s 集群部署在企业内网中，需要经过 HTTP/HTTPS 代理服务器才能访问外部网络资源。值得注意的是，K3s 默认情况下并不会将主机上的代理环境变量传递给容器运行时和 Pod[reference:0]。在部署 Geti 项目时，由于该项