阿里雲CLI可用環境變數 - Alibaba Cloud CLI

阿里雲 CLI 支援通過環境變數配置憑證、地區、行為選項等運行參數。在 CI/CD 管道、容器環境或自動化指令碼中，環境變數是傳遞憑證和回合組態的首選方式。本文匯總所有支援的環境變數，明確優先順序關係，協助你快速定位所需配置項。

優先順序說明

阿里雲 CLI 讀取配置時，按以下優先順序從高到低生效：

通過環境變數配置 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 OIDC 用戶端識別碼。設定後覆蓋 CLI 內建的預設用戶端識別碼。

關於各憑證類型的配置方法和適用情境，請參見配置憑證。

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

環境變數	說明
`ALIBABA_CLOUD_PROFILE`	指定使用的配置名稱，等同於 `--profile` 參數。
`ALIBABA_CLOUD_IGNORE_PROFILE`	設為 `TRUE`（必須全大寫，區分大小寫）時，CLI 忽略設定檔中的 Profile，僅使用環境變數提供的憑證。

環境變數	說明
`ALIBABA_CLOUD_REGION_ID`	預設區域 ID，例如 `cn-hangzhou`。
`ALIBABA_CLOUD_ENDPOINT`	自訂 API 存取點地址。設定後 CLI 直接使用該地址發送請求，不再自動解析存取點。
`ALIBABA_CLOUD_ENDPOINT_TYPE`	存取點類型。例如設為 `vpc` 使用 VPC 內網存取點，留空或不設定使用公網存取點。

控制外掛程式的自動安裝行為、儲存位置和下載源。

環境變數	說明
`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` 或 `1` 時，繞過外掛程式索引緩衝，每次從遠端擷取最新索引。
`ALIBABA_CLOUD_CLI_PLUGIN_SOURCE_BASE`	自訂外掛程式下載源的基礎 URL。適用於內網環境或私人鏡像情境。

CLI 從當前 Profile 中解析以下設定後自動傳遞給外掛程式子進程。如需調整逾時和重試策略，建議通過 aliyun configure 命令或直接編輯設定檔。

環境變數	說明
`ALIBABA_CLOUD_READ_TIMEOUT`	I/O 讀逾時，單位為秒。
`ALIBABA_CLOUD_CONNECT_TIMEOUT`	連線逾時，單位為秒。
`ALIBABA_CLOUD_RETRY_COUNT`	請求失敗時的重試次數。
`ALIBABA_CLOUD_LANGUAGE`	CLI 語言設定。可選值為 `en`（英文）或 `zh`（中文）。