本トピックでは、Linux、macOS、Windows に Alibaba Cloud CLI をインストール、確認、更新、アンインストールする方法について説明します。
バージョン情報
Alibaba Cloud CLI は定期的に新しいバージョンをリリースします。最適なエクスペリエンスを得るために、常に最新バージョンを使用することをお勧めします。現在のバージョンは、aliyun version を実行して確認できます。最新バージョンとリリースノートについては、GitHub Releases ページをご覧ください。
バージョン 3.3.0 未満はサポート終了 (EOL) となり、機能の更新やセキュリティ修正は提供されなくなりました。お使いのバージョンが 3.3.0 未満の場合は、移行ガイド を参照してアップグレードしてください。
前提条件
Alibaba Cloud アカウントを持っていること。
(任意)
curlコマンドラインツール。ほとんどの macOS および Linux ディストリビューションには標準で含まれています。パッケージマネージャーまたはグラフィカルインストーラーを使用してインストールする場合は、この要件を省略できます。
サポートされているオペレーティングシステム
オペレーティングシステム | サポートされているバージョン | サポートされているアーキテクチャ |
Linux | CentOS 8 以降、RHEL 8 以降、Ubuntu 16.04 以降、Debian 9 以降、およびその他の主要なディストリビューション。CentOS 7 は EOL を迎えているため、推奨されません。 | x86_64 (64 ビット)、ARM64 |
macOS | macOS 11 (Big Sur) 以降 | Intel および Apple シリコン (ユニバーサルバイナリ) |
Windows | Windows 10 以降 (64 ビット) | x86_64 のみ。32 ビットおよび ARM64 はサポートされていません。 |
Alibaba Cloud CLI のインストール
お使いのオペレーティングシステムを選択し、インストール方法を選択してください。
Linux
Bash スクリプトを使用すると、1 つのコマンドで迅速にインストールできます。エアギャップ環境やインストールパスをカスタマイズする場合は、.tar.gz パッケージを使用してください。
Bash スクリプトの使用 (推奨)
このスクリプトは、お使いのシステムアーキテクチャを検出し、適切なパッケージをダウンロードし、aliyun バイナリを /usr/local/bin/ に配置します。
最新バージョンをインストールする
/bin/bash -c "$(curl -fsSL https://aliyuncli.alicdn.com/install.sh)"特定のバージョンをインストールする
バージョンを指定するには、
-Vフラグを使用します。利用可能なバージョンについては、GitHub リリース をご確認ください。/bin/bash -c "$(curl -fsSL https://aliyuncli.alicdn.com/install.sh)" -- -V 3.3.18
.tar.gz パッケージの使用
お使いのシステムアーキテクチャに合ったパッケージをダウンロードします。
説明uname -mを実行すると、アーキテクチャを確認できます。arm64またはaarch64は ARM64 を示し、その他の出力は x86_64 を示します。x86_64 (64 ビット):
curl https://aliyuncli.alicdn.com/aliyun-cli-linux-latest-amd64.tgz -o aliyun-cli-linux-latest.tgzARM64:
curl https://aliyuncli.alicdn.com/aliyun-cli-linux-latest-arm64.tgz -o aliyun-cli-linux-latest.tgz特定のバージョンをダウンロードするには、GitHub Releases ページにアクセスしてください。パッケージ名は
aliyun-cli-linux-<version>-<arch>.tgzという形式です。ここで、<arch>はamd64またはarm64です。
パッケージを解凍します。
tar xzvf aliyun-cli-linux-latest.tgzバイナリを PATH に含まれるディレクトリに移動してください。
sudo mv ./aliyun /usr/local/bin/
macOS
Homebrew の使用 (推奨)
続行する前に Homebrew をインストールしておく必要があります。
最新バージョンをインストールします:
brew install aliyun-climacOS インストーラー (.pkg) の使用
インストーラーをダウンロードします。
最新バージョン: https://aliyuncli.alicdn.com/aliyun-cli-latest.pkg からダウンロードします。
特定のバージョン: GitHub Releases ページにアクセスします。インストーラー名は
aliyun-cli-<version>.pkgという形式です。
ダウンロードした
.pkgファイルをダブルクリックして、画面の指示に従ってください。説明macOS がセキュリティ警告でインストーラーをブロックした場合は、[System Settings] > [Privacy & Security] を開き、[Open Anyway] をクリックして続行してください。
Bash スクリプトの使用
このスクリプトは macOS を検出し、ユニバーサルバイナリを自動的にダウンロードします。コマンドは Linux と同じです。
最新バージョンをインストールする
/bin/bash -c "$(curl -fsSL https://aliyuncli.alicdn.com/install.sh)"特定のバージョンをインストールする
利用可能なバージョンについては、GitHub Releases をご確認ください。
/bin/bash -c "$(curl -fsSL https://aliyuncli.alicdn.com/install.sh)" -- -V 3.3.18
.tar.gz パッケージの使用
パッケージをダウンロードします。
最新バージョン:
curl https://aliyuncli.alicdn.com/aliyun-cli-macosx-latest-universal.tgz -o aliyun-cli-macosx-latest-universal.tgz特定のバージョン: GitHub Releases ページをご覧ください。パッケージ名は
aliyun-cli-macosx-<version>-universal.tgzという形式です。
パッケージを解凍します。
tar xzvf aliyun-cli-macosx-latest-universal.tgzバイナリを PATH に含まれるディレクトリに移動してください。
sudo mv ./aliyun /usr/local/bin
Windows
Alibaba Cloud CLI は x86_64 (64 ビット) の Windows システムのみをサポートしています。32 ビットおよび ARM64 システムはサポートされていません。
手動での迅速なインストールには ZIP パッケージを、自動インストールには PowerShell スクリプトを使用します。
ZIP パッケージの使用
パッケージをダウンロードします。
最新バージョン: https://aliyuncli.alicdn.com/aliyun-cli-windows-latest-amd64.zip からダウンロードします。
特定のバージョン: GitHub Releases ページにアクセスしてください。 パッケージ名は
aliyun-cli-windows-<version>-amd64.zipの形式です。
aliyun.exeを任意のディレクトリに展開します。たとえば、C:\AliyunCLIです。説明aliyun.exeはコマンドラインツールです。ダブルクリックしても効果はありません。ターミナル (コマンドプロンプトまたは PowerShell) から実行してください。[Windows] + [S] キーを押し、「[environment variables]」を検索してください。
[Edit the environment variables for your account] をクリックしてください。
[ユーザー変数] で
Pathを選択し、[編集] をクリックします。
[新規] をクリックし、ディレクトリパス (例:
C:\AliyunCLI) を入力します。
各ダイアログで [OK] をクリックして保存してください。
変更を有効にするために、ターミナルを再起動してください。
PowerShell スクリプトの使用
Install-CLI-Windows.ps1という名前のファイルを作成し、次のスクリプトを貼り付けます。スクリプトを実行して Alibaba Cloud CLI をインストールします。
説明スクリプトパスの例は
C:\Example\Install-CLI-Windows.ps1です。実際のスクリプトパスに置き換えてください。最新バージョンをインストールします。デフォルトのインストールパスは
C:\Users\<USERNAME>\AppData\Local\AliyunCLIです。powershell.exe -ExecutionPolicy Bypass -File C:\Example\Install-CLI-Windows.ps1バージョン (GitHub Releases から) とインストールディレクトリを指定します。
powershell.exe -ExecutionPolicy Bypass -File C:\Example\Install-CLI-Windows.ps1 -Version 3.3.18 -InstallDir "C:\ExampleDir\AliyunCLI"
インストールの確認
新しいターミナルを開き、以下を実行してください:
aliyun version3.3.18 のようなバージョン番号が表示されれば、インストールは成功です。
CLI が正しく動作するかをさらに確認するには、以下を実行してください:
aliyun configure list認証情報プロファイルの一覧が表示されます。設定がない場合は、空のリストが表示されます。
command not foundが返された場合は、トラブルシューティングをご参照ください。
インストール後、アクセス認証情報を設定して Alibaba Cloud CLI の使用を開始してください:
クイックスタート:認証情報を設定し、最初のコマンドを実行します。
認証情報の設定と管理:アクセスキー、RAM ロール、またはその他の ID タイプを設定します。
Alibaba Cloud CLI の更新
aliyun version を実行して現在のバージョンを確認し、適切なアップグレードパスに従ってください。
インストール方法の特定
CLI がどのようにインストールされたかわからない場合は、バイナリの場所を特定してください:
Linux/macOS:
which aliyunを実行します。パスに
/homebrew/または/linuxbrew/が含まれる場合 → Homebrew。パスが
/usr/local/bin/aliyunの場合は、Bash スクリプトまたは .tar.gz パッケージです。その他のパス → .tar.gz パッケージを使用したカスタムディレクトリへのインストール。
Windows: コマンド プロンプトで
where aliyun.exeを実行します。パスは
%LOCALAPPDATA%\AliyunCLI\aliyun.exe→ PowerShell スクリプト (デフォルトパス) です。その他のパス → ZIP パッケージを使用したカスタムディレクトリへのインストール。
バージョンの確認
aliyun version を実行して現在のバージョンを確認し、適切なアップグレードパスに従ってください:
バージョン 3.3.5 以降:
aliyun upgrade(推奨) を使用するか、再インストールします。バージョン 3.3.0 ~ 3.3.4: 再インストールして更新します。バージョン 3.3.5 以降は、今後の更新には
aliyun upgradeを使用してください。バージョン 3.3.0 未満: まず移行ガイドを参照してアップグレードしてください。
aliyun upgrade の使用 (推奨)
バージョン 3.3.5 以降で利用可能です。このコマンドは最新バージョンをダウンロードしてインストールします。
最新バージョンに更新する:
aliyun upgrade確認プロンプトをスキップするには:
aliyun upgrade --yes
Homebrew でインストールした場合、aliyun upgrade は適用されません。brew upgrade aliyun-cli を使用してください。
再インストールによる更新
元のインストール方法に合った方法を選択してください:
Bash スクリプト (Linux/macOS): インストールスクリプトを再実行して最新バージョンに更新してください。
/bin/bash -c "$(curl -fsSL https://aliyuncli.alicdn.com/install.sh)"Homebrew (macOS):
brew update && brew upgrade aliyun-cli && brew cleanup aliyun-climacOS インストーラー (.pkg) / ZIP パッケージ (Windows):
.tar.gz パッケージ (Linux/macOS): 最新のパッケージをダウンロードし、解凍して、元のインストールと同じディレクトリにバイナリを移動してください。
PowerShell スクリプト (Windows): 同じパラメーターでスクリプトを再実行します。特定のバージョンをインストールするには、
-Version <version>を追加します。powershell.exe -ExecutionPolicy Bypass -File <script_path> [-InstallDir <install_path>]説明特定のバージョンに更新するには、
-Version <version>を追加します。省略すると、最新のリリースがインストールされます。利用可能なバージョンについては、GitHub リリース をご参照ください。
注意事項
カスタムインストールディレクトリを使用した場合は、更新時に同じディレクトリを指定してください。
インストール方法を切り替えたり、インストールディレクトリを変更したりする必要がある場合は、まず完全にアンインストールしてから再インストールしてください。
更新の確認
更新が成功したことを確認してください:
aliyun versionAlibaba Cloud CLI のアンインストール
Linux
コマンドラインの使用
バイナリを見つけて削除してください:
sudo rm -v "$(which aliyun)"カスタムディレクトリにインストールして PATH に追加した場合は、シェル設定ファイル (Bash の場合は
~/.bashrc、Zsh の場合は~/.zshrc) からそのエントリを削除し、再読み込みしてください:source ~/.bashrc説明デフォルトシェルが Zsh の場合は、
~/.bashrcを~/.zshrcと読み替えてください。
Bash スクリプトの使用
スクリプトファイルを作成し、次の内容を貼り付けます。
スクリプトを実行してください:
# 実行可能ファイルのみをアンインストールします bash <script_path> # 実行可能ファイルをアンインストールし、設定ファイルを削除します bash <script_path> -C # スクリプトのヘルプを表示します bash <script_path> -h
macOS
Homebrew の使用
Alibaba Cloud CLI をアンインストールしてください:
brew uninstall aliyun-cliコマンドラインの使用
aliyunバイナリを削除します:BINARY=$(which aliyun 2>/dev/null) && [ -n "$BINARY" ] && sudo rm -v "$BINARY"カスタムディレクトリにインストールし、PATH に追加した場合は、
~/.zshrc(または~/.bashrc) からそのエントリを削除し、再読み込みします。source ~/.zshrc説明Bash を使用している場合は、
~/.zshrcを~/.bashrcに置き換えてください。
Windows
ファイルエクスプローラーの使用
インストールディレクトリに移動し、
aliyun.exeを削除します。[Windows] + [S] キーを押し、「[environment variables]」を検索してください。
[Edit the environment variables for your account] をクリックしてください。
[ユーザー変数] で、
Pathを選択し、[編集] をクリックします。
Alibaba Cloud CLI のディレクトリのエントリを選択し、[Delete] をクリックしてください。

各ダイアログで [OK] をクリックして保存してください。
PowerShell スクリプトの使用
スクリプトファイルを作成し、次の内容を貼り付けてください。
スクリプトを実行してください:
# 実行可能ファイルのみをアンインストールします powershell.exe -ExecutionPolicy Bypass -File <script_path> # 実行可能ファイルをアンインストールし、設定ファイルを削除します powershell.exe -ExecutionPolicy Bypass -File <script_path> -Clean # スクリプトのヘルプを表示します powershell.exe -ExecutionPolicy Bypass -File <script_path> -Help
設定ファイルの削除 (任意)
Alibaba Cloud CLI は、ユーザーホームディレクトリ配下の .aliyun ディレクトリに設定を保存します。すべての CLI データを完全に削除するには、このディレクトリを削除します:
Linux/macOS:
~/.aliyunWindows:
C:\Users\<USERNAME>\.aliyun
トラブルシューティング
aliyun コマンドが "command not found" を返す
aliyun バイナリが PATH に含まれていないか、正しくインストールされていません。
Linux/macOS:
which aliyunを実行します。パスが返された場合、バイナリは存在しますが、そのディレクトリはPATHに含まれていません。パスが返されない場合、バイナリはインストールされていません。インストールセクションのいずれかの方法でインストールを再試行してください。Windows:コマンドプロンプトで
where aliyunを実行してください。パスが返された場合、バイナリは存在しますが、そのディレクトリはPATHに含まれていません。パスが返されない場合、バイナリはインストールされていません。インストールセクションに記載のいずれかの方法を使用して、インストールを再試行してください。
バイナリが見つかった場合は、そのディレクトリをお使いのシェルの PATH に追加してください:
Bash:
~/.bashrcにexport PATH="$PATH:/your/install/dir"を追加し、その後source ~/.bashrcを実行します。Zsh:
~/.zshrcに同じ行を追加し、次にsource ~/.zshrcを実行します。Windows: 「Windows > ZIP パッケージを使用したインストール」セクションの手順 3~8 に従い、インストールディレクトリを
Path環境変数に追加してから、ターミナルを再起動します。
aliyun version が想定と異なるバージョンを表示する
システムに複数の aliyun バイナリが存在する可能性があります。which aliyun (Linux/macOS) または where aliyun (Windows) を実行して、シェルによってどのバイナリが参照されているかを確認します。古いインストールを参照している場合は、古いバイナリを削除するか、PATH ディレクトリの順序を変更して、新しいインストールが優先されるようにします。ターミナルを再起動し、再度 aliyun version を実行します。
インストールが "Permission denied" で失敗する
/usr/local/bin などのシステムディレクトリには、管理者権限が必要です。Linux および macOS では、コマンドの前に sudo を付けます (例: sudo mv ./aliyun /usr/local/bin/)。Windows では、PowerShell を管理者として実行します。
macOS で Homebrew のインストールまたは更新がタイムアウトする
これは通常、GitHub CDN へのネットワークアクセスが遅いために発生します。Homebrew のインストールセクションで説明されているように、USTC などの国内の Homebrew ミラーを設定します。ミラー設定を永続化するには、export 行を ~/.zshrc (または ~/.bashrc) に追加し、source ~/.zshrc を実行します。
Windows で aliyun.exe をダブルクリックしても反応がない
Alibaba Cloud CLI は、グラフィカルインターフェイスを持たないコマンドラインツールです。コマンドプロンプトまたは PowerShell を開き、aliyun.exe を含むディレクトリに移動するか、PATH にパスが通っていることを確認してから、コマンドを実行します。