文档

阿里云托管实例

更新时间:

将非阿里云服务器注册为阿里云托管实例,该服务器即可使用阿里云提供的多种在线服务(例如云助手、系统运维管理和云效)来管理或使用该服务器。例如,您可以通过云助手免登录管理此服务器。

使用限制

  • 第三方服务器限制

    • 操作系统限制:

      • Alibaba Cloud Linux 2/3

      • CentOS 6及更高版本

      • CoreOS、OpenSUSE

      • Debian 8/9/10及更高版本

      • RedHat 5/6/7及更高版本

      • SUSE Linux Enterprise Server 11/12/15及更高版本

      • Ubuntu 12/14/16/18及更高版本

      • Window Server 2012/2016/2019及更高版本

    • 服务器可以访问公网。

  • 托管实例功能的地域限制

    仅以下地域支持托管实例功能:

    华北1(青岛)、华北2(北京)、华北3(张家口)、华北5(呼和浩特)、华北6(乌兰察布)、华东1(杭州)、华东2(上海)、华南1(深圳)、华南2(河源)、华南3(广州)、西南1(成都)、中国(香港)、日本(东京)、韩国(首尔)、新加坡、澳大利亚(悉尼)、马来西亚(吉隆坡)、印度尼西亚(雅加达)、菲律宾(马尼拉)、泰国(曼谷)、印度(孟买)、德国(法兰克福)、英国(伦敦)、美国(硅谷)、美国(弗吉尼亚)、阿联酋(迪拜)、沙特(利雅得)。

计费说明

  • 托管实例功能是阿里云提供的免费在线服务,您无需缴纳服务费用。

  • 将第三方服务器注册为阿里云托管实例后,您在使用其他阿里云在线服务的过程中可能会产生费用,具体计费规则,请以您使用的在线服务为准。

步骤一:创建注册码

为了将第三方服务器注册为阿里云托管实例,您需要创建注册码(即激活码)并将其应用到服务器上。注册码是一种用于验证服务器身份的凭证,用于确保只有合法的服务器可以注册为阿里云托管实例。

重要
  • 1个注册码可以注册1000个托管实例。

  • 在一个阿里云地域下,您最多可以同时保留5000条注册码。

  • 当注册码数量超过1000条时,仅当注册码使用率大于50%才允许继续创建新的注册码。

    ECS云助手页面的托管实例页签下,单击注册新实例,在注册数量/注册额度列即可查看注册码使用数据。

  1. 登录ECS管理控制台

  2. 在左侧导航栏,选择运维与监控 > 云助手

  3. 在页面左侧顶部,选择您需要托管的地域。地域

    重要

    创建的注册码及注册的托管实例都将归属在该地域下。

    建议您选择网络连接速度最快的地域。您可以通过Ping命令测试连接速度,选择连接速度最快的地域。<地域ID>:您可以通过地域和可用区获取。

    ping -c 4 <地域ID>.axt.aliyuncs.com
  4. 单击托管实例页签。

    • 情况1:若当前地域未注册实例,单击创建注册码

    • 情况2:若当前地域已注册过实例,单击注册新实例,然后在注册新实例面板中,单击创建注册码

      生成注册码2.png

  5. 创建注册码面板中,设置托管实例参数。

    名称

    描述

    实例名称前缀

    设置托管实例的名称前缀,便于后续管理。

    来源IP限制

    设置托管实例的IP或IP段。

    • 填写服务器的公网IP或者IP段:只有在设置范围内的服务器IP,才支持进行托管。

    • 不填写此参数:默认不对服务器IP进行限制。

    激活数额度

    设置托管实例的数量。

    取值范围:1~1000,默认值:10。

    有效期

    设置注册码的有效期。如果注册码超过有效期未使用,您需要重新创建注册码。

    取值范围:1~876576,默认值:4,单位:小时。

    描述

    描述此注册码的用途等信息,便于后续管理。

    标签

    设置托管实例注册码的标签键标签值,方便后续分类管理和维护。

    重要

    使用该注册码注册的托管实例,将自动添加对注册码中设置的标签键标签值

    资源组

    选择相应的资源组,从用途、权限等角度管理托管实例。

    重要
    • 使用该注册码注册的托管实例,将自动添加到该注册码对应的资源组中。

    • 若未指定资源组ID,将加入到您的默认资源组中。

  6. 单击生成注册码

    操作完成后,将生成需要在第三方服务器上执行的安装脚本。生成脚本

  7. 获取安装脚本。

    选择服务器对应的操作系统类型,单击下载复制,将安装脚本保存到本地。

    • rpm:适用于Alibaba Cloud Linux、CentOS、RHEL和SUSE Linux等操作系统。

    • deb:适用于Debian和Ubuntu等操作系统。

    • exe:适用于Windows Server操作系统。

    重要
    • 生成注册码后,安装脚本只会显示一次,您需要将其保存到本地。

    • 如果您存在多个操作系统,需要依次下载对应的安装脚本。

步骤二:在服务器上安装云助手Agent并注册实例

您需要在您的第三方服务器上安装云助手Agent,并通过创建注册码时生成的安装脚本将该服务器注册为托管实例。

Linux服务器

服务器可以直接访问公网

  1. 登录您的第三方服务器。

  2. 在服务器中创建安装脚本。

    1. 运行以下命令,使用vim编辑器创建脚本。

      vim installAssistant.sh
    2. i键,进入编辑模式。

    3. 步骤7中获取的脚本粘贴到vim编辑器。

      您可以通过在粘贴的脚本内容中添加tag参数为托管实例设置标签,具体设置方法为--tag 标签键=标签值,支持设置1~20组标签,其中多组标签之间需要添加空格。例如,您在脚本内容中添加了--tag ECS=Document Test=demo设置,表示您为托管实例设置了2组标签,即标签A(ECS:Document)和标签B(Test:demo)。

      重要
      • 关于托管实例的标签,您需要注意如下事项:

        • 如果您在执行脚本(即您粘贴的ECS控制台上创建的脚本内容)中使用tag参数设置了标签,则无论您注册实例时使用的注册码是否绑定了标签,托管实例都会被绑定为执行脚本中设置的标签。

        • 如果您在执行脚本中没有使用tag参数设置标签,但注册实例时使用的注册码绑定了标签,则托管实例将被绑定对应注册码的标签。更多注册码的信息,请参见步骤一:创建注册码

        • 如果执行脚本中没有设置标签,且注册实例时使用的注册码也没有绑定标签,则托管实例将不会被绑定标签。

      • 关于托管实例的资源组,您需要注意如下事项:

        • 若托管实例注册所需的注册码在创建时未指定资源组ID,则托管实例将加入到您的默认资源组中。

        • 您可以在资源组层面对托管实例及注册码进行权限管理,将所需的RAM权限策略加入指定的资源组以实现资源组鉴权。关于托管实例相关的RAM权限策略和资源组鉴权的操作,请参见托管实例自定义策略示例RAM资源分组与授权

    4. Esc键,然后输入:wq保存并退出vim编辑器。

  3. 运行以下命令,为安装脚本设置执行权限。

    sudo chmod 755 installAssistant.sh
  4. 运行以下命令,在服务器上安装云助手Agent

    sudo ./installAssistant.sh

    安装结束后,如果返回以下信息,表示安装成功。linux返回结果

服务器通过代理服务器才能访问公网

此处以Cent OS 7.8为例,为您介绍通过代理服务器安装云助手Agent,并通过代理服务器注册托管实例的具体操作。

操作过程中,您需要使用步骤6生成的脚本,以CentOS 7.8为例,生成的脚本示例代码及功能说明如下:centos

说明

如果您使用的是Debian等操作系统,需要根据步骤7实际生成的安装脚本修改对应的命令。

  • ①:下载云助手Agent安装包

  • ②:安装云助手Agent

  • ③:注册为云助手托管实例

  1. 通过SSH等方式登录服务器。

    具体操作,请参见连接方式概述

  2. 运行以下命令,通过代理服务器下载云助手Agent

    sudo https_proxy=<http://your_proxy_address> && wget https://aliyun-client-assist.oss-accelerate.aliyuncs.com/linux/aliyun_assist_latest.rpm
    重要

    您需要将<http://your_proxy_address>改成您的代理服务器地址。

  3. 运行以下命令,安装云助手Agent

    sudo rpm -ivh aliyun_assist_latest.rpm --force
  4. 为云助手服务配置代理。

    1. 修改云助手service配置文件。

      修改云助手service配置文件,配置ALIYUN_ASSIST_PROXY环境变量。操作步骤如下所示:

      1. 通过vim新建/etc/sysconfig/aliyun文件。

        sudo vim /etc/sysconfig/aliyun
      2. 输入以下内容并保存退出。

        ALIYUN_ASSIST_PROXY=<http://your_proxy_address>
        重要

        您需要将<http://your_proxy_address>改成您的代理服务器地址。

    2. 运行以下命令,重载systemd配置。

      sudo systemctl daemon-reload
    3. 运行以下命令,重启云助手服务。

       sudo systemctl restart aliyun.service

      启动云助手服务后,在云助手的日志中(默认日志路径:/usr/local/share/aliyun-assist/{version}/log/aliyun_assist_main.log),存在Detected environment variable ALIYUN_ASSIST_PROXY for proxy setting相关信息,即表示您已经为云助手服务配置了代理。

  5. 运行以下命令,通过代理服务器注册云助手托管实例。

    1. 运行以下命令,配置代理服务器。

      sudo export ALIYUN_ASSIST_PROXY=<http://your_proxy_address>
      重要

      您需要将<http://your_proxy_address>改成您的代理服务器地址。

    2. 运行以下命令,将服务器注册为云助手托管实例。

      重要

      此处仅作为示例,您需要直接复制步骤6在控制台上生成的代码。

      sudo aliyun-service --register --RegionId "cn-hangzhou" \
         --ActivationCode "a-hz0f5KlGmF/TsM5uBuq7Eqor+****" \
         --ActivationId "045CE381-0404-4F42-A44B-CC232B3E****"

服务器通过高速通道连接专有网络(VPC)

此处以CentOS为例,为您介绍通过高速通道安装云助手Agent,然后通过VPC内网注册托管实例的具体操作。

操作过程中,您需要使用步骤6生成脚本中的RegionIdActivationCodeActivationId的取值,以CentOS 7.8为例,生成的脚本示例代码如下:

说明

如果您使用的是Debian等操作系统,需要根据步骤6实际生成的安装脚本修改对应的命令。

CentOS参数信息

  1. 通过SSH等方式登录服务器。

    具体操作,请参见连接方式概述

  2. 运行如下脚本,通过VPC内网注册托管实例。

    • CentOS操作系统

      示例代码如下,其中RegionIdActivationCodeActivationId的取值,请修改为步骤6自动生成脚本中的取值。

      #/bin/bash
      
      ## 注意设置此处的地域
      regionId="cn-hangzhou"
      
      if [[ -n $regionId ]]; then
          bucket="aliyun-client-assist-${regionId}.oss-${regionId}-internal.aliyuncs.com"
          ## 下载云助手Agent
          wget -q https://${bucket}/linux/aliyun_assist_latest.rpm
          ## 安装云助手Agent
          sudo rpm -ivh aliyun_assist_latest.rpm --force
      fi
      
      ## 通过VPC内网注册托管实例,**注意需要设置:NetworkMode "vpc"**。
      ## 此处RegionId、ActivationCode和ActivationId的值请从控制台上创建注册码的地方复制
      sudo aliyun-service --register \
        --NetworkMode "vpc" \
        --RegionId "${regionId}" \
        --ActivationCode "a-hz0f5KlGmF/TsM5uBuq7Eqor+****" \
        --ActivationId "2C217D35-FE6C-5636-BC3C-CC480D3*****"
    • Debian及其他Linux操作系统

      示例代码如下,其中RegionIdActivationCodeActivationId的取值,请修改为步骤6自动生成脚本中的取值。

      #/bin/bash
      
      ## 注意设置此处的地域
      regionId="cn-hangzhou"
      
      if [[ -n $regionId ]]; then
          bucket="aliyun-client-assist-${regionId}.oss-${regionId}-internal.aliyuncs.com"
          ## 下载云助手Agent
          wget -q https://${bucket}/linux/aliyun_assist_latest.deb
          ## 安装云助手Agent
          sudo dpkg -i aliyun_assist_latest.deb
      fi
      
      
      ## 通过VPC内网注册托管实例,**注意需要设置:NetworkMode "vpc"**。
      ## 此处RegionId、ActivationCode和ActivationId的值请从控制台上创建注册码的地方复制
      sudo aliyun-service --register \
        --NetworkMode "vpc" \
        --RegionId "${regionId}" \
        --ActivationCode "a-hz0f5KlGmF/TsM5uBuq7Eqor+****" \
        --ActivationId "2C217D35-FE6C-5636-BC3C-CC480D3*****"

Windows服务器

服务器可以直接访问公网

  1. 通过远程桌面连接等方式远程登录服务器。

    具体操作,请参见连接方式概述

  2. 将安装脚本上传到服务器。

    安装脚本为您在创建注册码时生成的安装脚本,即步骤7中生成的安装脚本。

    说明

    远程桌面连接支持直接将脚本文件复制到服务器。如果您的网络环境有其他限制,导致不能直接复制,也可以通过FTP等其他软件上传脚本。

  3. 右键单击安装脚本,单击使用PowerShell运行,开始安装云助手Agent

    windows安装脚本

服务器通过代理服务器才能访问公网

此处以Windows Server 2016数据中心版为例,为您介绍通过代理服务器安装云助手Agent,并通过代理服务器注册托管实例的具体操作。

操作过程中,您需要使用步骤6生成脚本中的RegionIdActivationCodeActivationId的取值,脚本示例代码如下。win脚本

  1. 通过远程桌面连接等方式远程登录服务器。

    具体操作,请参见连接方式概述

  2. 设置浏览器的代理服务器。

    1. 选择开始菜单 > 控制面板

    2. 单击网络和Internet

    3. 单击网络和共享中心

    4. 单击左下角的Internet选项

      代理

    5. 选择连接页签,单击局域网设置

    6. 代理服务器区域,设置您的代理服务器地址和端口,单击确定

  3. 下载云助手Agent安装包。

    1. 单击开始菜单,选择Windows PowerShell > Windows PowerShell

    2. 右键单击Windows PowerShell,选择以管理员身份运行

    3. Windows PowerShell对话框中,运行以下命令,下载云助手Agent安装包。

      Invoke-WebRequest -Uri 'https://aliyun-client-assist.oss-accelerate.aliyuncs.com/windows/aliyun_agent_latest_setup.exe' -OutFile 'C:\\aliyun_agent_latest_setup.exe'
  4. 下载完成后,安装云助手Agent

    1. 进入C:\盘。

    2. 双击aliyun_agent_latest_setup.exe,根据安装向导安装云助手Agent

  5. 为云助手设置代理服务器。

    1. 选择开始菜单 > 控制面板

    2. 单击系统和安全

    3. 单击系统

    4. 单击左侧的高级系统设置

      设置代理

    5. 选择高级页签,单击环境变量

    6. 系统变量区域,单击新建

    7. 配置变量名变量值,单击确定

      • 变量名:设置为ALIYUN_ASSIST_PROXY。

      • 变量值:设置为您的代理服务器。

    8. Windows PowerShell中运行以下命令,重启云助手服务。

      1. 运行以下命令,停止云助手服务。

        net stop AliyunService
      2. 运行以下命令,重新启动云助手服务。

        net start AliyunService
  6. Windows PowerShell中通过代理服务器注册云助手托管实例。

    1. 运行以下命令,进入云助手安装目录。

      cd C:\ProgramData\aliyun\assist\{version}
      重要

      {version}表示云助手的版本号,您需要修改为安装的具体版本号。

    2. 运行以下命令,将服务器注册为云助手托管实例。

      命令示例如下,RegionIdActivationCodeActivationId的取值,请修改为步骤6自动生成脚本中的取值。

       .\aliyun_assist_service.exe  --register  --RegionId="cn-hangzhou" --ActivationCode="a-hz0f6dB8Fg6hhtK0A5n9xqqdH****" --ActivationId="0A2E5ECE-5C71-4FA3-807B-05962C25****"

服务器通过高速通道连接专有网络(VPC)

此处以Windows Server 2016 数据中心版为例,为您介绍通过高速通道安装云助手Agent,然后注册托管实例的具体操作。

操作过程中,您需要使用步骤6生成脚本中的RegionIdActivationCodeActivationId的取值,脚本示例代码如下:

win脚本

  1. 通过远程桌面连接等方式远程登录服务器。

    具体操作,请参见连接方式概述

  2. 单击开始菜单,选择Windows PowerShell > Windows PowerShell

  3. 右键单击Windows PowerShell,选择以管理员身份运行

  4. Windows PowerShell对话框中,运行以下命令。

    命令示例如下,RegionIdActivationCodeActivationId的取值,请修改为步骤6自动生成脚本中的取值。

    $RegionId = "cn-hangzhou"
    $Bucket = "aliyun-client-assist-${RegionId}.oss-${RegionId}-internal.aliyuncs.com"
    
    Invoke-WebRequest -Uri "https://${Bucket}/windows/aliyun_agent_latest_setup.exe" `
    -OutFile 'C:\\aliyun_agent_latest_setup.exe'
    &"C:\\aliyun_agent_latest_setup.exe" '/S' '--register' `
    '--NetworkMode="vpc"' '--RegionId="cn-hangzhou"' `
    '--ActivationCode="a-hz0f6dB8Fg6hhtK0A5n9xqqdH****"' `
    '--ActivationId="0A2E5ECE-5C71-4FA3-807B-05962C25****"'
    type C:\ProgramData\aliyun\assist\hybrid\instance-id
    Start-Sleep -s 30
    net stop AliyunService
    net start AliyunService

步骤三:查看第三方服务器是否托管成功

当您在服务器上安装云助手Agent并注册实例后,您需要回到ECS管理控制台,查看托管实例是否连接正常,如果正常,则表示第三方服务器托管成功。

  1. 在左侧导航栏,选择运维与监控 > 云助手

  2. 在页面左侧顶部,选择目标资源所在的资源组和地域。地域

  3. 单击托管实例页签,查看托管实例列表。

    默认显示当前阿里云账号下的全部资源,您可以在云助手控制台的左上角账号全部资源列表中选择资源组,以查看目标资源组下的托管实例及注册码信息。

    托管实例列表

    如上图所示,如果托管实例的连接状态已经处于正常,表示您已经成功注册托管实例,即您的第三方服务器托管成功。

当您的第三方服务器成功注册为托管实例后,您可以通过云助手免登录管理此服务器。关于如何使用云助手,请参见创建并执行命令发送本地文件到ECS实例

(可选)取消托管第三方服务器

如果您打算不再将您的第三方服务器托管至阿里云,您只需要注销托管实例,然后停用并卸载云助手服务即可。

Linux服务器

  1. 通过SSH等方式登录服务器。

    具体操作,请参见连接方式概述

  2. 运行以下命令,注销托管实例。

    sudo aliyun-service --deregister
  3. 停止并卸载云助手守护进程。

    1. 运行以下命令,停止云助手守护进程。

      sudo /usr/local/share/assist-daemon/assist_daemon --stop
      说明

      /usr/local/share/assist-daemon/assist_daemon为云助手守护进程的默认路径。

    2. 运行以下命令,卸载云助手守护进程。

      sudo /usr/local/share/assist-daemon/assist_daemon --delete
  4. 运行以下命令,停用云助手Agent

    说明

    Linux的内核版本不同,使用的是不同的初始化进程服务,采用较新内核版本的Linux(例如Ubuntu 18.04),一般使用Systemd初始化进程服务,本示例以Systemd初始化进程服务为例。关于其他初始化进程服务的具体操作,请参见启动、停止或者卸载云助手Agent

    sudo systemctl stop aliyun.service
  5. 运行以下命令,卸载云助手Agent

    • rpm包管理:

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

      sudo dpkg -r aliyun_assist_latest.deb
  6. 删除云助手守护进程和云助手Agent

    1. 运行以下命令,删除云助手守护进程目录。

      sudo rm -rf /usr/local/share/assist-daemon
    2. 运行以下命令,删除云助手Agent目录。

      sudo rm -rf /usr/local/share/aliyun-assist

Windows服务器

说明

示例以Windows Server 2019为例,其他Windows版本的Windows PowerShell和服务的路径可能有所差异,请根据实际情况处理。

  1. 通过远程桌面连接方式远程登录服务器。

    具体操作,请参见连接方式概述

  2. 运行Windows PowerShell。启动powershell

    1. 单击开始菜单。

    2. 选择Windows PowerShell > Windows PowerShell

    3. 右键单击Windows PowerShell,选择以管理员身份运行

  3. Windows PowerShell中运行以下命令,注销托管实例。

    aliyun-service --deregister
  4. 打开服务管理窗口。服务

    1. 单击开始菜单。

    2. 选择Windows管理工具 > 服务

  5. 找到Aliyun Assist Service,单击停止此服务windows停止服务

相关文档

当您成功注册托管实例后,您可以使用阿里云提供的多种在线服务,以云助手、系统运维管理和云效服务为例,具体如下:

  • 云助手:您可以使用云助手实现自动化运维脚本、轮询进程、安装卸载软件、启动或停止服务、安装补丁或安装安全更新等任务,更多信息,请参见使用云助手

  • 系统运维管理:您可以使用系统运维管理自动化管理和执行运维任务,更多信息,请参见系统运维管理概述

  • 云效:阿里云云效是云原生时代的新DevOps平台,通过云原生新技术和研发新模式,助力创新创业和数字化转型企业快速实现研发敏捷和组织敏捷,您可以通过云效实现效能提升。更多信息,请参见什么是云效创建云效流水线部署应用

  • 本页导读 (1)
文档反馈