Tüm Ürünler
Search

Bu Ürün

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

    Belge Merkezi

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

    Son Güncelleme:Oct 06, 2026

    Bu konuda, Alibaba Cloud CLI'nin Linux, macOS ve Windows işletim sistemlerine nasıl kurulacağı, doğrulanacağı, güncelleneceği ve kaldırılacağı açıklanmaktadır.

    Sürüm bilgileri

    Alibaba Cloud CLI düzenli olarak yeni sürümler yayınlamaktadır. En iyi deneyimi yaşamak için her zaman en son sürümü kullanmanızı öneririz. Mevcut sürümünüzü kontrol etmek için aliyun version komutunu çalıştırın. En son sürümü ve sürüm notlarını görüntülemek için GitHub Releases sayfasını ziyaret edin.

    Önemli

    3.3.0'dan önceki sürümlerin destek ömrü sona ermiştir (EOL) ve artık özellik güncellemeleri veya güvenlik düzeltmeleri almamaktadır. Sürümünüz 3.3.0'dan düşükse yükseltme yapmak için geçiş kılavuzuna bakın.

    Ön koşullar

    • Bir Alibaba Cloud hesabınız olmalıdır.

    • (İsteğe bağlı) curl komut satırı aracı. Çoğu macOS ve Linux dağıtımında bu araç varsayılan olarak bulunur. Bir paket yöneticisi veya grafiksel yükleyici aracılığıyla kurulum yapıyorsanız bu ön koşulu atlayabilirsiniz.

    Desteklenen işletim sistemleri


    İşletim sistemi


    Desteklenen sürümler


    Desteklenen mimariler


    Linux


    CentOS 8+, RHEL 8+, Ubuntu 16.04+, Debian 9+ ve diğer büyük dağıtımlar. CentOS 7'nin destek ömrü sona ermiştir ve kullanılması önerilmez.


    x86_64 (64-bit), ARM64


    macOS


    macOS 11 (Big Sur) veya üzeri


    Intel ve Apple silicon (Universal binary)


    Windows


    Windows 10 ve üzeri (64-bit)


    Yalnızca x86_64. 32-bit ve ARM64 desteklenmemektedir.

    Alibaba Cloud CLI'yi yükleyin

    İşletim sisteminizi seçin ve ardından bir kurulum yöntemi belirleyin.

    Linux

    Hızlı tek komutlu kurulum için Bash betiğini kullanın veya ağ bağlantısı olmayan ortamlar ve özel kurulum yolları için .tar.gz paketini tercih edin.

    Bash betiği kullanın (önerilen)

    Bu betik, sistem mimarinizi algılar, doğru paketi indirir ve aliyun ikili dosyasını /usr/local/bin/ dizinine yerleştirir.

    • En son sürümü yükleyin

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

    • Belirli bir sürümü yükleyin

      Sürüm belirtmek için -V bayrağını kullanın. Kullanılabilir sürümleri kontrol etmek için GitHub Releases sayfasına göz atın.

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

    .tar.gz paketi kullanın

    1. Sistem mimarinize uygun paketi indirin.

      Not

      Mimarinizi kontrol etmek için uname -m komutunu çalıştırın. arm64 veya aarch64 çıktısı ARM64 mimarisine işaret eder; diğer çıktılar x86_64 mimarisini gösterir.

      • x86_64 (64-bit):

        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

      • Belirli bir sürümü indirmek için GitHub Releases sayfasını ziyaret edin. Paket adları aliyun-cli-linux-<version>-<arch>.tgz biçimini takip eder; burada <arch> değeri amd64 veya arm64 olabilir.

    2. Paketi çıkarın.

      tar xzvf aliyun-cli-linux-latest.tgz

    3. İkili dosyayı PATH değişkeninizde bulunan bir dizine taşıyın.

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

    macOS

    Homebrew kullanın (önerilen)

    Not

    Devam etmeden önce Homebrew yüklü olmalıdır.

    En son sürümü yükleyin:

    brew install aliyun-cli

    macOS yükleyicisini (.pkg) kullanın

    1. Yükleyiciyi indirin.

    2. İndirilen .pkg dosyasına çift tıklayın ve ekrandaki talimatları izleyin.

      Not

      macOS güvenlik uyarısıyla yükleyiciyi engellerse System Settings > Privacy & Security bölümünü açın ve devam etmek için Open Anyway seçeneğine tıklayın.

    Bash betiği kullanın

    Bu betik macOS'u algılar ve universal binary dosyasını otomatik olarak indirir. Komutlar Linux ile aynıdır.

    • En son sürümü yükleyin

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

    • Belirli bir sürümü yükleyin

      Kullanılabilir sürümleri kontrol etmek için GitHub Releases sayfasına göz atın.

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

    .tar.gz paketi kullanın

    1. Paketi indirin.

      • En son sürüm:

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

      • Belirli bir sürüm: GitHub Releases sayfasını ziyaret edin. Paket adları aliyun-cli-macosx-<version>-universal.tgz biçimini takip eder.

    2. Paketi çıkarın.

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

    3. İkili dosyayı PATH değişkeninizde bulunan bir dizine taşıyın.

      sudo mv ./aliyun /usr/local/bin

    Windows

    Önemli

    Alibaba Cloud CLI yalnızca x86_64 (64-bit) Windows sistemlerini destekler. 32-bit ve ARM64 sistemler desteklenmemektedir.

    Hızlı manuel kurulum için ZIP paketini, otomatik kurulumlar için PowerShell betiğini kullanın.

    ZIP paketi kullanın

    1. Paketi indirin.

    2. aliyun.exe dosyasını istediğiniz bir dizine çıkarın. Örneğin, C:\AliyunCLI.

      Not

      aliyun.exe bir komut satırı aracıdır. Dosyaya çift tıklamanın hiçbir etkisi yoktur. Aracı bir terminalden (Command Prompt veya PowerShell) çalıştırın.

    3. Windows + S tuşlarına basın ve environment variables ifadesini arayın.

    4. Edit the environment variables for your account seçeneğine tıklayın.

    5. User variables altında Path öğesini seçin ve Edit düğmesine tıklayın.

    6. New seçeneğine tıklayın ve dizin yolunu girin (örneğin, C:\AliyunCLI).

      image

    7. Değişiklikleri kaydetmek için her iletişim kutusunda OK seçeneğine tıklayın.

    8. Değişikliğin etkili olması için terminalinizi yeniden başlatın.

    PowerShell betiği kullanın

    1. Install-CLI-Windows.ps1 adlı bir dosya oluşturun ve aşağıdaki betiği içine yapıştırın.

      Örnek betik

      # 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. Alibaba Cloud CLI'yi yüklemek için betiği çalıştırın.

      Not

      Örnek betik yolu C:\Example\Install-CLI-Windows.ps1 şeklindedir. Bu yolu kendi gerçek betik yolunuzla değiştirin.

      • En son sürümü yükleyin. Varsayılan kurulum yolu C:\Users\<*USERNAME**>*\AppData\Local\AliyunCLI şeklindedir.

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

      • Bir sürüm (GitHub Releases sayfasından alın) ve kurulum dizini belirtin.

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

    Kurulumu doğrulayın

    Yeni bir terminal açın ve aşağıdaki komutu çalıştırın:

    aliyun version

    3.3.18 gibi bir sürüm numarasının görünmesi kurulumun başarılı olduğunu gösterir.

    CLI'nin doğru çalıştığını daha detaylı doğrulamak için:

    aliyun configure list

    Bu komut, liste boş olsa bile kimlik bilgisi profillerinizi görüntüler.

    Komut command not found hatası döndürürse Sorun Giderme bölümüne bakın.

    Kurulumdan sonra Alibaba Cloud CLI'yi kullanmaya başlamak için erişim kimlik bilgilerinizi yapılandırın:

    Alibaba Cloud CLI'yi güncelleyin

    Mevcut sürümünüzü kontrol etmek için aliyun version komutunu çalıştırın ve ardından uygun yükseltme yolunu izleyin.

    Kurulum yönteminizi belirleyin

    CLI'nin nasıl kurulduğundan emin değilseniz ikili dosyanın konumunu bulabilirsiniz:

    • Linux/macOS: which aliyun komutunu çalıştırın.

      • Yol /homebrew/ veya /linuxbrew/ içeriyorsa → Homebrew.

      • Yol /usr/local/bin/aliyun ise → Bash betiği veya .tar.gz paketi.

      • Diğer bir yol → Özel bir dizine kurulmuş .tar.gz paketi.

    • Windows: Command Prompt'ta where aliyun.exe komutunu çalıştırın.

      • Yol %LOCALAPPDATA%\AliyunCLI\aliyun.exe ise → PowerShell betiği (varsayılan yol).

      • Diğer bir yol → Özel bir dizine kurulmuş ZIP paketi.

    Sürümünüzü kontrol edin

    Mevcut sürümünüzü kontrol etmek için aliyun version komutunu çalıştırın ve ardından uygun yükseltme yolunu izleyin:

    • Sürüm 3.3.5 veya üzeri: aliyun upgrade komutunu kullanın (önerilen) veya yeniden kurulum yapın.

    • Sürüm 3.3.0 ila 3.3.4: Güncellemek için yeniden kurulum yapın. 3.3.5+ sürümüne ulaştıktan sonra gelecekteki güncellemeler için aliyun upgrade komutunu kullanabilirsiniz.

    • 3.3.0'dan önceki sürümler: Önce yükseltme yapmak için geçiş kılavuzuna bakın.

    aliyun upgrade komutunu kullanın (önerilen)

    Bu özellik 3.3.5 ve sonraki sürümlerde mevcuttur. Bu komut en son sürümü indirip yükler.

    • En son sürüme güncelleyin:

      aliyun upgrade

    • Onay istemini atlamak için:

      aliyun upgrade --yes
    Not

    aliyun upgrade komutu Homebrew kurulumları için geçerli değildir. Bunun yerine brew upgrade aliyun-cli komutunu kullanın.

    Yeniden kurarak güncelleyin

    Orijinal kurulum yönteminize uygun olanı seçin:

    • Bash betiği (Linux/macOS): En son sürüme güncellemek için kurulum betiğini tekrar çalıştırın.

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

    • Homebrew (macOS):

      brew update && brew upgrade aliyun-cli && brew cleanup aliyun-cli

    • macOS yükleyicisi (.pkg) / ZIP paketi (Windows):

      • macOS yükleyicisi (.pkg): en son .pkg dosyasını indirin ve çalıştırın. Yeni ikili dosya önceki kurulumun üzerine yazılır.

      • ZIP paketi (Windows): en son .zip dosyasını indirin, aliyun.exe dosyasını çıkarın ve mevcut ikili dosyanın yerine koyun. PATH değişiklikleri gerekmez.

    • .tar.gz paketi (Linux/macOS): En son paketi indirin, çıkarın ve ikili dosyayı orijinal kurulumunuzla aynı dizine taşıyın.

    • PowerShell betiği (Windows): Betiği aynı parametrelerle tekrar çalıştırın. Belirli bir sürümü yüklemek için -Version <version> parametresini ekleyin.

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

      Belirli bir sürüme güncellemek için -Version <version> parametresini ekleyin. En son sürümü yüklemek için bu parametreyi atlayın. Kullanılabilir sürümleri kontrol etmek için GitHub Releases sayfasına göz atın.

    Notlar

    • Özel bir kurulum dizini kullandıysanız güncelleme sırasında aynı dizini belirtin.

    • Kurulum yöntemini değiştirmeniz veya kurulum dizinini değiştirmeniz gerekiyorsa önce tamamen kaldırın, ardından yeniden kurulum yapın.

    Güncellemeyi doğrulayın

    Güncellemenin başarılı olduğunu onaylayın:

    aliyun version

    Alibaba Cloud CLI'yi kaldırın

    Linux

    Komut satırını kullanın

    1. İkili dosyayı bulun ve kaldırın:

      sudo rm -v "$(which aliyun)"

    2. Özel bir dizine kurulum yaptıysanız ve bunu PATH'e eklediysanız, shell yapılandırma dosyanızdan (Bash için ~/.bashrc veya Zsh için ~/.zshrc) ilgili girişi kaldırın ve yeniden yükleyin:

      source ~/.bashrc
      Not

      Varsayılan shell'iniz Zsh ise ~/.bashrc yerine ~/.zshrc kullanın.

    Bash betiği kullanın

    1. Bir betik dosyası oluşturun ve aşağıdaki içeriği içine yapıştırın.

      Örnek betik

      #!/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. Betiği çalıştırın:

      # 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

    Homebrew kullanın

    Alibaba Cloud CLI'yi kaldırın:

    brew uninstall aliyun-cli

    Komut satırını kullanın

    1. aliyun ikili dosyasını kaldırın:

      BINARY=$(which aliyun 2>/dev/null) && [ -n "$BINARY" ] && sudo rm -v "$BINARY"

    2. Özel bir dizine kurulum yaptıysanız ve bunu PATH'e eklediysanız, ~/.zshrc (veya ~/.bashrc) dosyasından ilgili girişi kaldırın ve yeniden yükleyin:

      source ~/.zshrc
      Not

      Bash kullanıyorsanız ~/.zshrc yerine ~/.bashrc kullanın.

    Windows

    Dosya Gezgini'ni kullanın

    1. Kurulum dizinine gidin ve aliyun.exe dosyasını silin.

    2. Windows + S tuşlarına basın ve environment variables ifadesini arayın.

    3. Edit the environment variables for your account seçeneğine tıklayın.

    4. User variables altında Path öğesini seçin ve Edit düğmesine tıklayın.

    5. Alibaba Cloud CLI dizin girişini seçin ve Delete seçeneğine tıklayın.

      image

    6. Değişiklikleri kaydetmek için her iletişim kutusunda OK seçeneğine tıklayın.

    PowerShell betiği kullanın

    1. Bir betik dosyası oluşturun ve aşağıdaki içeriği içine yapıştırın.

      Örnek betik

      # 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. Betiği çalıştırın:

      # 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

    Yapılandırma dosyalarını kaldırın (isteğe bağlı)

    Alibaba Cloud CLI, yapılandırmayı kullanıcı ana dizininiz altındaki .aliyun dizininde saklar. Tüm CLI verilerini tamamen kaldırmak için bu dizini silin:

    • Linux/macOS: ~/.aliyun

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

    Sorun giderme

    aliyun komutu "command not found" hatası döndürüyor

    aliyun ikili dosyası PATH değişkeninizde değil veya yanlış kurulmuş.

    • Linux/macOS: which aliyun komutunu çalıştırın. Bir yol döndürülüyorsa ikili dosya mevcuttur ancak dizini PATH değişkeninde değildir. Yol döndürülmüyorsa ikili dosya kurulmamış demektir. Kurulum bölümündeki yöntemlerden birini kullanarak kurulumu tekrar deneyin.

    • Windows: Command Prompt'ta where aliyun komutunu çalıştırın. Bir yol döndürülüyorsa ikili dosya mevcuttur ancak dizini PATH değişkeninde değildir. Yol döndürülmüyorsa ikili dosya kurulmamış demektir. Kurulum bölümündeki yöntemlerden birini kullanarak kurulumu tekrar deneyin.

    İkili dosya bulunursa dizinini shell'iniz için PATH değişkenine ekleyin:

    • Bash: export PATH="$PATH:/your/install/dir" satırını ~/.bashrc dosyasına ekleyin, ardından source ~/.bashrc komutunu çalıştırın.

    • Zsh: Aynı satırı ~/.zshrc dosyasına ekleyin, ardından source ~/.zshrc komutunu çalıştırın.

    • Windows: Windows > ZIP paketi kullanın kurulum bölümündeki 3-8. adımları izleyerek kurulum dizinini Path ortam değişkenine ekleyin ve terminalinizi yeniden başlatın.

    aliyun version beklenenden farklı bir sürüm gösteriyor

    Sisteminizde birden fazla aliyun ikili dosyası olabilir. Shell'inizin hangi ikili dosyayı çözdüğünü kontrol etmek için which aliyun (Linux/macOS) veya where aliyun (Windows) komutunu çalıştırın. Eğer eski bir kuruluma işaret ediyorsa eski ikili dosyayı silin veya PATH dizinlerinizi yeni kurulumun öncelikli olması için yeniden sıralayın. Terminalinizi yeniden başlatın ve aliyun version komutunu tekrar çalıştırın.

    Kurulum "Permission denied" hatasıyla başarısız oluyor

    /usr/local/bin gibi sistem dizinleri yönetici ayrıcalıkları gerektirir. Linux ve macOS'ta komutun başına sudo ekleyin (örneğin, sudo mv ./aliyun /usr/local/bin/). Windows'ta PowerShell'i yönetici olarak çalıştırın.

    macOS'ta Homebrew kurulumu veya güncellemesi zaman aşımına uğruyor

    Bu durum genellikle GitHub CDN'sine yavaş ağ erişimi nedeniyle meydana gelir. Homebrew kurulumu bölümünde açıklandığı gibi USTC gibi yerel bir Homebrew yansısını yapılandırın. Yansı ayarlarını kalıcı hale getirmek için export satırlarını ~/.zshrc (veya ~/.bashrc) dosyasına ekleyin ve source ~/.zshrc komutunu çalıştırın.

    Windows'ta aliyun.exe dosyasına çift tıklamanın etkisi yok

    Alibaba Cloud CLI, grafiksel arayüzü olmayan bir komut satırı aracıdır. Command Prompt veya PowerShell'i açın, aliyun.exe dosyasını içeren dizine gidin (veya PATH değişkeninizde olduğundan emin olun) ve komutları buradan çalıştırın.