全部產品
Search
文件中心

Elastic Compute Service:在ECS執行個體中安裝雲助手Agent

更新時間:Apr 26, 2025

2017年12月01日之後使用公用鏡像建立的ECS執行個體,已預設預裝雲助手Agent。如果您的執行個體是在2017年12月01日之前購買,或是通過自行上傳的自訂鏡像建立,或者是第三方雲端服務器,若要使用雲助手相關功能,則需為該ECS執行個體安裝雲助手Agent

注意事項

  • 請確認您的作業系統是否支援安裝雲助手。有關支援的作業系統資訊,請參見使用限制

    • 若作業系統支援雲助手,請參考本文自行安裝雲助手Agent

    • 若作業系統不支援安裝雲助手,您可以選擇更換或升級作業系統,最新的公用鏡像預設安裝了雲助手Agent,更多詳情請參見更換作業系統(更換系統硬碟)

  • 部分核心在安裝雲助手時存在最高可安裝版本的限制。

    執行個體的核心版本號碼

    雲助手Agent可升級的最高版本

    Linux核心版本號碼小於2.6.32

    • X86/X64架構:2.2.3.398

    • ARM架構:2.4.3.398

    FreeBSD 11及以下(核心版本號碼小於12.x)

    2.3.3.529

  • 在使用雲助手支援的某項功能時,該功能對雲助手的版本存在一定的要求。具體資訊,請參見支援功能及版本

  • 若您想要將第三方雲端服務器註冊為阿里雲受管理的執行個體,請參見阿里雲受管理的執行個體

通過程式包方式安裝

Windows系統安裝步驟

  1. 以管理員帳號遠端連線ECS執行個體。

  2. 下載雲助手Agent

    雲助手Agent下載地址:

    • 公網地址(最新版本):下載地址

    • 內網地址(最新版本):

      https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/windows/aliyun_agent_latest_setup.exe

      其中{regionId}為您執行個體所在的地區的Region ID。例如在杭州內網下載最新版本,則對應地址如下所示。

      https://aliyun-client-assist-cn-hangzhou.oss-cn-hangzhou-internal.aliyuncs.com/windows/aliyun_agent_latest_setup.exe
  3. 雙擊雲助手Agent檔案,根據安裝嚮導完成安裝。

    如果您選擇預設安裝路徑,雲助手Agent在Windows執行個體中的安裝目錄為C:\ProgramData\aliyun\assist\

    您也可以將上述下載和安裝的步驟整合成powershell指令碼,以下指令碼以內網最新版本地址為例,使用時請將{regionId}替換為您執行個體所在的地區的Region ID。

    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' 
  4. (可選)如果ECS執行個體的網路類型為傳統網路,需要執行以下操作。

    1. 在雲助手的安裝目錄下,建立名為region-id的檔案(不要添加類似.txt.conf的副檔名)。

      重要

      Windows系統會隱藏已知檔案類型的副檔名,您必須設定顯示已知檔案類型的副檔名才能真正判斷region-id是否帶有副檔名。

    2. region-id檔案中填入ECS執行個體所屬地區的ID,例如cn-hangzhou

      說明

      您可以在ECS控制台上的執行個體詳情頁面基本資料地區查看ECS執行個體所屬地區,然後在地區和可用性區域中查看對應的地區ID。

    以Windows Server 2012 R2為例,在雲助手預設安裝路徑C:\ProgramData\aliyun\assist\下建立的region-id檔案及填入cn-hangzhou地區ID的樣本結果如下:在Windows上添加檔案

Linux系統安裝步驟

RPM和DEB包管理方式

適合Alibaba Cloud Linux、CentOS、RHEL、SUSE Linux、Debian和Ubuntu等作業系統。

  1. 以sudo許可權的使用者遠端連線ECS執行個體。

  2. 執行如下指令碼,完成雲助手安裝包的下載與安裝。

    重要

    以下指令碼會預設安裝最新版本的Agent,如果受核心版本影響只能安裝指定版本時,請將指令碼中 VERSION=latest修改為指定的版本號碼,例如 VERSION=2.2.3.398

    內網下載安裝指令碼

    推薦,適用於ECS執行個體,預設可以通過內網下載。

    #!/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
    

    公網下載安裝指令碼

    適用於非阿里雲主機以及可出公網的ECS執行個體。

    #!/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

FreeBSD

  1. 以sudo許可權的使用者遠端連線ECS執行個體。

  2. 執行如下指令碼,完成雲助手安裝包的下載與安裝。

    重要

    以下指令碼會預設安裝最新版本的Agent,如果受核心版本影響只能安裝指定版本時,請將指令碼中 VERSION=latest修改為指定的版本號碼,例如 VERSION=2.3.3.529

    內網下載安裝指令碼

    推薦,適用於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

    公網下載安裝指令碼

    適用於非阿里雲主機以及可出公網的ECS執行個體。

    #!/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

Binary安裝方式

適合主流Linux作業系統。

  1. 以sudo許可權的使用者遠端連線ECS執行個體。

  2. 執行如下指令碼,完成雲助手安裝包的下載與安裝。

    重要

    以下指令碼會預設安裝最新版本的Agent,如果受核心版本影響只能安裝指定版本時,請將指令碼中 VERSION=latest修改為指定的版本號碼,例如 VERSION=2.2.3.398

    內網下載安裝指令碼

    推薦,適用於ECS執行個體,預設可以通過內網下載。

    #!/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
    

    公網下載安裝指令碼

    適用於非阿里雲主機以及可出公網的ECS執行個體。

    #!/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
    

原始碼安裝方式

  1. 以sudo許可權的使用者遠端連線ECS執行個體。

  2. 安裝Git和Go等必要的軟體。

    此樣本通過yum安裝,如果您使用其他Linux版本,請修改為對應的包管理工具。

    • 安裝Git:

      sudo yum install git -y
    • 安裝Go:

      sudo yum install go -y
  3. 下載雲助手Agent源碼。

    sudo git clone https://github.com/aliyun/aliyun_assist_client
  4. 進入源碼存放目錄。

    cd ./aliyun_assist_client
  5. 編譯源碼。

    sudo go build

    如果返回結果無報錯資訊,表示安裝成功。

  6. 如果ECS執行個體的網路類型為傳統網路,執行以下操作。

    在雲助手的安裝目錄下,建立名為region-id的檔案,並在region-id檔案中填入ECS執行個體所屬地區的ID。以雲助手預設安裝路徑為例,建立region-id檔案並添加cn-hangzhou地區ID的命令如下:

    • CoreOS作業系統:

      sudo sh -c 'echo "cn-hangzhou" > /opt/local/share/aliyun-assist/region-id'
    • 其他動作系統(Alibaba Cloud Linux、Ubuntu、Debian、RedHat、SUSE Linux Enterprise Server和OpenSUSE等):

      sudo sh -c 'echo "cn-hangzhou" > /usr/local/share/aliyun-assist/region-id'

    以其他動作系統(Alibaba Cloud Linux、Ubuntu、Debian、RedHat、SUSE Linux Enterprise Server和OpenSUSE等)為例,回顯如下:建立檔案

  7. 運行雲助手Agent

    aliyun-service -d

通過OpenAPI方式安裝

您還可以通過調用阿里雲的OpenAPI,觸發安裝任務。該安裝方式不區分作業系統類型。

API的調用流程如下:

  1. 調用DescribeCloudAssistantStatus查詢目標ECS執行個體是否安裝了雲助手Agent

  2. 若執行個體並未安裝雲助手Agent,則調用InstallCloudAssistant安裝雲助手Agent

  3. 安裝完成之後,調用RebootInstance重啟ECS執行個體。

說明

通過OpenAPI方式安裝時,需配置身份憑據(如AccessKey)資訊。有關如何擷取AccessKey,請參見建立AccessKey

接下來,我們以通過CLI方式調用API為例,講解安裝過程。

通過阿里雲CLI安裝用戶端,可免除遠端連線執行個體的步驟,請確保您已經為本地用戶端安裝了阿里雲CLI,在不同作業系統中安裝CLI的方式如下:

說明

RHEL不支援通過阿里雲CLI安裝。

  1. 調用DescribeCloudAssistantStatus查詢目標ECS執行個體是否安裝了雲助手Agent

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

    請替換命令中的<YOUR-REGION-ID>為您ECS執行個體所在地區,<YOUR-INSTANCE-ID>為您ECS執行個體ID。當查詢多個ECS執行個體是否安裝雲助手Agent時,請在命令中增加--InstanceId.2 <YOUR-INSTANCE-ID> --InstanceId.3 <YOUR-INSTANCE-ID> ... --InstanceId.N <YOUR-INSTANCE-ID>

    返回CloudAssistantStatus=true時,表示ECS執行個體已安裝雲助手Agent。否則,請繼續下一步。

  2. 調用InstallCloudAssistant安裝雲助手Agent

    aliyun ecs InstallCloudAssistant --RegionId <YOUR-REGION-ID> --InstanceId.1 <YOUR-INSTANCE-ID>
    說明

    請替換命令中的<YOUR-REGION-ID>為您ECS執行個體所在地區,<YOUR-INSTANCE-ID>為您ECS執行個體ID。當為多個ECS執行個體安裝雲助手Agent時,請在命令中增加--InstanceId.2 <YOUR-INSTANCE-ID> --InstanceId.3 <YOUR-INSTANCE-ID> ... --InstanceId.N <YOUR-INSTANCE-ID>

  3. 調用RebootInstance重啟ECS執行個體。

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

    請替換命令中的<YOUR-INSTANCE-ID>為您ECS執行個體ID。

  4. 如果ECS執行個體的網路類型為傳統網路,在執行個體內部添加所屬地區聲明。

    1. 以root/system許可權遠端連線ECS執行個體。

      具體操作,請參見ECS遠端連線方式概述

    2. 查看雲助手版本。

      如果雲助手Agent版本高於1.0.1.400,雲助手Agent安裝成功;否則,繼續下一步操作。

    3. 建立region-id檔案並填入ECS執行個體所屬地區的ID。

      Linux

      在雲助手的安裝目錄下,建立名為region-id的檔案,並在region-id檔案中填入ECS執行個體所屬地區的ID。以雲助手預設安裝路徑為例,建立region-id檔案並添加cn-hangzhou地區ID的命令如下:

      • CoreOS作業系統:

        sudo sh -c 'echo "cn-hangzhou" > /opt/local/share/aliyun-assist/region-id'
      • 其他動作系統(Alibaba Cloud Linux、Ubuntu、Debian、RedHat、SUSE Linux Enterprise Server和OpenSUSE等):

        sudo sh -c 'echo "cn-hangzhou" > /usr/local/share/aliyun-assist/region-id'

      以其他動作系統(Alibaba Cloud Linux、Ubuntu、Debian、RedHat、SUSE Linux Enterprise Server和OpenSUSE等)為例,回顯如下:建立檔案

      Windows

      1. 在雲助手的安裝目錄下,建立名為region-id的檔案(不要添加類似.txt.conf的副檔名)。

        重要

        Windows系統會隱藏已知檔案類型的副檔名,您必須設定顯示已知檔案類型的副檔名才能真正判斷region-id是否帶有副檔名。

      2. region-id檔案中填入ECS執行個體所屬地區的ID,例如cn-hangzhou

        說明

        您可以在ECS控制台上的執行個體詳情頁面基本資料地區查看ECS執行個體所屬地區,然後在地區和可用性區域中查看對應的地區ID。

      以Windows Server 2012 R2為例,在雲助手預設安裝路徑C:\ProgramData\aliyun\assist\下建立的region-id檔案及填入cn-hangzhou地區ID的樣本結果如下:在Windows上添加檔案

查看ECS執行個體的雲助手Agent資訊

通過控制台查看

您安裝好雲助手Agent後,可以在控制台通過以下步驟查看ECS執行個體的雲助手Agent版本號碼、狀態等資訊。

  1. 訪問ECS控制台-雲助手

  2. 在頁面左側頂部,選擇目標資源所在的資源群組和地區。地區

  3. 單擊ECS執行個體頁簽,查看當前地區ECS執行個體上的雲助手Agent資訊。

    查詢結果

通過API查看

您也可調用DescribeCloudAssistantStatus查詢目標ECS執行個體是否安裝了雲助手Agent

登入執行個體查看

Linux

  1. 遠端連線ECS執行個體。具體操作,請參見使用Workbench工具以SSH協議登入Linux執行個體

  2. 查看雲助手服務狀態。

    確定ECS執行個體的初始化系統,依據該初始化系統選擇相應的命令查看雲助手服務狀態。

    ls -l /sbin/init
    • 如果輸出指向/lib/systemd/systemd,執行如下命令查看雲助手狀態。

      systemctl status aliyun.service

      當雲助手狀態為active (running),說明雲助手服務正常運行中。

    • 如果輸出指向/sbin/upstart,執行如下命令查看雲助手狀態。

      /sbin/initctl status aliyun-service

      當雲助手狀態為start/running,說明雲助手服務正常運行中。

    • 如果輸出指向/sbin/init,執行如下命令查看雲助手狀態。

      /etc/init.d/aliyun-service status

      當雲助手狀態為Running,說明雲助手服務正常運行中。

  3. 查看雲助手的版本。

    • rpm包管理:

      sudo rpm -qa | grep aliyun_assist
    • deb包管理:

      sudo dpkg -l | grep aliyun-assist

Windows

  1. 遠端連線ECS執行個體,具體操作,請參見通過密碼認證登入Windows執行個體

  2. 查看雲助手服務狀態。

    1. 單擊開始菜單,搜尋電腦管理

    2. 選擇服務和應用程式 > 服務

    3. 找到Aliyun Assist Service,查看Aliyun Assist Service狀態。如果狀態為正在運行,說明雲助手服務正常運行中。

      image

  3. 查看雲助手的版本。

    雙擊Aliyun Assist Service,在快顯視窗中找到可執行檔的路徑,在路徑中可以查看雲助手的版本。

    image

    例如可執行檔的路徑為C:\ProgramData\aliyun\assist\2.1.3.857\aliyun_assist_service.exe,其中2.1.3.857為雲助手的版本。