阿里云CLI可用环境变量-阿里云CLI(CLI)-阿里云帮助中心

阿里云 CLI 支持通过环境变量配置凭证、区域、行为选项等运行参数。在 CI/CD 管道、容器环境或自动化脚本中，环境变量是传递凭证和运行配置的首选方式。本文汇总所有支持的环境变量，明确优先级关系，帮助你快速定位所需配置项。

优先级说明

阿里云 CLI 读取配置时，按以下优先级从高到低生效：

命令行参数（如 --profile、--region）
配置文件（~/.aliyun/config.json）
环境变量

凭证与身份

通过环境变量配置 AccessKey、STS Token、OIDC（OpenID Connect）、RAM 角色等凭证信息，无需在配置文件中明文存储密钥。

环境变量	说明
`ALIBABA_CLOUD_ACCESS_KEY_ID`	AccessKey ID。
`ALIBABA_CLOUD_ACCESS_KEY_SECRET`	AccessKey Secret。
`ALIBABA_CLOUD_SECURITY_TOKEN`	STS 临时安全令牌。与 AccessKey ID 和 AccessKey Secret 配合使用。
`ALIBABA_CLOUD_CREDENTIALS_URI`	CredentialsURI 模式的凭证服务地址。无别名。
`ALIBABA_CLOUD_OIDC_PROVIDER_ARN`	OIDC 身份提供商的 ARN（Alibaba Cloud Resource Name）。
`ALIBABA_CLOUD_OIDC_TOKEN_FILE`	OIDC Token 文件路径。
`ALIBABA_CLOUD_ROLE_ARN`	RAM 角色 ARN，适用于 RamRoleArn 和 ChainableRamRoleArn 认证模式。
`ALIBABA_CLOUD_EXTERNAL_ID`	外部 ID，用于跨账号角色扮演场景。
`ALIBABA_CLOUD_SSO_CLIENT_ID`	Cloud SSO 登录使用的应用客户端 ID。不设置时使用 CLI 内置的官方应用（`app-vaz16tltdxs96audqf35`），一般无需修改。

关于各凭证类型的配置方法和适用场景，请参见配置凭证。

配置选择

控制 CLI 使用哪个配置（Profile）。

环境变量	说明
`ALIBABA_CLOUD_PROFILE`	指定使用的 Profile，等同于 `--profile` 参数。未设置时使用配置文件中的当前 Profile。
`ALIBABA_CLOUD_IGNORE_PROFILE`	设为 `TRUE`（必须全大写，区分大小写）时，CLI 忽略配置文件中的 Profile，仅使用环境变量提供的凭证。未设置时正常读取配置文件中的 Profile。

区域与接入点

环境变量	说明
`ALIBABA_CLOUD_REGION_ID`	默认区域 ID，例如 `cn-hangzhou`。未设置且 Profile 中也无区域时，需要区域的调用会失败。
`ALIBABA_CLOUD_ENDPOINT`	自定义 API 接入点地址。设置后 CLI 直接使用该地址发送请求，不再自动解析接入点。未设置时由 CLI 根据产品和地域自动解析接入点。
`ALIBABA_CLOUD_ENDPOINT_TYPE`	接入点类型。例如设为 `vpc` 使用 VPC 内网接入点，留空或不设置使用公网接入点。
`ALIBABA_CLOUD_STS_ENDPOINT`	自定义 STS 服务接入点地址。用于 RamRoleArn、ChainableRamRoleArn 等需要调用 STS 获取临时凭证的认证模式。未设置时由 CLI 自动选用所在区域的公网 STS 接入点。

插件管理

控制插件的自动安装行为、存储位置和下载源。

环境变量	说明
`ALIBABA_CLOUD_CLI_PLUGIN_AUTO_INSTALL`	设为 `true` 时，CLI 在调用插件命令时自动安装缺失的插件。未设置时不自动安装。
`ALIBABA_CLOUD_CLI_PLUGIN_AUTO_INSTALL_ENABLE_PRE`	设为 `true` 时，允许自动安装预发布版本的插件。未设置时不安装预发布版本。
`ALIBABA_CLOUD_CLI_PLUGINS_DIR`	自定义插件安装目录。默认为 `~/.aliyun/plugins/`。
`ALIBABA_CLOUD_CLI_PLUGIN_NO_CACHE`	设为 `true` 时，绕过插件索引缓存，每次从远端获取最新索引。未设置时使用插件索引缓存。
`ALIBABA_CLOUD_CLI_PLUGIN_SOURCE_BASE`	自定义插件下载源的基础 URL。适用于内网环境或私有镜像场景。未设置时使用官方默认插件源 `https://aliyuncli.alicdn.com/plugins-v2`。

网络、超时与语言

下表的超时、重试和语言变量由 CLI 传递给插件使用。要设置 CLI 自身命令的超时、重试和语言，请用 --read-timeout、--connect-timeout、--retry-count、--language 参数或 aliyun configure。未设置时，CLI 自身调用默认读超时 10 秒、连接超时 5 秒。

环境变量	说明
`ALIBABA_CLOUD_READ_TIMEOUT`	I/O 读超时，单位为秒。
`ALIBABA_CLOUD_CONNECT_TIMEOUT`	连接超时，单位为秒。
`ALIBABA_CLOUD_RETRY_COUNT`	请求失败时的重试次数。
`ALIBABA_CLOUD_LANGUAGE`	传递给插件的语言设置，可选值为 `en`（英文）或 `zh`（中文）。CLI 自身的输出语言由 `--language` 参数决定，未设置时默认英文。

AI 模式与 Agent 集成

控制 AI 模式及 Agent 运行环境自动集成行为。关于 AI 模式的完整说明，请参见AI 模式。

环境变量	说明
`ALIBABA_CLOUD_CLI_AI_MODE`	为当前进程开启或关闭 AI 模式，优先级高于配置文件。设为 `true` 开启、`false` 关闭；未设置时以配置文件为准。
`ALIBABA_CLOUD_CLI_AGENT_INTEGRATION`	控制在检测到 Agent 运行环境时是否自动启用相应集成。未设置时保持默认（自动启用）；设为 `disabled` 关闭全部集成；设为 `all` 启用全部；也可用英文逗号分隔的允许列表仅启用指定集成（如 `ai-mode`）。

安全策略

通过环境变量控制安全策略，优先级高于配置文件。关于安全策略的完整说明，请参见安全策略（Safety policy）。

环境变量	说明
`ALIBABA_CLOUD_SAFETY_POLICY_ENABLED`	覆盖配置文件中的启用状态。设为 `true` 启用、`false` 停用；未设置时以配置文件中的启用状态为准。
`ALIBABA_CLOUD_SAFETY_POLICY_RULES`	覆盖配置文件中的规则列表，格式为 `pattern=action`，多条规则以英文逗号分隔，action 可选 `allow`、`deny`、`confirm`。设置后完全替换配置文件中的规则（非合并），设为空字符串清空所有规则。示例：`:Delete=deny,ecs:Update*=confirm`。未设置时以配置文件中的规则为准。
`ALIBABA_CLOUD_SAFETY_SKIP_CONFIRM`	设为 `true` 时，跳过安全策略的确认提示，等同于 `--yes`。未设置时不跳过确认提示。