helm客户端安装后helm version报错或连不上集群，主因是path、kubeconfig或仓库配置错误；应手动下载二进制、校验权限、确认kubeconfig路径与权限、更换国内镜像源并执行helm repo update。
Helm 客户端在 Linux 上能装上，但 helm version 报错或连不上集群，八成不是 Helm 没装好，而是 PATH、kubeconfig 或仓库配置没对上。
curl 脚本安装失败时该怎么做
官方 get-helm-3 脚本依赖境外网络，国内多数环境会卡在下载或校验环节，直接放弃脚本是最省时间的选择。
- 别反复重试
./get_helm.sh，它不会自动降级或切源 - 改用手动下载：从
https://get.helm.sh/找最新linux-amd64.tar.gz（如helm-v3.14.4-linux-amd64.tar.gz） - 解压后确认二进制文件权限：
ls -l linux-amd64/helm—— 若无执行位，先chmod +x linux-amd64/helm - 复制前检查目标路径是否在
$PATH里：echo $PATH | grep /usr/local/bin，不在就加export PATH=/usr/local/bin:$PATH到~/.bashrc
用 apt/dnf 安装后 helm version 显示 client only
这是正常现象，Helm 3 不再自带服务端 Tiller，client only 表示客户端已就位，但还没连上 Kubernetes 集群。
Linux Ai Server
下载
Linux AI 服务器 — 将 Linux 服务器转换为本地 AI 推理集群。使用 systemd、NVIDIA CUDA 实现无头 Linux AI，零 GUI 开销。
- 先确认
kubectl能用：kubectl get nodes成功才继续 - 检查
~/.kube/config是否存在且可读：ls -l ~/.kube/config，权限应为-rw------- - 若用 K3s，config 默认在
/etc/rancher/k3s/k3s.yaml，需手动复制并修正 server 地址：sudo cp /etc/rancher/k3s/k3s.yaml ~/.kube/config && sed -i 's/127.0.0.1/localhost/g' ~/.kube/config - 非 root 用户运行
kubectl时，注意~/.kube/config所有者必须是当前用户，否则 Helm 会静默忽略
添加仓库时 timeout 或 connection refused
默认的 https://charts.helm.sh/stable 已废弃，且国内直连基本不可用，硬试只会浪费时间。
- 优先换国内镜像源：
helm repo add bitnami https://charts.bitnami.com/bitnami（Bitnami 仓库稳定，支持 HTTPS） - 阿里云源已停更，
https://apphub.aliyuncs.com返回 404，别再试 - 添加后必须
helm repo update，否则helm search查不到任何 Chart - 若公司内网有私有 Harbor Chart 仓库，确保 URL 是
https://harbor.example.com/chartrepo/library格式，末尾不能少/library
helm install 后 helm list 空输出
不是没装上，而是 Release 默认只显示当前命名空间下的资源，而 Helm 3 的 release scope 是 namespace 级，不是 cluster 级。
- 加
-A参数查全部：helm list -A - 或者指定命名空间：
helm list -n default - 如果仍为空，检查安装命令是否漏了
--namespace，例如：helm install my-mysql bitnami/mysql --namespace default - Release 名称含特殊字符（如下划线）可能导致某些旧版 Helm CLI 解析异常，建议用短横线或纯字母数字
最容易被忽略的是：Helm 本身不验证 kubeconfig 里的证书有效性，helm version 成功不代表能部署；真正卡住的往往在 helm install 第一次调用时——那时才真正发起 gRPC 连接，报错信息也最具体。盯着那条错误，比反复重装 Helm 有用得多。
