すべてのプロダクト
Search
ドキュメントセンター

Elastic Compute Service:クラウドアシスタントエージェントのインストール

最終更新日:Nov 28, 2025

コンソールまたは API を使用して、ログイン不要の管理、コマンドの実行、ファイル転送などの操作を行うには、対象の Elastic Compute Server (ECS) インスタンスにクラウドアシスタントエージェントをインストールして実行する必要があります。

注意事項

クラウドアシスタントエージェントは、次のオペレーティングシステム (OS) にインストールできます。

  • Linux:Alibaba Cloud Linux、AlmaLinux 8 以降、Anolis OS 7 以降、CentOS 5 以降、Debian 8 以降、Ubuntu 12 以降、RHEL 5 以降、SUSE 11 以降、Fedora 33 以降、CoreOS、OpenSUSE。

  • FreeBSD:11 以降。

  • Windows:Server 2012 以降。

2017 年 12 月 1 日以降にパブリックイメージから作成されたすべての ECS インスタンスには、クラウドアシスタントエージェントがプリインストールされています。

操作手順

コンソール

  1. ECS コンソール - クラウドアシスタントに移動します。

  2. 上部のナビゲーションバーで、対象リソースのリソースグループリージョンを選択します。

  3. [ECS インスタンス] タブをクリックして、現在のリージョンにある ECS インスタンスのクラウドアシスタントのステータスを確認します。

    • 正常:エージェントはインストールされています。

    • 未インストール[インストール] をクリックします。インストール後、インスタンスを再起動し、ステータスが [正常] に変わることを確認する必要があります。

      image.png

    • 異常:詳細については、「クラウドアシスタントの例外を処理する」をご参照ください。

Linux インスタンス

ステップ 1: インストール状況の確認

  1. Workbench を使用して Linux インスタンスにログインします。

  2. init システムのタイプを特定します。

    init システムは、起動時にサービスプロセスを読み込んで管理する仕組みです。使用する init システムによって、クラウドアシスタントエージェントの操作コマンドが異なります。
    • systemd:Alibaba Cloud Linux、CentOS 7 以降、RHEL 7 以降、Fedora 15 以降、Ubuntu 15.04 以降、Debian 8 以降など。

    • Upstart:Ubuntu 6.10~14.10、RHEL 6、CentOS 6 など。

    • SysVinit:RHEL 5、CentOS 5、Debian 6 など。

  3. エージェントがインストールされているかを確認します。

    systemd

    systemctl status aliyun.service

    出力に Unit aliyun.service could not be found が含まれている場合、エージェントはインストールされていません。

    upstart

    /sbin/initctl status aliyun-service

    出力に initctl: Unknown job: aliyun-service が含まれている場合、エージェントはインストールされていません。

    sysvinit

    /etc/init.d/aliyun-service status

    出力が空の場合、エージェントはインストールされていません。

ステップ 2: ダウンロードとインストール

このスクリプトは、デフォルトで最新バージョンのエージェントをインストールします。特定のバージョンをインストールするには、スクリプト内の VERSION=latest を変更してください。

#!/bin/bash

VERSION=latest
PACKAGE=
PKG_URI=

REGION=$(curl http://100.100.100.200/latest/meta-data/region-id)
DOMAIN=aliyun-client-assist-${REGION}.oss-${REGION}-internal.aliyuncs.com

arch=$(uname -m)
echo "[main] arch = ${arch}"
case $arch in
    "i386"|"i686"|"x86_64"|"amd64")
        if command -v rpm; then
            PACKAGE="aliyun_assist_${VERSION}.rpm"
        else
            PACKAGE="aliyun_assist_${VERSION}.deb"
        fi
        PKG_URI="https://$DOMAIN/linux/$PACKAGE"
        ;;
    *)
        if command -v rpm; then
            PACKAGE="aliyun-assist-${VERSION}-1.aarch64.rpm"
        else
            PACKAGE="aliyun-assist_${VERSION}-1_arm64.deb"
        fi
        PKG_URI="https://$DOMAIN/arm/$PACKAGE"
esac

if command -v wget; then
    sudo wget $PKG_URI
elif command -v curl; then
    curl -o $PACKAGE $PKG_URI
else
    echo "[WARN] command wget/curl not found, exit"
    exit 1;
fi;

if command -v rpm; then
    sudo rpm -ivh --force $PACKAGE
elif command -v dpkg; then
    sudo dpkg -i $PACKAGE
else
    echo "[WARN] command rpm/dpkg not found, exit"
    exit 2;
fi

if [[ -e /etc/redhat-release ]]; then
    if sudo systemctl status qemu-guest-agent; then
        sudo systemctl stop qemu-guest-agent
        sudo systemctl disable qemu-guest-agent
        sudo systemctl restart aliyun.service
    fi
fi

Windows インスタンス

ステップ 1: インストール状況の確認

  1. パスワードを使用して Windows インスタンスにログインします。

  2. クラウドアシスタントのサービスステータスを確認します。

    1. [スタート] メニューをクリックし、[コンピューターの管理] を検索します。

    2. [サービスとアプリケーション] > [サービス] を選択します。

    3. [Aliyun Assist Service] を探します。サービスが一覧にない場合、エージェントはインストールされていません。

      image

ステップ 2: ダウンロードとインストール

方法 1: ブラウザからダウンロード
  1. エージェントをダウンロードします。

    URL 内の {regionId} をインスタンスのリージョン ID に置き換え、ブラウザで開いてください。

    https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/windows/aliyun_agent_latest_setup.exe
    
    # 例: 中国 (杭州) リージョン (cn-hangzhou) のダウンロード URL
    https://aliyun-client-assist-cn-hangzhou.oss-cn-hangzhou-internal.aliyuncs.com/windows/aliyun_agent_latest_setup.exe
  2. エージェントをインストールします。

    エージェントファイルをダブルクリックし、ウィザードに従ってインストールします。デフォルトのインストールパスは C:\ProgramData\aliyun\assist\ です。

方法 2: PowerShell でインストール

スクリプト内の {regionId} をインスタンスのリージョン ID に置き換え、PowerShell でスクリプトを実行してください。

curl -UseBasicParsing -Uri https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/windows/aliyun_agent_latest_setup.exe -OutFile 'C:\\aliyun_agent_latest_setup.exe'
;"C:\\aliyun_agent_latest_setup.exe" '/S' 

API

このインストール手順は、すべての OS で共通です。

  1. DescribeCloudAssistantStatus API を呼び出して、対象の ECS インスタンスにクラウドアシスタントエージェントがインストールされているかを確認します。

    CloudAssistantStatus の戻り値が false の場合、エージェントはインストールされていません。

  2. エージェントがインストールされていない場合は、InstallCloudAssistant API を呼び出してインストールします。

  3. インストール完了後、RebootInstance API を呼び出して ECS インスタンスを再起動し、インストールを完了します。

CLI

Alibaba Cloud CLI を使用する場合、クラウドアシスタントエージェントのインストール手順はすべての OS で共通です。<YOUR-REGION-ID> を対象の ECS インスタンスのリージョン ID に、<YOUR-INSTANCE-ID> を対象のインスタンス ID に置き換えてください。

Red Hat Enterprise Linux (RHEL) は、Alibaba Cloud CLI によるインストールをサポートしていません。
  1. DescribeCloudAssistantStatus 操作を呼び出して、対象の ECS インスタンスにエージェントがインストールされているかを確認します。

    aliyun ecs DescribeCloudAssistantStatus --RegionId <YOUR-REGION-ID> --InstanceId.1 <YOUR-INSTANCE-ID> --output cols=CloudAssistantStatus rows=InstanceCloudAssistantStatusSet.InstanceCloudAssistantStatus[]

    コマンドが CloudAssistantStatus=true を返した場合、エージェントはすでにインストールされています。

  2. InstallCloudAssistant 操作を呼び出して、エージェントをインストールします。

    aliyun ecs InstallCloudAssistant --RegionId <YOUR-REGION-ID> --InstanceId.1 <YOUR-INSTANCE-ID>
  3. RebootInstance 操作を呼び出して、ECS インスタンスを再起動します。

    aliyun ecs RebootInstance --InstanceId <YOUR-INSTANCE-ID>

よくある質問

OS がエージェントをサポートしていない場合はどうすればよいですか?

OS がサポートされているのに、最新バージョンのエージェントをインストールできないのはなぜですか?

一部のカーネルでは、インストール可能なエージェントのバージョンが制限されています。

uname -r を実行して、カーネルバージョンを確認してください。

インスタンスのカーネルバージョン

インストール可能なエージェントの最新バージョン

Linux カーネルバージョン < 2.6.32

  • X86/X64 アーキテクチャ:2.2.3.398

  • ARM アーキテクチャ:2.4.3.398

FreeBSD カーネルバージョン < 12.x

2.3.3.529

FreeBSD OS にエージェントをインストールするにはどうすればよいですか?

  • Alibaba Cloud ECS インスタンスの場合

    #!/bin/sh
    
    VERSION=latest
    use_curl=0
    which curl >/dev/null 2>&1 && use_curl=1
    if [ $use_curl -eq 1 ];then
        REGION=$(curl http://100.100.100.200/latest/meta-data/region-id)
    else
        REGION=$(wget -O - http://100.100.100.200/latest/meta-data/region-id)
    fi
    DOMAIN=aliyun-client-assist-${REGION}.oss-${REGION}-internal.aliyuncs.com
    PACKAGE=aliyun_assist_${VERSION}.txz
    PKG_URI="https://$DOMAIN/freebsd/$PACKAGE"
    
    if [ $use_curl -eq 1 ];then
        curl -o $PACKAGE $PKG_URI
    else
        wget -O $PACKAGE $PKG_URI
    fi
    pkg install -U -y $PACKAGE
    service aliyun start
  • マネージドインスタンス (Alibaba Cloud 以外のサーバー) の場合

    #!/bin/sh
    
    VERSION=latest
    DOMAIN=aliyun-client-assist.oss-accelerate.aliyuncs.com
    PACKAGE=aliyun_assist_${VERSION}.txz
    PKG_URI="https://$DOMAIN/freebsd/$PACKAGE"
    
    use_curl=0
    which curl >/dev/null 2>&1 && use_curl=1
    if [ $use_curl -eq 1 ];then
        curl -o $PACKAGE $PKG_URI
    else
        wget -O $PACKAGE $PKG_URI
    fi
    pkg install -U -y $PACKAGE
    service aliyun start

マネージドインスタンス (Alibaba Cloud 以外のサーバー) にエージェントをインストールするにはどうすればよいですか?

Linux

このスクリプトは、デフォルトで最新バージョンのエージェントをインストールします。特定のバージョンをインストールするには、スクリプト内の VERSION=latest を変更してください。
#!/bin/bash

VERSION=latest
PACKAGE=
PKG_URI=

DOMAIN=aliyun-client-assist.oss-accelerate.aliyuncs.com

arch=$(uname -m)
echo "[main] arch = ${arch}"
case $arch in
    "i386"|"i686"|"x86_64"|"amd64")
        if command -v rpm; then
            PACKAGE="aliyun_assist_${VERSION}.rpm"
        else
            PACKAGE="aliyun_assist_${VERSION}.deb"
        fi
        PKG_URI="https://$DOMAIN/linux/$PACKAGE"
        ;;
    *)
        if command -v rpm; then
            PACKAGE="aliyun-assist-${VERSION}-1.aarch64.rpm"
        else
            PACKAGE="aliyun-assist_${VERSION}-1_arm64.deb"
        fi
        PKG_URI="https://$DOMAIN/arm/$PACKAGE"
esac

if command -v wget; then
    sudo wget $PKG_URI
elif command -v curl; then
    curl -o $PACKAGE $PKG_URI
else
    echo "[WARN] command wget/curl not found, exit"
    exit 1;
fi;

if command -v rpm; then
    sudo rpm -ivh --force $PACKAGE
elif command -v dpkg; then
    sudo dpkg -i $PACKAGE
else
    echo "[WARN] command rpm/dpkg not found, exit"
    exit 2;
fi

if [[ -e /etc/redhat-release ]]; then
    if sudo systemctl status qemu-guest-agent; then
        sudo systemctl stop qemu-guest-agent
        sudo systemctl disable qemu-guest-agent
        sudo systemctl restart aliyun.service
    fi
fi

Windows

方法 1: ブラウザからダウンロード
  1. ブラウザで次の URL を開き、エージェントをダウンロードします。

    https://aliyun-client-assist.oss-accelerate.aliyuncs.com/windows/aliyun_agent_latest_setup.exe
  2. エージェントをインストールします。

    エージェントファイルをダブルクリックし、ウィザードに従ってインストールします。デフォルトのインストールパスは C:\ProgramData\aliyun\assist\ です。

方法 2: PowerShell でインストール
curl -UseBasicParsing -Uri https://aliyun-client-assist.oss-accelerate.aliyuncs.com/windows/aliyun_agent_latest_setup.exe -OutFile 'C:\\aliyun_agent_latest_setup.exe'
;"C:\\aliyun_agent_latest_setup.exe" '/S' 

バイナリパッケージまたはソースコードからエージェントをインストールするにはどうすればよいですか?

バイナリパッケージからインストール

  • Alibaba Cloud ECS インスタンスの場合

    このスクリプトは、デフォルトで最新バージョンのエージェントをインストールします。特定のバージョンをインストールするには、スクリプト内の VERSION=latest を変更してください。
    #!/bin/bash
    
    VERSION=latest
    PACKAGE=
    PKG_URI=
    
    REGION=$(curl http://100.100.100.200/latest/meta-data/region-id)
    DOMAIN=aliyun-client-assist-${REGION}.oss-${REGION}-internal.aliyuncs.com
    
    arch=$(uname -m)
    echo "[main] arch = ${arch}"
    case $arch in
        "i386"|"i686"|"x86_64"|"amd64")
            PACKAGE="aliyun_assist_${VERSION}_update.zip"
            PKG_URI="https://$DOMAIN/linux/$PACKAGE"
            ;;
        *)
            PACKAGE="aliyun_assist_${VERSION}_update_arm.zip"
            PKG_URI="https://$DOMAIN/arm/$PACKAGE"
    esac
    
    if command -v wget; then
        sudo wget $PKG_URI
    elif command -v curl; then
        curl -o $PACKAGE $PKG_URI
    else
        echo "[WARN] command wget/curl not found, exit"
        exit 1
    fi;
    
    TARGET_DIR=/usr/local/share/aliyun-assist
    sudo unzip -o $PACKAGE -d $TARGET_DIR/
    TRUE_VERSION=$(cat $TARGET_DIR/version)
    sudo chmod a+x $TARGET_DIR/$TRUE_VERSION/update_install
    sudo bash $TARGET_DIR/$TRUE_VERSION/update_install
  • マネージドインスタンス (Alibaba Cloud 以外のサーバー) の場合

    #!/bin/bash
    
    VERSION=latest
    PACKAGE=
    PKG_URI=
    
    DOMAIN=aliyun-client-assist.oss-accelerate.aliyuncs.com
    
    arch=$(uname -m)
    echo "[main] arch = ${arch}"
    case $arch in
        "i386"|"i686"|"x86_64"|"amd64")
            PACKAGE="aliyun_assist_${VERSION}_update.zip"
            PKG_URI="https://$DOMAIN/linux/$PACKAGE"
            ;;
        *)
            PACKAGE="aliyun_assist_${VERSION}_update_arm.zip"
            PKG_URI="https://$DOMAIN/arm/$PACKAGE"
    esac
    
    if command -v wget; then
        sudo wget $PKG_URI
    elif command -v curl; then
        curl -o $PACKAGE $PKG_URI
    else
        echo "[WARN] command wget/curl not found, exit"
        exit 1
    fi;
    
    TARGET_DIR=/usr/local/share/aliyun-assist
    sudo unzip -o $PACKAGE -d $TARGET_DIR/
    TRUE_VERSION=$(cat $TARGET_DIR/version)
    sudo chmod a+x $TARGET_DIR/$TRUE_VERSION/update_install
    sudo bash $TARGET_DIR/$TRUE_VERSION/update_install

ソースコードからインストール

この例では、yum を使用します。他の Linux ディストリビューションを使用している場合は、対応するパッケージマネージャーを使用してください。

  1. Git と Go をインストールします。

    # Git をインストール
    sudo yum install git -y
    
    # Go をインストール
    sudo yum install go -y
  2. エージェントのソースコードをダウンロードします。

    sudo git clone https://github.com/aliyun/aliyun_assist_client
  3. ソースコードディレクトリに移動し、コードをコンパイルします。

    # ソースコードディレクトリに移動
    cd ./aliyun_assist_client
    
    # ソースコードをコンパイル
    sudo go build

    エラーが表示されなければ、インストールは成功です。

クラシックネットワークインスタンスにインストールした後、エージェントが動作しないのはなぜですか?

クラシックネットワーク内の ECS インスタンスではリージョン情報が自動取得されないため、設定ファイルを作成して手動でリージョンを設定する必要があります。

クラシックネットワークは、 Alibaba Cloud が提供していた旧世代のネットワークタイプであり、現在は購入できなくなっています。パフォーマンスとセキュリティを向上させるために、インスタンスを Virtual Private Cloud (VPC) に移行することを推奨します。

Linux

  1. エージェントのインストールディレクトリに、ECS インスタンスのリージョン ID を含む region-id という名前のファイルを作成します。

    たとえば、中国 (杭州) リージョンの場合、デフォルトのインストールディレクトリに region-id ファイルを作成します。

    • CoreOS:

      sudo sh -c 'echo "cn-hangzhou" > /opt/local/share/aliyun-assist/region-id'
    • その他の OS (Alibaba Cloud Linux、Ubuntu、Debian、RedHat、SUSE Linux Enterprise Server、OpenSUSE など):

      sudo sh -c 'echo "cn-hangzhou" > /usr/local/share/aliyun-assist/region-id'
  2. エージェントを実行します。

    aliyun-service -d

Windows

  1. エージェントのインストールディレクトリに、region-id という名前のファイルを作成します。.txt.conf などの拡張子は追加しないでください。

    Windows はデフォルトで既知のファイルタイプの拡張子を非表示にしています。region-id ファイルに余計な拡張子がないことを確認するために、ファイル拡張子を表示するように設定を変更してください。
  2. region-id ファイルに、ECS インスタンスのリージョン ID (例: cn-hangzhou) を入力します。

例:次の図は、Windows Server 2012 R2 インスタンスのデフォルトのインストールパス C:\ProgramData\aliyun\assist\ にある、cn-hangzhou リージョン用の region-id ファイルを示しています。在Windows上添加文件