配置代理后Kubectl命令无法执行提示连接服务器超时该如何解决？

问题根因说明 #

你配置的全局HTTP/HTTPS代理会将所有网络请求转发到代理服务器，而Kubernetes apiserver通常使用集群内网地址，代理服务器无法访问该内网地址，最终触发连接超时错误：Unable to connect to the server: net/http: request canceled while waiting for connection (Client.Timeout exceeded while awaiting headers)。

排查修复步骤 #

第一步：确认基础配置 #

• 查看当前shell生效的代理配置：

  env | grep -i proxy
  

• 查看kubectl配置的apiserver地址：

  kubectl config view | grep server
  

  正常返回格式为https://[内网IP]:6443，确认该地址为集群内网网段。

第二步：临时验证修复（当前shell立即生效） #

执行如下命令将K8s相关内网地址加入代理排除列表，替换示例中的apiserver地址为你实际的地址：

export no_proxy=127.0.0.1,localhost,[你的apiserver实际IP/域名],10.0.0.0/8,172.16.0.0/12,192.168.0.0/16

配置完成后执行kubectl get nodes验证是否恢复正常。

说明：no_proxy中10.0.0.0/8为K8s默认Service网段、172.16.0.0/12为默认Pod网段、192.168.0.0/16为常用主机内网网段，可根据你集群的实际网段调整。

第三步：永久生效配置 #

1. 当前用户全局代理配置（kubectl优先读取当前shell的环境变量）

编辑用户bash配置文件~/.bashrc，在末尾添加完整代理配置：

export http_proxy=http://proxy.example.com:80
export https_proxy=http://proxy.example.com:80
export no_proxy=127.0.0.1,localhost,[你的apiserver实际IP/域名],10.0.0.0/8,172.16.0.0/12,192.168.0.0/16

执行source ~/.bashrc让配置永久生效。

2. Docker代理补充配置（如果集群节点上的Pod需要走外部代理）

编辑Docker代理配置文件/etc/systemd/system/docker.service.d/http-proxy.conf，补充NO_PROXY配置：

[Service]
Environment="HTTP_PROXY=http://proxy.example.com:80"
Environment="HTTPS_PROXY=http://proxy.example.com:80"
Environment="NO_PROXY=127.0.0.1,localhost,[你的apiserver实际IP/域名],10.0.0.0/8,172.16.0.0/12,192.168.0.0/16"

重载并重启Docker生效：

sudo systemctl daemon-reload
sudo systemctl restart docker

额外异常排查 #

• 若配置后仍异常，验证apiserver端口连通性：telnet [你的apiserverIP] 6443，如果不通检查主机防火墙、安全组是否放通6443端口
• 检查kubeconfig配置文件~/.kube/config是否被误修改，确认server地址、证书认证配置正确

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