Tous les produits
Search
Centre de documentation

Alibaba Cloud CLI:Install, update, and uninstall Alibaba Cloud CLI

Dernière mise à jour :Aug 11, 2026

Cette rubrique explique comment installer, vérifier, mettre à jour et désinstaller Alibaba Cloud CLI sous Linux, macOS et Windows.

Informations sur la version

Alibaba Cloud CLI publie régulièrement de nouvelles versions. Nous vous recommandons d'utiliser toujours la dernière version pour bénéficier de la meilleure expérience. Exécutez aliyun version pour consulter votre version actuelle. Consultez la page des GitHub Releases pour obtenir la dernière version ainsi que les notes de publication.

Important

Les versions antérieures à la 3.3.0 ont atteint leur fin de vie (EOL) et ne reçoivent plus de mises à jour fonctionnelles ni de correctifs de sécurité. Si votre version est inférieure à la 3.3.0, consultez le guide de migration pour effectuer la mise à niveau.

Prérequis

  • Vous disposez d'un compte Alibaba Cloud.

  • (Facultatif) L'outil de ligne de commande curl. La plupart des distributions Linux et macOS l'incluent par défaut. Vous pouvez ignorer cette exigence si vous effectuez l'installation via un gestionnaire de paquets ou un installateur graphique.

Systèmes d'exploitation pris en charge

|
**Système d'exploitation**
|
**Versions prises en charge**
|
**Architectures prises en charge**
| | --- | --- | --- | |
Linux
|
CentOS 8+, RHEL 8+, Ubuntu 16.04+, Debian 9+ et autres distributions majeures. CentOS 7 a atteint sa fin de vie et n'est pas recommandé.
|
x86_64 (64 bits), ARM64
| |
macOS
|
macOS 11 (Big Sur) ou version ultérieure
|
Intel et puces Apple (binaire universel)
| |
Windows
|
Windows 10 et versions ultérieures (64 bits)
|
x86_64 uniquement. Les architectures 32 bits et ARM64 ne sont pas prises en charge.
|























Installer Alibaba Cloud CLI

Sélectionnez votre système d'exploitation, puis choisissez une méthode d'installation.

Linux

Utilisez le script Bash pour une installation rapide en une seule commande, ou optez pour le package .tar.gz pour les environnements isolés du réseau ou pour définir des chemins d'installation personnalisés.

Utiliser un script Bash (recommandé)

Le script détecte l'architecture de votre système, télécharge le package approprié et place le binaire aliyun dans le répertoire /usr/local/bin/.

  • Installer la dernière version

    /bin/bash -c "$(curl -fsSL https://aliyuncli.alicdn.com/install.sh)"
  • Installer une version spécifique

    Utilisez l'indicateur -V pour spécifier une version. Consultez les GitHub Releases pour connaître les versions disponibles.

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

Utiliser un package .tar.gz

  1. Téléchargez le package correspondant à l'architecture de votre système.

    Remarque

    Exécutez uname -m pour vérifier votre architecture. Une sortie arm64 ou aarch64 indique une architecture ARM64 ; toute autre sortie indique x86_64.

    • x86_64 (64 bits) :

      curl https://aliyuncli.alicdn.com/aliyun-cli-linux-latest-amd64.tgz -o aliyun-cli-linux-latest.tgz
    • ARM64 :

      curl https://aliyuncli.alicdn.com/aliyun-cli-linux-latest-arm64.tgz -o aliyun-cli-linux-latest.tgz
    • Pour télécharger une version spécifique, rendez-vous sur la page des GitHub Releases . Les noms de packages suivent le format aliyun-cli-linux-<version>-<arch>.tgz, où <arch> correspond à amd64 ou arm64.

  2. Extrayez le package.

    tar xzvf aliyun-cli-linux-latest.tgz
  3. Déplacez le binaire vers un répertoire inclus dans votre PATH.

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

macOS

Utiliser Homebrew (recommandé)

Remarque

Homebrew doit être installé avant de poursuivre.

Installez la dernière version :

brew install aliyun-cli

Utiliser l'installateur macOS (.pkg)

  1. Téléchargez l'installateur.

  2. Double-cliquez sur le fichier .pkg téléchargé et suivez les instructions à l'écran.

    Remarque

    Si macOS bloque l'installateur avec un avertissement de sécurité, ouvrez System Settings > Privacy & Security , puis cliquez sur Open Anyway pour continuer.

Utiliser un script Bash

Le script détecte macOS et télécharge automatiquement le binaire universel. Les commandes sont identiques à celles utilisées sous Linux.

  • Installer la dernière version

    /bin/bash -c "$(curl -fsSL https://aliyuncli.alicdn.com/install.sh)"
  • Installer une version spécifique

    Consultez les GitHub Releases pour connaître les versions disponibles.

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

Utiliser un package .tar.gz

  1. Téléchargez le package.

    • Dernière version :

      curl https://aliyuncli.alicdn.com/aliyun-cli-macosx-latest-universal.tgz -o aliyun-cli-macosx-latest-universal.tgz
    • Version spécifique : rendez-vous sur la page des GitHub Releases . Les noms de packages suivent le format aliyun-cli-macosx-<version>-universal.tgz.

  2. Extrayez le package.

    tar xzvf aliyun-cli-macosx-latest-universal.tgz
  3. Déplacez le binaire vers un répertoire inclus dans votre PATH.

    sudo mv ./aliyun /usr/local/bin

Windows

Important

Alibaba Cloud CLI prend uniquement en charge les systèmes Windows x86_64 (64 bits). Les systèmes 32 bits et ARM64 ne sont pas pris en charge.

Utilisez le package ZIP pour une installation manuelle rapide, ou optez pour le script PowerShell pour des installations automatisées.

Utiliser un package ZIP

  1. Téléchargez le package.

  2. Extrayez aliyun.exe vers le répertoire de votre choix. Par exemple, C:\AliyunCLI.

    Remarque

    aliyun.exe est un outil de ligne de commande. Un double-clic dessus n'a aucun effet. Exécutez-le depuis un terminal (Invite de commandes ou PowerShell).

  3. Appuyez sur Windows + S et recherchez environment variables .

  4. Cliquez sur Edit the environment variables for your account .

  5. Sous User variables , sélectionnez Path , puis cliquez sur Edit .

  6. Cliquez sur New et saisissez le chemin du répertoire (par exemple, C:\AliyunCLI ).

    image

  7. Cliquez sur OK dans chaque boîte de dialogue pour enregistrer les modifications.

  8. Redémarrez votre terminal pour que les modifications prennent effet.

Utiliser un script PowerShell

  1. Créez un fichier nommé Install-CLI-Windows.ps1 et collez-y le script suivant.

    Exemple de script

    # 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
    }
  2. Exécutez le script pour installer Alibaba Cloud CLI.

    Remarque

    Le chemin d'exemple du script est C:\Example\Install-CLI-Windows.ps1 . Remplacez-le par le chemin réel de votre script.

    • Installez la dernière version. Le chemin d'installation par défaut est C:\Users\<*USERNAME**>*\AppData\Local\AliyunCLI.

      powershell.exe -ExecutionPolicy Bypass -File C:\Example\Install-CLI-Windows.ps1
    • Spécifiez une version (disponible sur les GitHub Releases ) et un répertoire d'installation.

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

Vérifier l'installation

Ouvrez un nouveau terminal et exécutez :

aliyun version

Un numéro de version tel que 3.3.18 confirme que l'installation a réussi.

Pour vérifier plus en détail que la CLI fonctionne correctement :

aliyun configure list

Cette commande affiche vos profils d'identifiants, même si la liste est vide.

Si la commande renvoie command not found, consultez la section Dépannage.

Après l'installation, configurez vos identifiants d'accès pour commencer à utiliser Alibaba Cloud CLI :

Mettre à jour Alibaba Cloud CLI

Exécutez aliyun version pour vérifier votre version actuelle, puis suivez la procédure de mise à niveau appropriée.

Déterminer votre méthode d'installation

Si vous ne savez pas comment la CLI a été installée, localisez le binaire :

  • Linux/macOS : Exécutez which aliyun.

    • Le chemin contient /homebrew/ ou /linuxbrew/ → Homebrew.

    • Le chemin est /usr/local/bin/aliyun → script Bash ou package .tar.gz.

    • Autre chemin → package .tar.gz vers un répertoire personnalisé.

  • Windows : Exécutez where aliyun.exe dans l'invite de commandes.

    • Le chemin est %LOCALAPPDATA%\AliyunCLI\aliyun.exe → script PowerShell (chemin par défaut).

    • Autre chemin → package ZIP vers un répertoire personnalisé.

Vérifier votre version

Exécutez aliyun version pour vérifier votre version actuelle, puis suivez la procédure de mise à niveau appropriée :

  • Version 3.3.5 ou ultérieure : Utilisez aliyun upgrade (recommandé) ou réinstallez.

  • Version 3.3.0 à 3.3.4 : Réinstallez pour effectuer la mise à jour. Une fois la version 3.3.5 ou ultérieure atteinte, utilisez aliyun upgrade pour les futures mises à jour.

  • Version antérieure à 3.3.0 : Consultez le guide de migration pour effectuer la mise à niveau initiale.

Utiliser aliyun upgrade (recommandé)

Disponible à partir de la version 3.3.5. Cette commande télécharge et installe la dernière version.

  • Mettre à jour vers la dernière version :

    aliyun upgrade
  • Pour ignorer la demande de confirmation :

    aliyun upgrade --yes
Remarque

aliyun upgrade ne s'applique pas aux installations effectuées via Homebrew. Utilisez plutôt brew upgrade aliyun-cli.

Mettre à jour par réinstallation

Choisissez la méthode correspondant à votre installation d'origine :

  • Script Bash (Linux/macOS) : Réexécutez le script d'installation pour passer à la dernière version.

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

    brew update && brew upgrade aliyun-cli && brew cleanup aliyun-cli
  • Programme d'installation macOS (.pkg) / package ZIP (Windows) :

    • Programme d'installation macOS (.pkg) : Téléchargez le dernier fichier .pkg et exécutez-le. Le nouveau binaire écrase l'installation précédente.

    • Package ZIP (Windows) : Téléchargez le dernier fichier .zip, extrayez aliyun.exe et remplacez le binaire existant. Aucune modification du PATH n'est nécessaire.

  • Package .tar.gz (Linux/macOS) : Téléchargez le dernier package, extrayez-le et déplacez le binaire vers le même répertoire que votre installation d'origine.

  • Script PowerShell (Windows) : Réexécutez le script avec les mêmes paramètres. Ajoutez -Version <version> pour installer une version spécifique.

    powershell.exe -ExecutionPolicy Bypass -File <script_path> [-InstallDir <install_path>]
    Remarque

    Ajoutez -Version <version> pour mettre à jour vers une version spécifique. Omettez ce paramètre pour installer la dernière version publiée. Consultez les Versions GitHub pour voir les versions disponibles.

Remarques

  • Si vous avez utilisé un répertoire d'installation personnalisé, spécifiez le même répertoire lors de la mise à jour.

  • Si vous devez changer de méthode d'installation ou modifier le répertoire d'installation, désinstallez complètement d'abord, puis réinstallez.

Vérifier la mise à jour

Confirmez que la mise à jour a réussi :

aliyun version

Désinstaller Alibaba Cloud CLI

Linux

Utiliser la ligne de commande

  1. Localisez et supprimez le binaire :

    sudo rm -v "$(which aliyun)"
  2. Si vous avez installé dans un répertoire personnalisé et l'avez ajouté au PATH, supprimez cette entrée de votre fichier de configuration shell (~/.bashrc pour Bash ou ~/.zshrc pour Zsh) et rechargez :

    source ~/.bashrc
    Remarque

    Remplacez ~/.bashrc par ~/.zshrc si votre shell par défaut est Zsh.

Utiliser un script Bash

  1. Créez un fichier de script et collez-y le contenu suivant.

    Exemple de script

    #!/usr/bin/env bash
    
    set -euo pipefail
    
    show_help() {
    cat << EOF
    
          Alibaba Cloud Command Line Interface Uninstaller
    
        -h          Display this help and exit
    
        -C          Remove user config file
    
    EOF
    }
    
    abort() {
      printf "%s\n" "$@" >&2
      exit 1
    }
    
    CLEAN_CONFIG=false
    
    while getopts ":hC" opt; do
      case "$opt" in
        "h")
          show_help
          exit 0
          ;;
        "C")
          CLEAN_CONFIG=true
          ;;
        *)
          echo "Unexpected flag not supported"
          exit 1
          ;;
      esac
    done
    
    echo -e "
    ..............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 ..............
    "
    
    USER_CONFIG_DIR="${HOME}/.aliyun"
    CONFIG_FILE_PATH="${USER_CONFIG_DIR}/config.json"
    
    remove_aliyun_binary() {
      local binary
      binary=$(which aliyun)
    
      if [ -n "$binary" ]; then
        rm -vf "$binary"
        rmdir --ignore-fail-on-non-empty "$(dirname "$binary")" 2>/dev/null || true
      fi
    }
    
    remove_user_config() {
      if $CLEAN_CONFIG; then
        rm -f "${CONFIG_FILE_PATH}" || abort "Failed to remove config file: ${CONFIG_FILE_PATH}"
    
        if [ -d "${USER_CONFIG_DIR}" ]; then
          rmdir --ignore-fail-on-non-empty "${USER_CONFIG_DIR}" 2>/dev/null || true
        fi
      fi
    }
    
    remove_aliyun_binary
    remove_user_config
    
    echo "Aliyun CLI has been uninstalled."
  2. Exécutez le script :

    # Uninstall only the executable file
    bash <script_path>
    
    # Uninstall the executable file and delete the configuration file
    bash <script_path> -C
    
    # View script help
    bash <script_path> -h

macOS

Utiliser Homebrew

Désinstallez Alibaba Cloud CLI :

brew uninstall aliyun-cli

Utiliser la ligne de commande

  1. Supprimez le binaire aliyun :

    BINARY=$(which aliyun 2>/dev/null) && [ -n "$BINARY" ] && sudo rm -v "$BINARY"
  2. Si vous avez installé dans un répertoire personnalisé et l'avez ajouté au PATH, supprimez cette entrée de ~/.zshrc (ou ~/.bashrc) et rechargez :

    source ~/.zshrc
    Remarque

    Remplacez ~/.zshrc par ~/.bashrc si vous utilisez Bash.

Windows

Utiliser l'Explorateur de fichiers

  1. Accédez au répertoire d'installation et supprimez aliyun.exe.

  2. Appuyez sur Windows + S et recherchez environment variables.

  3. Cliquez sur Edit the environment variables for your account.

  4. Sous User variables, sélectionnez Path et cliquez sur Edit.

  5. Sélectionnez l'entrée du répertoire Alibaba Cloud CLI et cliquez sur Delete.

    image

  6. Cliquez sur OK dans chaque boîte de dialogue pour enregistrer.

Utiliser un script PowerShell

  1. Créez un fichier de script et collez-y le contenu suivant.

    Exemple de script

    # Uninstall-CLI-Windows.ps1
    # Purpose: Automatically detect and uninstall Aliyun CLI, and delete configuration files in user directory
    
    [CmdletBinding()]
    param (
        [switch]$Clean,
        [switch]$Help
    )
    
    function Show-Usage {
        Write-Output @"
    
          Alibaba Cloud Command Line Interface Uninstaller
    
        -Help                 Display this help and exit
    
        -Clean                Remove user config file
    
    "@
    }
    
    function Remove-DirectoryIfEmpty {
        param([string]$Path)
        if ((Get-ChildItem -Path $Path -Force).Count -eq 0) {
            Remove-Item -Path $Path -Force
        }
    }
    
    function Remove-AliyunCLIFromPath {
        param([string]$PathToRemove)
        $Key = 'HKCU:\Environment'
        $CurrentPath = (Get-ItemProperty -Path $Key -Name PATH).PATH
        if ($CurrentPath -like "*$PathToRemove*") {
            $newPath = ($CurrentPath -split ';' | Where-Object { $_ -ne $PathToRemove }) -join ';'
            Set-ItemProperty -Path $Key -Name PATH -Value $newPath
            $env:PATH = $newPath
        }
    }
    
    function Remove-AliyunCLI {
        $AliyunBinary = (Get-Command aliyun -ErrorAction SilentlyContinue).Source
        if ($AliyunBinary -and (Test-Path $AliyunBinary)) {
            Remove-Item -Path $AliyunBinary -Force
            $AliyunInstallDir = Split-Path -Parent $AliyunBinary
            Remove-DirectoryIfEmpty -Path $AliyunInstallDir
            Remove-AliyunCLIFromPath -PathToRemove $AliyunInstallDir
            Write-Output "Aliyun CLI binary has been removed."
        }
    }
    
    function Remove-ConfigFile {
        $ConfigDir = Join-Path $HOME ".aliyun"
        $ConfigFile = Join-Path $ConfigDir "config.json"
        if (Test-Path $ConfigFile) {
            Remove-Item -Path $ConfigFile -Force
            Remove-DirectoryIfEmpty -Path $ConfigDir
            Write-Output "Aliyun CLI config file has been removed."
        }
    }
    
    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 ..............
    "@
    
    try {
        Remove-AliyunCLI
        if ($PSBoundParameters['Clean']) { Remove-ConfigFile }
        Write-Output "Aliyun CLI has been uninstalled."
    } catch {
        Write-Output "Failed to uninstall Aliyun CLI: $_"
    }
  2. Exécutez le script :

    # Uninstall only the executable file
    powershell.exe -ExecutionPolicy Bypass -File <script_path>
    
    # Uninstall the executable file and delete the configuration file
    powershell.exe -ExecutionPolicy Bypass -File <script_path> -Clean
    
    # View script help
    powershell.exe -ExecutionPolicy Bypass -File <script_path> -Help

Supprimer les fichiers de configuration (facultatif)

Alibaba Cloud CLI stocke la configuration dans le répertoire .aliyun situé sous le répertoire personnel de l'utilisateur. Supprimez-le pour retirer entièrement toutes les données de la CLI :

  • Linux/macOS : ~/.aliyun

  • Windows : C:\Users\<*NOMUTILISATEUR**>*\.aliyun

Dépannage

La commande aliyun renvoie « command not found »

Le binaire aliyun ne figure pas dans votre PATH ou n'a pas été installé correctement.

  • Linux/macOS : Exécutez which aliyun. Si un chemin est renvoyé, le binaire existe mais son répertoire n'est pas inclus dans la variable PATH. En l'absence de résultat, le binaire n'a pas été installé. Relancez l'installation en suivant l'une des méthodes présentées dans la section Installation.

  • Windows : Exécutez where aliyun dans l'invite de commandes. Si un chemin s'affiche, le binaire est présent mais son dossier ne figure pas dans la variable PATH. Sans résultat, l'installation a échoué. Recommencez la procédure via l'une des options décrites dans la section Installation.

Si le binaire est localisé, ajoutez son répertoire à la variable PATH de votre shell :

  • Bash : Ajoutez la ligne export PATH="$PATH:/your/install/dir" au fichier ~/.bashrc, puis exécutez source ~/.bashrc.

  • Zsh : Insérez la même instruction dans ~/.zshrc, ensuite lancez source ~/.zshrc.

  • Windows : Suivez les étapes 3 à 8 de la section Windows > Utilisation d'un package ZIP afin d'intégrer le dossier d'installation à la variable d'environnement Path, puis redémarrez votre terminal.

La version affichée par aliyun diffère de celle attendue

Plusieurs binaires aliyun peuvent coexister sur votre système. Exécutez which aliyun (Linux/macOS) ou where aliyun (Windows) pour identifier le binaire résolu par votre shell. S'il pointe vers une ancienne installation, supprimez l'ancien binaire ou réorganisez les répertoires de votre variable PATH afin que la nouvelle installation soit prioritaire. Redémarrez le terminal et relancez aliyun version.

L'installation échoue avec l'erreur « Permission denied »

Les répertoires système tels que /usr/local/bin nécessitent des privilèges administrateur. Sous Linux et macOS, préfixez la commande avec sudo (par exemple, sudo mv ./aliyun /usr/local/bin/). Sur Windows, exécutez PowerShell en tant qu'administrateur.

Le délai d'attente est dépassé lors de l'installation ou de la mise à jour via Homebrew sur macOS

Ce problème survient généralement en raison d'une lenteur d'accès réseau au CDN GitHub. Configurez un miroir domestique pour Homebrew, tel que celui de l'USTC, comme indiqué dans la section d'installation Homebrew. Pour rendre ces paramètres persistants, ajoutez les lignes export au fichier ~/.zshrc (ou ~/.bashrc), puis exécutez source ~/.zshrc.

Un double-clic sur aliyun.exe sous Windows reste sans effet

Alibaba Cloud CLI est un outil en ligne de commande dépourvu d'interface graphique. Ouvrez l'invite de commandes ou PowerShell, accédez au répertoire contenant aliyun.exe (ou assurez-vous qu'il figure dans votre variable PATH), puis saisissez vos commandes.