Alibaba Cloud CLI：安裝/更新阿里雲 CLI

通過 Bash 指令碼安裝（推薦）

通過 TGZ 安裝包（.tar.gz）安裝

通過 Homebrew 安裝（推薦）

brew install aliyun-cli

通過圖形介面（PKG）安裝

雙擊安裝，無需命令列工具。

1. 下載安裝包。

   • 下載最新版本：在瀏覽器中開啟下載連結 https://aliyuncli.alicdn.com/aliyun-cli-latest.pkg，下載最新版本安裝包。

   • 下載歷史版本：訪問 GitHub Releases 頁面可查看並下載歷史版本安裝包。

     macOS 適用的 PKG（macOS Installer Package，.pkg）安裝包包名格式為 aliyun-cli-<version>.pkg。

2. 雙擊下載好的安裝包，按照說明指引完成安裝。

通過 Bash 指令碼安裝

安裝命令與 Linux 相同，參數說明請參見 Linux 的「通過 Bash 指令碼安裝」方式。

• 安裝最新版本

  /bin/bash -c "$(curl -fsSL https://aliyuncli.alicdn.com/install.sh)"

• 安裝歷史版本

  重要

  版本要求見「版本資訊」章節。

  /bin/bash -c "$(curl -fsSL https://aliyuncli.alicdn.com/install.sh)" -- -V 3.3.5

通過 TGZ 安裝包（.tar.gz）安裝

1. 下載安裝包。

   • 下載最新版本：

     curl https://aliyuncli.alicdn.com/aliyun-cli-macosx-latest-universal.tgz -o aliyun-cli-macosx-latest-universal.tgz

   • 下載歷史版本：訪問 GitHub Releases 頁面可下載歷史版本安裝包。

     macOS 適用安裝包包名格式為 aliyun-cli-macosx-<version>-universal.tgz。

     重要

     版本要求見「版本資訊」章節。

2. 解壓安裝包以擷取可執行檔 aliyun。

   tar xzvf aliyun-cli-macosx-latest-universal.tgz

3. 將可執行檔移動至 /usr/local/bin 目錄，使 aliyun 命令可在任意路徑下運行。

   sudo mv ./aliyun /usr/local/bin/

通過圖形介面（GUI）安裝

通過 PowerShell 指令碼安裝

1. 建立指令檔 Install-CLI-Windows.ps1。可在 PowerShell 中執行 New-Item Install-CLI-Windows.ps1 建立，或在檔案總管中建立文字文件後重新命名。

2. 將以下代碼複製並儲存到指令檔中。

   指令碼樣本

   # Install-CLI-Windows.ps1
   # Purpose: Install Alibaba Cloud CLI on Windows AMD64 systems.
   # Supports custom version and install directory. Only modifies User-level and Process-level PATH.
   
   [CmdletBinding()]
   param (
       [string]$Version = "latest",
       [string]$InstallDir = "$env:LOCALAPPDATA",
       [switch]$Help
   )
   
   function Show-Usage {
       Write-Output @"
   
         Alibaba Cloud Command Line Interface Installer
   
       -Help                 Display this help and exit
   
       -Version VERSION      Custom CLI version. Default is 'latest'
   
       -InstallDir PATH      Custom installation directory. Default is:
                             $InstallDir\AliyunCLI
   
   "@
   }
   
   function Write-ErrorExit {
       param([string]$Message)
       Write-Error $Message
       exit 1
   }
   
   if ($PSBoundParameters['Help']) {
       Show-Usage
       exit 0
   }
   
   Write-Output @"
   ..............888888888888888888888 ........=8888888888888888888D=..............
   ...........88888888888888888888888 ..........D8888888888888888888888I...........
   .........,8888888888888ZI: ...........................=Z88D8888888888D..........
   .........+88888888 ..........................................88888888D..........
   .........+88888888 .......Welcome to use Alibaba Cloud.......O8888888D..........
   .........+88888888 ............. ************* ..............O8888888D..........
   .........+88888888 .... Command Line Interface(Reloaded) ....O8888888D..........
   .........+88888888...........................................88888888D..........
   ..........D888888888888DO+. ..........................?ND888888888888D..........
   ...........O8888888888888888888888...........D8888888888888888888888=...........
   ............ .:D8888888888888888888.........78888888888888888888O ..............
   "@
   
   $OSArchitecture = (Get-WmiObject -Class Win32_OperatingSystem).OSArchitecture
   
   $ProcessorArchitecture = [int](Get-WmiObject -Class Win32_Processor).Architecture
   
   if (-not ($OSArchitecture -match "64") -or $ProcessorArchitecture -ne 9) {
       Write-ErrorExit "Alibaba Cloud CLI only supports Windows AMD64 systems. Please run on a compatible system."
   }
   
   $DownloadUrl = "https://aliyuncli.alicdn.com/aliyun-cli-windows-$Version-amd64.zip"
   
   $tempPath = $env:TEMP
   $randomName = -join ((65..90) + (97..122) + (48..57) | Get-Random -Count 8)
   $DownloadDir = Join-Path -Path $tempPath -ChildPath $randomName
   New-Item -ItemType Directory -Path $DownloadDir | Out-Null
   
   try {
       $InstallDir = Join-Path $InstallDir "AliyunCLI"
       if (-not (Test-Path $InstallDir)) {
           New-Item -ItemType Directory -Path $InstallDir -Force | Out-Null
       }
   
       $ZipPath = Join-Path $DownloadDir "aliyun-cli.zip"
       Start-BitsTransfer -Source $DownloadUrl -Destination $ZipPath
   
       Expand-Archive -Path $ZipPath -DestinationPath $DownloadDir -Force
   
       Move-Item -Path "$DownloadDir\aliyun.exe" -Destination "$InstallDir\" -Force
   
       $Key = 'HKCU:\Environment'
       $CurrentPath = (Get-ItemProperty -Path $Key -Name PATH).PATH
   
       if ([string]::IsNullOrEmpty($CurrentPath)) {
           $NewPath = $InstallDir
       } else {
           if ($CurrentPath -notlike "*$InstallDir*") {
               $NewPath = "$CurrentPath;$InstallDir"
           } else {
               $NewPath = $CurrentPath
           }
       }
   
       if ($NewPath -ne $CurrentPath) {
           Set-ItemProperty -Path $Key -Name PATH -Value $NewPath
           $env:PATH += ";$InstallDir"
       }
   } catch {
       Write-ErrorExit "Failed to install Alibaba Cloud CLI: $_"
   } finally {
       Remove-Item -Path $DownloadDir -Recurse -Force | Out-Null
   }

3. 參考以下樣本，運行指令檔安裝阿里雲 CLI。

   說明

   樣本指令碼路徑為 C:\Example\Install-CLI-Windows.ps1，請將指令碼路徑替換為實際位置後運行命令。

   • 若未指定版本，指令碼將自動安裝最新版本。預設安裝路徑為：C:\Users\<USERNAME>\AppData\Local\AliyunCLI。

     powershell.exe -ExecutionPolicy Bypass -File C:\Example\Install-CLI-Windows.ps1

   • 使用 -Version 和 -InstallDir 選項可指定安裝版本和安裝目錄。訪問 GitHub Releases 頁面可查看歷史可用版本。

     powershell.exe -ExecutionPolicy Bypass -File C:\Example\Install-CLI-Windows.ps1 -Version 3.3.15 -InstallDir "C:\ExampleDir\AliyunCLI"