在仅通过Proxy联网的环境中使用Helm命令的问题及报错解决

报错原因 #

你遇到的Error: "helm repo add" requires 2 arguments错误，是因为Helm的repo add命令不支持直接在命令行传入代理参数。你可能错误地将代理相关参数（比如自定义的--proxy类参数）加到了命令参数中，导致命令的必选参数（仓库名、仓库地址）被干扰，参数数量不符合要求。

解决方案 #

方案1：临时设置环境变量（单次会话生效） #

Helm会自动读取系统的HTTP/HTTPS代理环境变量，执行命令前先配置好即可：

# 配置HTTP代理
export HTTP_PROXY=http://你的代理IP:端口
# 配置HTTPS代理（注意多数场景下HTTPS代理也用HTTP协议地址）
export HTTPS_PROXY=http://你的代理IP:端口

# 如果代理需要身份认证，格式如下
export HTTP_PROXY=http://用户名:密码@你的代理IP:端口
export HTTPS_PROXY=http://用户名:密码@你的代理IP:端口

# 可选：配置不需要走代理的内部地址
export NO_PROXY=localhost,127.0.0.1,cluster.local

之后正常执行Helm命令即可：

helm repo add stable https://charts.helm.sh/stable
helm repo update

方案2：永久配置到Helm全局配置文件 #

编辑Helm的全局配置文件（路径通常为~/.config/helm/config.yaml，旧版本可能是~/.helm/config.yaml），添加代理配置：

global:
  httpProxy: http://你的代理IP:端口
  httpsProxy: http://你的代理IP:端口
  noProxy: localhost,127.0.0.1,cluster.local

若代理需要认证，修改为：

global:
  httpProxy: http://用户名:密码@你的代理IP:端口
  httpsProxy: http://用户名:密码@你的代理IP:端口

保存后，所有Helm命令都会自动使用该代理配置，无需每次手动设置环境变量。

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