全部產品
Search

搜尋本產品

    Elastic Compute Service：升級、禁止自動升級雲助手Agent

    文件中心

    Elastic Compute Service：升級、禁止自動升級雲助手Agent

    更新時間：Jan 23, 2026

    雲助手支援的功能取決於所使用的雲助手版本，若目前的版本的雲助手不支援某一功能，您可能需要升級雲助手Agent，本文介紹如何升級、禁止自動升級雲助手Agent。

    使用限制

    • 需要升級雲助手Agent的ECS執行個體處於運行中狀態。

    • 請確認您已安裝雲助手Agent。具體操作，請參見安裝雲助手Agent。

    自動升級

    重要

    在墨西哥、西北2（中衛）地區，當執行個體的雲助手版本低於以下對應的版本時，雲助手不支援自動升級，需要調用InstallCloudAssistant介面安裝最新版雲助手，或手動安裝雲助手Agent以使用較新特性。

    • Linux：2.2.3.515

    • Windows：2.1.3.515

    雲助手Agent預設每隔30分鐘會自動運行升級程式aliyun_assist_update，該程式所在路徑為：

    • Windows執行個體：C:\ProgramData\aliyun\assist\{VERSION}\aliyun_assist_update.exe

    • Linux執行個體：/usr/local/share/aliyun-assist/{VERSION}/aliyun_assist_update

    說明

    {VERSION}為雲助手Agent的具體版本號碼，查看版本號碼的步驟請參見安裝雲助手Agent。

    您可以配置雲助手Agent的自動升級策略，控制允許升級的時間段，規避在業務高峰期Agent升級的影響。

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

    2. 在雲助手頁面右上方，單擊設定。

      image

    3. 在彈出的雲助手設定對話方塊中，單擊雲助手Agent升級設定頁簽。

    4. 選中雲助手Agent升級設定複選框，設定允許升級的時間段和時區，然後單擊確定。

      說明

      最多可輸入5組時間段，且每組時間段的間隔不能短於1小時。

      image

    禁止自動升級

    • 禁止指定版本雲助手的自動升級：建立設定檔禁止自動升級或重新命名自動升級程式。

    • 禁止所有版本雲助手的自動升級：建立設定檔禁止自動升級。

    重新命名自動升級程式

    通過重新命名aliyun_assist_update檔案，禁止自動升級雲助手Agent。

    說明

    VERSION為雲助手Agent的具體版本號碼，查看版本號碼的步驟請參見安裝雲助手Agent。

    • Windows Server系統：在PowerShell中運行以下命令，將自動升級程式aliyun_assist_update重新命名為aliyun_assist_update.bk。

      Rename-Item -Path 'C:\ProgramData\aliyun\assist\VERSION\aliyun_assist_update.exe' -NewName 'C:\ProgramData\aliyun\assist\VERSION\aliyun_assist_update.exe.bk'

    • Linux系統：執行以下命令，將自動升級程式aliyun_assist_update重新命名為aliyun_assist_update.bk。

      mv /usr/local/share/aliyun-assist/VERSION/aliyun_assist_update /usr/local/share/aliyun-assist/VERSION/aliyun_assist_update.bk

    如果您想恢複自動升級，請將檔案名稱改回aliyun_assist_update。

    • Windows Server系統：

      Rename-Item -Path 'C:\ProgramData\aliyun\assist\VERSION\aliyun_assist_update.exe.bk' -NewName 'C:\ProgramData\aliyun\assist\VERSION\aliyun_assist_update.exe'

    • Linux系統：

      mv /usr/local/share/aliyun-assist/VERSION/aliyun_assist_update.bk /usr/local/share/aliyun-assist/VERSION/aliyun_assist_update

    建立設定檔禁止自動升級

    對於Linux作業系統下版本號碼不低於2.2.1.140的雲助手Agent和Windows作業系統下版本號碼不低於2.1.1.140的雲助手Agent，您可以通過雲助手Agent在指定路徑下建立設定檔來禁止升級雲助手Agent：

    步驟一：禁止雲助手Agent啟動時檢查升級

    在雲助手Agent安裝目錄內的config目錄下建立檔案disable_bootstrap_update即可禁用目前的版本的雲助手Agent啟動時檢查升級，在跨版本目錄內的config目錄下建立該檔案可禁用本機上所有版本的雲助手Agent啟動時檢查升級。disable_bootstrap_update檔案不需要寫入任何內容。

    • Windows Server系統：在PowerShell中運行以下命令。

      # 例如執行以下命令將會禁止指定版本號碼的雲助手Agent啟動時的檢查升級
New-Item -Path 'C:\ProgramData\aliyun\assist\VERSION\config\disable_bootstrap_update'
# 例如執行以下命令禁止雲助手Agent啟動時檢查升級，對各個版本都有效
New-Item -Path 'C:\ProgramData\aliyun\assist\config\disable_bootstrap_update'

    • Linux系統：運行以下命令。

      # 例如執行以下命令將會禁止指定版本號碼的雲助手Agent啟動時的檢查升級
touch /usr/local/share/aliyun-assist/VERSION/config/disable_bootstrap_update
# 例如執行以下命令禁止雲助手Agent啟動時檢查升級，對各個版本都有效
touch /usr/local/share/aliyun-assist/config/disable_bootstrap_update
    說明

    VERSION為雲助手Agent的具體版本號碼，查看版本號碼的步驟請參見安裝雲助手Agent。

    步驟二：禁止雲助手Agent自動檢查更新

    在雲助手Agent安裝目錄內的config目錄下建立檔案disable_update即可禁用該版本的雲助手Agent自動升級，在跨版本目錄內的config目錄下建立該檔案可禁用本機上所有版本的雲助手Agent自動升級。disable_update檔案不需要寫入任何內容。

    • Windows Server系統：在PowerShell中運行以下命令。

      # 例如執行以下命令將會禁止指定版本號碼的雲助手Agent的自動升級
New-Item -Path C:\ProgramData\aliyun\assist\VERSION\config\disable_update
# 例如執行以下命令禁止雲助手Agent的自動升級，對各個版本都有效
New-Item -Path C:\ProgramData\aliyun\assist\config\disable_update

    • Linux系統：運行以下命令。

      # 例如執行以下命令將會禁止指定版本號碼的雲助手Agent的自動升級
touch /usr/local/share/aliyun-assist/VERSION/config/disable_update
# 例如執行以下命令禁止雲助手Agent的自動升級，對各個版本都有效
touch /usr/local/share/aliyun-assist/config/disable_update
    說明

    VERSION為雲助手Agent的具體版本號碼，查看版本號碼的步驟請參見安裝雲助手Agent。

    如果您想恢複自動升級，請刪除設定檔disable_update和disable_bootstrap_update。

    • Windows Server系統：在PowerShell中運行以下命令。

      Remove-Item -Path C:\ProgramData\aliyun\assist\VERSION\config\disable_update
Remove-Item -Path C:\ProgramData\aliyun\assist\config\disable_update

Remove-Item -Path C:\ProgramData\aliyun\assist\VERSION\config\disable_bootstrap_update
Remove-Item -Path C:\ProgramData\aliyun\assist\config\disable_bootstrap_update

    • Linux系統：運行以下命令。

      rm /usr/local/share/aliyun-assist/VERSION/config/disable_update
rm /usr/local/share/aliyun-assist/config/disable_update

rm /usr/local/share/aliyun-assist/VERSION/config/disable_bootstrap_update
rm /usr/local/share/aliyun-assist/config/disable_bootstrap_update

    手動升級

    說明

    雲助手支援的功能和最低版本號碼，請參見支援功能及版本。

    通過公用命令升級

    自動升級失效時，您可以調用公用命令進行升級。

    重要

    下文以控制台操作為例，如果使用OpenAPI或CLI方式使用雲助手公用命令，請參見查看和執行公用命令。

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

    2. 在ECS雲助手頁面，單擊公用命令頁簽。

    3. 找到如下待執行的公用命令（選擇最新版本），單擊執行。

      • Linux執行個體：ACS-ECS-UpdateAliyunAssist-linux.sh。

      • Windows執行個體：ACS-ECS-UpdateAliyunAssist-windows.ps1。

        image.png

    4. 在執行命令面板中，按照介面提示配置相關參數並單擊執行。

      • 執行計劃：選擇命令執行的時間。更多資訊，請參見執行計畫詳細資料。

      • 選擇實例：選擇需要升級雲助手的執行個體，該執行個體需處於運行中狀態且已安裝雲助手的用戶端。

        更多參數說明，請參見查看和執行公用命令。

      當執行結果類似如下所示時，說明雲助手Agent已升級成功。image.png

    說明

    如果公用命令執行失敗，請查看錯誤資訊並根據診斷資訊修複問題，更多資訊，請參見執行失敗常見錯誤及修複建議。

    手動下載安裝包升級

    您也可以手動下載最新的安裝包進行升級。更多的安裝方式，請參見安裝雲助手Agent。

    樣本：以RPM包為例，執行以下命令為x86架構的Linux執行個體下載並安裝最新的雲助手安裝包。

    wget "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/linux/aliyun_assist_latest.rpm" && sudo rpm -ivh --force aliyun_assist_latest.rpm

    部分核心版本號碼雲助手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