安装/更新阿里云 CLI

通过 Bash 脚本安装（推荐）

通过 TGZ 安装包（.tar.gz）安装

通过 Homebrew 安装（推荐）

通过图形界面（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"