openSUSE Vagrant环境部署K3s后helm add repo连接超时问题求助

1. 修复kubeconfig权限告警与集群偶发不可达问题 #

你安装K3s时指定的K3S_KUBECONFIG_MODE="644"会生成权限为644的kubeconfig文件，组和其他用户可读的权限会触发helm的安全告警；另外helm偶发访问8080端口报错，是因为KUBECONFIG环境变量仅在当前终端生效，切换终端或重启后失效，helm读取不到配置时默认访问非K3s默认的8080端口导致报错。
按以下步骤修复：

• 修改~/.kube/config的文件权限为600：

chmod 600 ~/.kube/config

• 如果你后续需要从K3s默认路径拷贝kubeconfig，可同步修改默认路径的文件权限：

chmod 600 /etc/rancher/k3s/k3s.yaml

• 把KUBECONFIG环境变量持久化到shell配置文件，避免重启或换终端失效：
  若使用bash：

  echo 'export KUBECONFIG=~/.kube/config' >> ~/.bashrc && source ~/.bashrc
  

  若使用zsh：

  echo 'export KUBECONFIG=~/.kube/config' >> ~/.zshrc && source ~/.zshrc
  

• 验证集群连接：执行helm list，不会再报集群不可达错误，无已安装release时正常返回空列表即为正常。

2. 修复helm添加仓库超时问题 #

超时是因为Vagrant虚拟机无法正常访问目标helm仓库地址，按以下顺序排查修复：

• 先验证虚拟机本身的网络连通性：

curl -I https://prometheus-community.github.io/helm-charts/index.yaml

如果返回超时，先排查基础网络配置：

• 检查Vagrantfile是否配置了正确的NAT网络或桥接网络，确保虚拟机可以访问公网
• 检查openSUSE的防火墙设置，确认没有限制443端口出站访问：

# 检查https端口出站权限
firewall-cmd --query-service=https
# 若无权限则放开
firewall-cmd --add-service=https --permanent && firewall-cmd --reload

• 若为国内网络环境访问GitHub Pages受限，可替换为国内镜像源的prometheus仓库：

helm repo add prometheus-community https://mirrors.aliyun.com/helm-charts/prometheus-community/

• 添加成功后执行helm repo update验证仓库可用即可。

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