Todos os produtos
Search
Central de documentação

Elastic Compute Service:Instalar o Cloud Assistant Agent

Última atualização: Jun 22, 2026

Instale e inicie o Cloud Assistant Agent nas suas instâncias ECS para executar comandos e enviar arquivos remotamente.

Aplicabilidade

O Cloud Assistant Agent é compatível com os seguintes sistemas operacionais:

  • Linux: Alibaba Cloud Linux, AlmaLinux 8+, Anolis OS 7+, CentOS 5+, Debian 8+, Ubuntu 12+, RHEL 5+, SUSE 11+, Fedora 33+, CoreOS e OpenSUSE.

  • FreeBSD: 11+.

  • Windows: Server 2012+.

Desde 1º de dezembro de 2017, todas as instâncias ECS criadas a partir de imagens públicas possuem o Cloud Assistant Agent pré-instalado.

Procedimento

Console

  1. Acesse a página ECS console - Cloud Assistant.

  2. No canto superior esquerdo, selecione a região e o grupo de recursos da instância de destino.

  3. Clique na aba ECS Instances para visualizar o status do Cloud Assistant Agent das instâncias na região atual.

    • Normal: O agente está instalado.

    • Não instalado: Clique em Instalar e aguarde a conclusão da instalação. Reinicie a instância e verifique se o status muda para Normal.

      image.png

    • Anormal: Consulte Resolver exceções do Cloud Assistant.

Instância Linux

Verificar a instalação do agente

  1. Faça login na instância Linux usando o Workbench.

  2. Identifique o tipo de sistema init.

    O sistema init gerencia os processos de serviço na inicialização. Os comandos do Cloud Assistant Agent variam de acordo com o sistema init.
    • systemd: Alibaba Cloud Linux, CentOS 7+, RHEL 7+, Fedora 15+, Ubuntu 15.04+, Debian 8+ e outros.

    • Upstart: Ubuntu 6.10–14.10, RHEL 6, CentOS 6 e outros.

    • SysVinit: RHEL 5, CentOS 5, Debian 6 e outros.

  3. Verifique se o Cloud Assistant Agent está instalado.

    Systemd

    systemctl status aliyun.service

    Se a saída contiver Unit aliyun.service could not be found, o agente não está instalado.

    Upstart

    /sbin/initctl status aliyun-service

    Se a saída contiver initctl: Unknown job: aliyun-service, o agente não está instalado.

    Sysvinit

    /etc/init.d/aliyun-service status

    Se a saída estiver vazia, o agente não está instalado.

Baixar e instalar o agente

Este script é destinado a instâncias Alibaba Cloud ECS e instala a versão mais recente do agente por padrão. Para instalar uma versão específica, modifique a linha 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

Instância Windows

Verificar a instalação do agente

  1. Conecte-se a uma instância Windows usando um cliente de Área de Trabalho Remota ou o Windows App.

  2. Verifique o status do serviço Cloud Assistant.

    1. Abra o menu Iniciar e pesquise por Gerenciamento do Computador.

    2. Navegue até Serviços e Aplicativos > Serviços.

    3. Localize Aliyun Assist Service. Se não estiver listado, o agente não está instalado.

      image

Baixar e instalar o agente

Método 1: Baixar usando um navegador
  1. Baixe o Cloud Assistant Agent.

    Substitua {regionId} pelo ID da região da sua instância e abra a URL em um navegador.

    https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/windows/aliyun_agent_latest_setup.exe
    
    # Example: Download URL for the China (Hangzhou) region (cn-hangzhou)
    https://aliyun-client-assist-cn-hangzhou.oss-cn-hangzhou-internal.aliyuncs.com/windows/aliyun_agent_latest_setup.exe
  2. Instale o Cloud Assistant Agent.

    Clique duas vezes no arquivo do agente e siga o assistente de instalação. Caminho padrão: C:\ProgramData\aliyun\assist\.

Método 2: Instalar usando PowerShell

Substitua {regionId} pelo ID da região da sua instância e execute o script no 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

Aplica-se a todos os sistemas operacionais compatíveis.

  1. Chame DescribeCloudAssistantStatus para verificar se o Cloud Assistant Agent está instalado na instância de destino.

    Se CloudAssistantStatus for false, o agente não está instalado.

  2. Se o agente não estiver instalado, chame InstallCloudAssistant para instalá-lo.

  3. Após a instalação, chame RebootInstance para reiniciar a instância.

CLI

Usa a CLI da Alibaba Cloud. Aplica-se a todos os sistemas operacionais compatíveis. Substitua <YOUR-REGION-ID> pelo ID da região da sua instância ECS e <YOUR-INSTANCE-ID> pelo ID da instância.

A instalação da CLI da Alibaba Cloud não é compatível com Red Hat Enterprise Linux (RHEL).
  1. Chame DescribeCloudAssistantStatus para verificar se o Cloud Assistant Agent está instalado na instância de destino.

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

    Se o comando retornar CloudAssistantStatus=true, o agente já está instalado.

  2. Chame InstallCloudAssistant para instalar o agente.

    aliyun ecs InstallCloudAssistant --RegionId <YOUR-REGION-ID> --InstanceId.1 <YOUR-INSTANCE-ID>
  3. Chame RebootInstance para reiniciar a instância.

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

Perguntas frequentes

Sistemas operacionais não compatíveis

Não é possível instalar a versão mais recente

Alguns kernels limitam as versões do agente que podem ser instaladas.

Execute uname -r para verificar a versão do seu kernel.

Versão do kernel da instância

Versão compatível mais recente

Versão do kernel Linux < 2.6.32

  • Arquitetura x86/x64: 2.2.3.398

  • Arquitetura Arm: 2.4.3.398

Versão do kernel FreeBSD < 12.x

2.3.3.529

Instalação no FreeBSD

  • Para instâncias 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
  • Para instâncias gerenciadas (servidores não hospedados na 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

Instalação em instâncias gerenciadas

Linux

Instala a versão mais recente do agente por padrão. Para instalar uma versão específica, modifique a linha 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

Método 1: Baixar usando um navegador
  1. Abra a seguinte URL em um navegador para baixar o Cloud Assistant Agent.

    https://aliyun-client-assist.oss-accelerate.aliyuncs.com/windows/aliyun_agent_latest_setup.exe
  2. Instale o Cloud Assistant Agent.

    Clique duas vezes no arquivo do agente e siga o assistente de instalação. Caminho padrão: C:\ProgramData\aliyun\assist\.

Método 2: Instalar usando 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

Instalar a partir de binário ou código-fonte

Pacote binário

  • Para instâncias Alibaba Cloud ECS

    Instala a versão mais recente do agente por padrão. Para instalar uma versão específica, modifique a linha 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
  • Para instâncias gerenciadas (servidores não hospedados na 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

Código-fonte

O exemplo a seguir usa o yum. Para outras distribuições, use o gerenciador de pacotes correspondente.

  1. Instale os softwares necessários, como Git e Go.

    # Install Git
    sudo yum install git -y
    
    # Install Go
    sudo yum install go -y
  2. Baixe o código-fonte do Cloud Assistant Agent.

    sudo git clone https://github.com/aliyun/aliyun_assist_client
  3. Acesse o diretório do código-fonte e compile.

    # Go to the source code directory
    cd ./aliyun_assist_client
    
    # Compile the source code
    sudo go build

    Se o comando for executado sem erros, a instalação foi bem-sucedida.

Problemas do agente na rede clássica

Para instâncias ECS na rede clássica, o Cloud Assistant Agent não pode obter automaticamente as informações da região. Você deve criar manualmente um arquivo de configuração de região na instância.

A rede clássica é um tipo de rede legado que não está mais disponível para novas aquisições. Recomendamos que você migre para uma VPC para melhor desempenho e segurança.

Linux

  1. No diretório de instalação do agente, crie um arquivo chamado region-id contendo o ID da região da instância ECS.

    Por exemplo, para uma instância na região China (Hangzhou), crie o arquivo region-id no diretório padrão /usr/local/share/aliyun-assist/.

    • Para CoreOS:

      sudo sh -c 'echo "cn-hangzhou" > /opt/local/share/aliyun-assist/region-id'
    • Para outros sistemas operacionais (como Alibaba Cloud Linux, Ubuntu, Debian, RedHat, SUSE e OpenSUSE):

      sudo sh -c 'echo "cn-hangzhou" > /usr/local/share/aliyun-assist/region-id'
  2. Inicie o Cloud Assistant Agent.

    aliyun-service -d

Windows

  1. No diretório de instalação do agente, crie um arquivo chamado region-id (sem extensão como .txt ou .conf).

    Por padrão, o Windows oculta as extensões de arquivo. Configure seu sistema para exibir extensões e confirme que o arquivo region-id não possui extensão.
  2. No arquivo region-id, insira o ID da região da instância, por exemplo, cn-hangzhou.

Exemplo: Para uma instância Windows Server 2012 R2 na região China (Hangzhou), crie um arquivo region-id contendo cn-hangzhou em C:\ProgramData\aliyun\assist\.Add region-id file on Windows