全部產品
Search

搜尋本產品

    Simple Log Service：安裝CLI

    文件中心

    Simple Log Service：安裝CLI

    更新時間：Jul 26, 2025

    Log Service命令列工具CLI支援大部分Log Service功能操作，包括Project管理、Logstore管理、日誌查詢、自動分頁和多賬戶跨域複製等情境。本文介紹如何安裝Log Service命令列工具CLI。

    安裝之前必讀

    Log ServiceCLI工具基於Python開發，需要安裝Python。安裝方法，請參見Python官網。

    說明項

    說明

    當前CLI版本

    0.2.9

    說明

    您可以執行安裝命令完成CLI工具的升級。建議您升級到最新版本。

    工具源碼

    Aliyun Log CLI

    支援Python版本

    • Python2最低版本號碼為 Python2.7。

    • Python3最低版本號碼為 Python3.7。

    支援作業系統

    Windows、Linux和macOS。

    相依元件

    安裝Python完成後，建議您使用pip install package_name命令優先安裝以下相依元件。

    • docopt

    • aliyun-log-python-sdk

    • jmespath

    • aliyun-python-sdk-core

    • aliyun-python-sdk-sts

    • requests

    步驟一：配置Python環境變數

    重要

    配置環境變數，是為了保證aliyunlog的命令可以正常運行。環境變數配置完成之後，為確保新的設定被正確應用，您可能需要重啟相關的開發工具（IDE等）或服務。

    在Linux和macOS系統內容變數中配置Python環境變數

    1. 建立.bash_profile檔案。

      說明

      如果是第一次設定環境變數，可以使用touch ~/.bash_profile建立一個設定檔，如果已經存在設定檔，則使用vim ~/.bash_profile命令直接編輯檔案。

      touch ~/.bash_profile
vim ~/.bash_profile

    2. 查看Python安裝目錄。

      which python3

    3. 配置.bash_profile檔案

      export PATH=$PATH:/usr/local/python3/bin

    4. 使用.bash_profile檔案

      # 使設定檔生效
source ~/.bash_profile

    在Windows系統內容變數中配置Python環境變數

    以下為Windows 10中通過圖形化使用者介面設定環境變數的步驟。

    1. 尋找Python安裝路徑。

      在案頭按右鍵此電腦，選擇屬性>進階系統設定>環境變數>使用者變數 > Path，可以查到Python的環境變數。

    2. 增加Python環境變數。

      在案頭按右鍵此電腦，選擇屬性>進階系統設定>環境變數>使用者變數 > Path > 建立，例如步驟1尋找的變數是D:\dev\python\python37\，需要添加的變數是D:\dev\python\python37\bin。

    步驟二：安裝CLI

    在Linux系統安裝CLI

    1. 登入Linux伺服器。

    2. 執行如下命令安裝CLI。

      pip3 install aliyun-log-python-sdk aliyun-log-cli -U --no-cache

    3. 驗證安裝結果。

      運行命令如下：

      aliyunlog --version

      若有對應的命令提示輸出，則安裝成功。

    在Windows系統安裝CLI

    1. 登入Windows伺服器。

    2. 開啟Windows命令列。

      如果您已經設定Python環境變數，可以直接執行後續命令進行安裝。若提示pip3命令無法識別，則說明您未配置Python環境變數，此時您可以使用cd進入Python安裝路徑後，再執行安裝命令。

    3. 執行如下安裝命令安裝CLI。

      pip3 install aliyun-log-python-sdk aliyun-log-cli -U --no-cache

    4. 驗證安裝結果。

      運行命令如下：

      aliyunlog --version

      若有對應的命令提示輸出，則安裝成功。

    在mac OS系統安裝CLI

    推薦使用pip3安裝Log Service命令工具CLI，參考命令如下：

    pip3 install -U aliyun-log-cli --no-cache

    如何升級CLI

    您可以執行安裝命令完成CLI工具的升級。建議您升級到最新版本。

    如何卸載CLI

    如果您不需要繼續使用CLI，您可以將其卸載。執行命令如下：

    pip3 uninstall aliyun-log-cli

    常見問題

    ECS Linux系統預設Python版本為3.6，如何升級Python版本>=3.7

    ECS預設Python版本不建議卸載，可以修改軟連結或者使用多版本管理工具控制。

    • 修改軟連結

      1. 安裝高版本Python，具體操作請參見使用包管理器安裝Python。

      2. 檢查Python3安裝位置，您可以通過which python3來尋找Python3的安裝位置。返回一個路徑，例如/usr/bin/python3。

      3. 修改軟連結。

        sudo which python3 pip3
rm -rf /usr/bin/python3 /usr/bin/pip3

# 添加軟連結，/usr/bin/python3.11為高版本安裝路徑
sudo ln -s /usr/bin/python3.11 /usr/bin/python3
sudo ln -s /usr/bin/pip3.11 /usr/bin/pip3

      4. 修改完成後，使用python -V檢查是否修改成功。

    • 多版本管理工具