云服务器 ECS安装云助手客户端

Windows实例安装客户端

1. 以root权限远程连接ECS实例。连接方式请参见连接方式概述。
2. 下载云助手客户端。
   云助手客户端下载地址：

   • 公网地址（最新版本）：云助手客户端最新版本。
   • 公网地址（指定版本）：
     https://aliyun-client-assist.oss-accelerate.aliyuncs.com/windows/aliyun_agent_{version}_setup.exe

   • 内网地址（最新版本）：
     https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/windows/aliyun_agent_latest_setup.exe

   • 内网地址（指定版本）：
     https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/windows/aliyun_agent_{version}_setup.exe

   说明

   • {version}为云助手客户端的具体版本号。
   • {regionId}为您实例所在的地域的Region ID。

   例如在杭州内网下载1.0.0.128版本，则对应地址如下所示。

   https://aliyun-client-assist-cn-hangzhou.oss-cn-hangzhou-internal.aliyuncs.com/windows/aliyun_agent_1.0.0.128_setup.exe

3. 双击客户端文件，根据安装向导完成安装。
   如果您选择默认安装路径，客户端在Windows实例中的安装目录为C:\ProgramData\aliyun\assist\。
4. 如果ECS实例的网络类型为经典网络，需要执行以下操作。
   1. 在云助手的安装目录下，创建名为region-id的文件（不要添加类似.txt或.conf的扩展名）。
   2. 在region-id文件中填入ECS实例所属地域的ID，例如cn-hangzhou。
   说明 Windows系统会隐藏已知文件类型的扩展名，您必须设置显示已知文件类型的扩展名才能真正判断region-id是否带有扩展名。

Linux实例安装客户端（rpm包管理方式）

适合Alibaba Cloud Linux、CentOS、RHEL和SUSE Linux等操作系统。

1. 以root权限远程连接ECS实例。
   关于连接方式的介绍，请参见连接方式概述。
2. 下载云助手客户端rpm包。
   • 公网地址（最新版本）：
     • x86版本
       wget "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/linux/aliyun_assist_latest.rpm"

     • arm版本
       wget "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/arm/aliyun-assist-latest-1.aarch64.rpm"

   • 公网地址（指定版本）：
     • x86版本
       wget "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/linux/aliyun_assist_{version}.rpm"

     • arm版本
       wget "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/arm/aliyun-assist-{version}-1.aarch64.rpm"

   • 内网地址（最新版本）：
     • x86版本
       wget "https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/linux/aliyun_assist_latest.rpm"

     • arm版本
       wget "https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/arm/aliyun-assist-latest-1.aarch64.rpm"

   • 内网地址（指定版本）：
     • x86版本
       wget "https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/linux/aliyun_assist_{version}.rpm"

     • arm版本
       wget "https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/arm/aliyun-assist-{version}-1.aarch64.rpm"

   说明

   • {version}为云助手客户端的具体版本号。
   • {regionId}为您实例所在的地域的Region ID。

   例如在杭州内网地址下载1.0.2.458 x86版本，则对应地址如下所示。

   wget "https://aliyun-client-assist-cn-hangzhou.oss-cn-hangzhou-internal.aliyuncs.com/linux/aliyun_assist_1.0.2.458.rpm"

3. 安装云助手客户端。
   如果您选择默认安装路径，则客户端在Linux实例中的安装目录为：

   • CoreOS操作系统：/opt/local/share/aliyun-assist/
   • 其他操作系统（Alibaba Cloud Linux、Ubuntu、Debian、RedHat、SUSE Linux Enterprise Server和OpenSUSE等）：/usr/local/share/aliyun-assist/

   此示例表示安装最新版本云助手客户端。

   • x86版本
     rpm -ivh --force aliyun_assist_latest.rpm

   • arm版本
     rpm -ivh --force aliyun-assist-latest-1.aarch64.rpm

4. 根据ECS实例的操作系统或网络类型不同，需要执行以下不同操作。
   • 如果ECS实例的操作系统为RedHat，执行以下操作。
     1. 关闭qemu-ga服务。
        systemctl stop qemu-guest-agent
        systemctl disable qemu-guest-agent

     2. 重启云助手服务。
        systemctl restart aliyun.service

   • 如果ECS实例的网络类型为经典网络，执行以下操作。
     1. 在云助手的安装目录下，创建名为region-id的文件（不要添加类似.txt或.conf的扩展名）。
     2. 在region-id文件中填入ECS实例所属地域的ID，例如cn-hangzhou。

Linux实例安装客户端（deb包管理方式）

适合Debian和Ubuntu等操作系统。

1. 以root权限远程连接ECS实例。
   关于连接方式的介绍，请参见连接方式概述。
2. 下载云助手客户端deb包。
   • 公网地址（最新版本）：
     • x86版本
       wget "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/linux/aliyun_assist_latest.deb"

     • arm版本
       wget "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/arm/aliyun-assist_latest-1_arm64.deb"

   • 公网地址（指定版本）：
     • x86版本
       wget "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/linux/aliyun_assist_{version}.deb"

     • arm版本
       wget "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/arm/aliyun-assist_{version}-1_arm64.deb"

   • 内网地址（最新版本）：
     • x86版本
       wget "https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/linux/aliyun_assist_latest.deb"

     • arm版本
       wget "https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/arm/aliyun-assist_latest-1_arm64.deb"

   • 内网地址（指定版本）：
     • x86版本
       wget "https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/linux/aliyun_assist_{version}.deb"

     • arm版本
       wget "https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/arm/aliyun-assist_{version}-1_arm64.deb"

   说明

   • {version}为云助手客户端的具体版本号。
   • {regionId}为您实例所在的地域的Region ID。

   例如在杭州内网地址下载1.0.2.458 x86版本，则对应地址如下所示。

   wget "https://aliyun-client-assist-cn-hangzhou.oss-cn-hangzhou-internal.aliyuncs.com/linux/aliyun_assist_1.0.2.458.deb"

3. 如果ECS实例中已经安装过云助手，卸载旧版本。
   dpkg -r aliyun-assist

4. 安装云助手客户端。
   如果您选择默认安装路径，则客户端在Linux实例中的安装目录为：

   • CoreOS操作系统：/opt/local/share/aliyun-assist/
   • 其他操作系统（Alibaba Cloud Linux、Ubuntu、Debian、RedHat、SUSE Linux Enterprise Server和OpenSUSE等）：/usr/local/share/aliyun-assist/

   此示例表示安装最新版本云助手客户端。

   • x86版本
     dpkg -i aliyun_assist_latest.deb

   • arm版本
     dpkg -i aliyun-assist_latest-1_arm64.deb

5. 如果ECS实例的网络类型为经典网络，执行以下操作。
   1. 在云助手的安装目录下，创建名为region-id的文件（不要添加类似.txt或.conf的扩展名）。
   2. 在region-id文件中填入ECS实例所属地域的ID，例如cn-hangzhou。

Linux实例安装客户端（binary安装方式）

适合主流Linux操作系统。

1. 以root权限远程连接ECS实例。连接方式请参见连接方式概述。
2. 下载云助手客户端binary包。
   • 公网地址（最新版本）：
     • x86版本
       wget "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/linux/aliyun_assist_latest_update.zip"

     • arm版本
       wget "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/arm/aliyun_assist_latest_update_arm.zip"

   • 公网地址（指定版本）：
     • x86版本
       wget "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/linux/aliyun_assist_{version}_update.zip"

     • arm版本
       wget "https://aliyun-client-assist.oss-accelerate.aliyuncs.com/arm/aliyun_assist_{version}_update_arm.zip"

   • 内网地址（最新版本）：
     • x86版本
       wget "https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/linux/aliyun_assist_latest_update.zip"

     • arm版本
       wget "https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/arm/aliyun_assist_latest_update_arm.zip"

   • 内网地址（指定版本）：
     • x86版本
       wget "https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/linux/aliyun_assist_{version}_update.zip"

     • arm版本
       wget "https://aliyun-client-assist-{regionId}.oss-{regionId}-internal.aliyuncs.com/arm/aliyun_assist_{version}_update_arm.zip"

   说明

   • {version}为云助手客户端的具体版本号。
   • {regionId}为您实例所在的地域的Region ID。

   例如在杭州内网地址下载2.2.3.282 x86版本，则对应地址如下所示。

   wget "https://aliyun-client-assist-cn-hangzhou.oss-cn-hangzhou-internal.aliyuncs.com/linux/aliyun_assist_2.2.3.282_update.zip"

3. 安装云助手客户端。
   如果您选择默认安装路径，则客户端在Linux实例中的安装目录为：

   • CoreOS操作系统：/opt/local/share/aliyun-assist/
   • 其他操作系统（Alibaba Cloud Linux、Ubuntu、Debian、RedHat、SUSE Linux Enterprise Server和OpenSUSE等）：/usr/local/share/aliyun-assist/

   请将binary包解压到安装目录后并进行安装。下列示例以2.2.3.282 x86版本的云助手客户端为例。

   unzip-o aliyun_assist_2.2.3.282_update.zip -d /usr/local/share/aliyun-assist/chmod a+x /usr/local/share/aliyun-assist/2.2.3.282/update_install
   bash /usr/local/share/aliyun-assist/2.2.3.282/update_install

4. 根据ECS实例的操作系统或网络类型不同，需要执行以下不同操作。
   • 如果ECS实例的操作系统为RedHat，执行以下操作。
     1. 关闭qemu-ga服务。
        systemctl stop qemu-guest-agent
        systemctl disable qemu-guest-agent

     2. 重启云助手服务。
        systemctl restart aliyun.service

   • 如果ECS实例的网络类型为经典网络，执行以下操作。
     1. 在云助手的安装目录下，创建名为region-id的文件（不要添加类似.txt或.conf的扩展名）。
     2. 在region-id文件中填入ECS实例所属地域的ID，例如cn-hangzhou。

Linux实例安装客户端（源代码安装方式）

1. 以root权限远程连接ECS实例。
   关于连接方式的介绍，请参见连接方式概述。
2. 安装Git和go等必要的软件。
   此示例通过yum安装，如果您使用其他Linux版本，请修改为对应的包管理工具。

   • 安装git：
     yum install git -y

   • 安装go：
     yum install go -y

3. 下载云助手客户端源码。
   git clone https://github.com/aliyun/aliyun_assist_client

4. 进入源码存放目录。
   cd ./aliyun_assist_client

5. 编译源码。
   go build

   如果返回结果无报错信息，表示安装成功。
6. 如果ECS实例的网络类型为经典网络，执行以下操作。
   1. 在云助手的安装目录下，创建名为region-id的文件（不要添加类似.txt或.conf的扩展名）。
   2. 在region-id文件中填入ECS实例所属地域的ID，例如cn-hangzhou。
7. 运行云助手客户端。
   aliyun-service -d

通过阿里云CLI安装客户端（Windows或Linux实例）

1. 调用DescribeCloudAssistantStatus查询目标ECS实例是否安装了云助手客户端。
   aliyun ecs DescribeCloudAssistantStatus --RegionId TheRegionId --InstanceId.1 i-bp1g6zv0ce8og******p --output cols=CloudAssistantStatus rows=InstanceCloudAssistantStatusSet.InstanceCloudAssistantStatus[]

   返回CloudAssistantStatus=true时，表示ECS实例已安装云助手客户端。否则，请继续下一步。
2. 调用InstallCloudAssistant安装云助手客户端。
   aliyun ecs InstallCloudAssistant --RegionId TheRegionId --InstanceId.1 i-bp1g6zv0ce8og******p

3. 调用RebootInstance重启ECS实例。
   aliyun ecs RebootInstance --InstanceId i-bp1g6zv0ce8og******p

4. 如果ECS实例的网络类型为经典网络，在实例内部添加所属地域声明。
   1. 以root/system权限远程连接ECS实例。连接方式请参见连接方式概述。
   2. 查看云助手版本。
      • Linux：运行以下命令。
        aliyun-service -v

      • Windows：具体操作，请参见升级或禁止升级云助手客户端。

      如果客户端版本高于1.0.1.400，云助手客户端安装成功；否则，继续下一步操作。

   3. 在云助手的安装目录下，创建名为region-id的文件（不要添加类似.txt或.conf的扩展名）。
   4. 在region-id文件中填入ECS实例所属地域的ID，例如cn-hangzhou。
   说明 Windows系统会隐藏已知文件类型的扩展名，您必须设置显示已知文件类型的扩展名才能真正判断region-id是否带有扩展名。

查看ECS实例的云助手客户端信息

您安装好云助手客户端后，可以通过以下步骤查看ECS实例的云助手客户端版本号、状态等信息。

1. 登录ECS管理控制台。
2. 在左侧导航栏，选择运维与监控 > 发送命令/文件（云助手）。
3. 在顶部菜单栏左上角处，选择地域。
4. 单击ECS实例页签，查看当前地域ECS实例上的云助手客户端信息。