您可以将非阿里云服务器注册为阿里云托管实例。注册完成后,此服务器即可以使用阿里云提供的多种在线服务(例如云助手、运维编排和云效等服务)。
前提条件
- 服务器的操作系统需要符合以下版本:
- Alibaba Cloud Linux 2/3及更高版本
- CentOS 6/7/8及更高版本
- CoreOS
- Debian 8/9/10及更高版本
- OpenSUSE
- RedHat 5/6/7及更高版本
- SUSE Linux Enterprise Server 11/12/15及更高版本
- Ubuntu 12/14/16/18及更高版本
- Window Server 2012/2016/2019及更高版本
- 服务器可以访问公网。
- 在一个阿里云地域下,您最多可以拥有5000条托管实例注册码。当注册码数量超过1000条时,需要注册码使用率大于50%才允许继续创建新的注册码。
说明 您可以在ECS云助手页面的托管实例页签下,单击查看激活码,获取注册码使用数据。
准备工作
建议您选择网络连接速度最好的地域。
托管实例功能支持的地域:华北1(青岛)、华北2(北京)、华北3(张家口)、华北5(呼和浩特)、华北6(乌兰察布)、华东1(杭州)、华东2(上海)、华南1(深圳)、华南2(河源)、中国香港、新加坡、日本(东京)。
说明 托管实例功能是阿里云提供的免费在线服务,用户不需要缴纳其服务费用。
您可以通过Ping命令测试连接速度,选择连接速度最好的地域,命令示例如下:
- 测试服务器和华北2(北京)地域的连接情况:
ping -c 4 cn-beijing.axt.aliyuncs.com
- 测试服务器和华东1(杭州)地域的连接情况:
ping -c 4 cn-hangzhou.axt.aliyuncs.com
- 测试服务器和华东2(上海)地域的连接情况:
ping -c 4 cn-shanghai.axt.aliyuncs.com
步骤一:创建托管实例激活码
本节介绍如何在控制台上创建托管实例的激活码,并生成安装脚本。
- 登录ECS管理控制台。
- 在左侧导航栏,选择。
- 在顶部菜单栏左上角处,选择地域。
- 单击托管实例页签。
- 单击创建注册码。
- 在创建注册码面板中,设置托管实例参数。
名称 |
描述 |
实例名称前缀 |
设置托管实例的名称前缀,便于后续管理。 |
来源IP限制 |
设置托管实例的IP或IP段。
- 填写服务器的公网IP或者IP段:只有在设置范围内的服务器IP,才支持进行托管。
- 不填写此参数:默认不对服务器IP进行限制。
|
激活数额度 |
设置托管实例的数量。
取值范围:1~1000,默认值:10。
|
有效期 |
设置激活码的有效期。如果激活码超过有效期未使用,您需要重新创建激活码。
取值范围:1~24,默认值:4,单位:小时。
|
描述 |
描述此激活码的用途等信息,便于后续管理。 |
- 单击生成注册码。
操作完成后,将生成执行脚本。

- 选择服务器对应的操作系统类型,单击下载或复制,将安装脚本保存到本地。
重要
- 生成激活码后,安装脚本只显示一次,您需要保存到本地。
- 如果您存在多个操作系统,需要依次下载对应的安装脚本。
步骤二:在服务器上安装云助手客户端并注册实例(直连方式)
获取安装脚本后,您需要在服务器上安装云助手客户端并注册。如果您的服务器可以直接访问公网,可以参考此步骤。
在Linux服务器上安装云助手客户端并注册实例
- 通过SSH等方式登录服务器。
- 在服务器中创建安装脚本。
- 运行以下命令,使用vim编辑器创建脚本。
- 按
i
键,进入编辑模式。
- 粘贴ECS控制台上创建的脚本内容。具体信息,请参见步骤一:创建托管实例激活码。
- 按
Esc
键,退出编辑模式。
- 输入
:wq
,并按Enter
键,保存并退出。
- 运行以下命令,为安装脚本设置执行权限。
sudo chmod 755 installAssistant.sh
- 运行以下命令,在服务器上安装云助手客户端。
sudo ./installAssistant.sh
安装结束后,如果返回以下信息,表示安装成功。

在Windows服务器上安装云助手客户端并注册实例
- 通过远程桌面连接等方式远程登录服务器。
- 将安装脚本上传到服务器。
安装脚本请参见
步骤一:创建托管实例激活码。
说明 远程桌面连接支持直接将脚本文件复制到服务器。如果您的网络环境有其他限制,导致不能直接复制,也可以通过FTP等其他软件上传脚本。
- 右键单击安装脚本,单击使用PowerShell运行,开始安装云助手客户端。
步骤二:在服务器上安装云助手客户端并注册实例(代理方式)
获取安装脚本后,您需要在服务器上安装云助手客户端并注册。如果您的服务器需要通过代理服务器才能访问公网,可以参考此步骤。
在Linux服务器上安装云助手客户端并注册实例
此处以Cent OS 7.8为例介绍如何设置代理服务器。如果您使用的是Debian等操作系统,需要根据控制台生成的安装脚本,修改对应的命令。

- ①:下载云助手客户端安装包
- ②:安装云助手客户端
- ③:注册为云助手托管实例
如果您需要通过代理服务器访问公网,需要在这些命令的基础上配置相应的代理服务器信息。
- 通过SSH等方式登录服务器。
- 运行以下命令,通过代理服务器下载云助手客户端。
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>
改成您的代理服务器地址。
- 运行以下命令,安装云助手客户端。
sudo rpm -ivh aliyun_assist_latest.rpm --force
- 为云助手服务配置代理。
- 修改云助手service配置文件。
修改云助手service配置文件,配置ALIYUN_ASSIST_PROXY环境变量。操作步骤如下所示:
- 通过vim新建vim /etc/sysconfig/aliyun文件。
sudo vim /etc/sysconfig/aliyun
- 输入以下内容并保存退出。
ALIYUN_ASSIST_PROXY=<http://your_proxy_address>
说明 您需要将<http://your_proxy_address>
改成您的代理服务器地址。
- 运行以下命令,重载systemd配置。
sudo systemctl daemon-reload
- 运行以下命令,重启云助手服务。
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
相关信息,即表示您已经为云助手服务配置了代理。
- 运行以下命令,通过代理服务器注册云助手托管实例。
- 运行以下命令,配置代理服务器。
sudo export ALIYUN_ASSIST_PROXY=<http://your_proxy_address>
说明 您需要将<http://your_proxy_address>
改成您的代理服务器地址。
- 运行以下命令,将服务器注册为云助手托管实例。
sudo aliyun-service --register --RegionId "cn-hangzhou" \
--ActivationCode "a-hz0f5KlGmF/TsM5uBuq7Eqor+****" \
--ActivationId "045CE381-0404-4F42-A44B-CC232B3E****"
在Windows服务器上安装云助手客户端并注册实例
此处以Windows Server 2016 数据中心版为例介绍如何设置代理服务器,Windows安装云助手脚本如下所示,您需要在配置代理服务器过程中使用到
RegionId
、
ActivationCode
和
ActivationId
的取值。

- 通过远程桌面连接等方式远程登录服务器。
- 设置浏览器的代理服务器。
- 选择。
- 单击网络和Internet。
- 单击网络和共享中心。
- 单击左下角的Internet选项。
- 选择连接页签,单击局域网设置。
- 在代理服务器区域,设置您的代理服务器地址和端口,单击确定。
- 下载云助手客户端安装包。
- 单击开始菜单,选择。
- 右键单击Windows PowerShell,选择以管理员身份运行。
- 在Windows PowerShell对话框中,运行以下命令,下载云助手客户端安装包。
Invoke-WebRequest -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,根据安装向导安装云助手客户端。
- 为云助手设置代理服务器。
- 选择。
- 单击系统和安全。
- 单击系统。
- 单击左侧的高级系统设置。
- 选择高级页签,单击环境变量。
- 在系统变量区域,单击新建。
- 配置变量名和变量值,单击确定。
- 变量名:设置为ALIYUN_ASSIST_PROXY。
- 变量值:设置为您的代理服务器。
- 在Windows PowerShell中运行以下命令,重启云助手服务。
- 运行以下命令,停止云助手服务。
net stop AliyunService
- 运行以下命令,重新启动云助手服务。
net start AliyunService
- 在Windows PowerShell中通过代理服务器注册云助手托管实例。
运行以下命令,进入云助手安装目录。
cd C:\ProgramData\aliyun\assist\{version}
说明 {version}
表示云助手的版本号,您需要修改为安装的具体版本号。
运行以下命令,将服务器注册为云助手托管实例。
.\aliyun_assist_service.exe --register --RegionId="cn-hangzhou" --ActivationCode="a-hz0f6dB8Fg6hhtK0A5n9xqqdH****" --ActivationId="0A2E5ECE-5C71-4FA3-807B-05962C25****"
说明 此处仅作为示例。
RegionId
、
ActivationCode
和
ActivationId
的取值,请修改为控制台自动生成脚本中的取值。更多信息,请参见
步骤一:创建托管实例激活码。
步骤二:在服务器上安装云助手客户端并注册实例(高速通道方式)
当您的本地服务器使用高速通道连接到阿里云专有网络VPC时,可通过此方式注册为阿里云托管实例,连接到云助手服务器,并使用云助手相关功能。高速通道的更多信息,请参见什么是高速通道。
选择一台ECS实例安装与运行代理服务器软件
在您的在阿里云专有网络VPC内,选择一台ECS实例作为代理服务器,在此ECS实例上安装并运行代理服务器软件,然后使用其他本地服务器通过此代理服务器连接到阿里云云助手服务。您可以安装HAProxy(推荐)、Nginx和Squid等代理服务器程序。
后续操作均以选择的ECS实例的内网IP地址为192.168.0.1为例,具体IP地址请以您实际选择的ECS实例为准。
在Linux服务器上安装云助手客户端并注册实例
此处以CentOS为例介绍如何下载与安装云助手客户端。Linux安装云助手脚本如下所示,如果您使用的是Debian等操作系统,需要根据控制台生成的安装脚本,修改对应的命令。
您需要在配置代理服务器过程中使用到
RegionId
、
ActivationCode
和
ActivationId
的取值。

- 通过SSH等方式登录服务器。
- 运行如下脚本,通过代理注册托管实例。
- CentOS操作系统
#/bin/bash
# 注意:地域和代理服务器信息需根据您的实际环境更改
regionId="cn-hangzhou" ## 注意设置对应的地域
proxyIp="192.168.0.1:80" ## 注意此处IP地址应为您的代理服务器的私网IP地址,端口为代理服务器的端口
if [[ -z $regionId ]]; then
echo "this script should run in ECS instance"
elif [ "${regionId}" == "cn-beijing" ]; then
bucket="aliyun-client-assist.oss-${regionId}-internal.aliyuncs.com"
else
bucket="aliyun-client-assist-${regionId}.oss-${regionId}-internal.aliyuncs.com"
fi
if [[ -n $regionId ]]; then
## 下载云助手客户端
https_proxy=http://${proxyIp} && wget -q https://${bucket}/linux/aliyun_assist_latest.rpm
## 安装云助手客户端
sudo rpm -ivh aliyun_assist_latest.rpm --force
fi
## 为云助手配置代理
if [ -d /etc/sysconfig ]; then
echo "ALIYUN_ASSIST_PROXY=http://${proxyIp}" >> /etc/sysconfig/aliyun
else
mkdir -p /etc/sysconfig && echo "ALIYUN_ASSIST_PROXY=http://${proxyIp}" >> /etc/sysconfig/aliyun
fi
## 重启云助手服务
systemctl daemon-reload
sleep 2
systemctl restart aliyun.service
## 通过代理服务器注册托管实例
## 注意此处的激活码RegionId、ActivationCode和ActivationId的值需要在从控制台上创建激活码的地方复制
sudo ALIYUN_ASSIST_PROXY=http://${proxyIp} aliyun-service --register --RegionId "cn-hangzhou" \
--ActivationCode "a-hz0f5KlGmF/TsM5uBuq7Eqor+****" \
--ActivationId "2C217D35-FE6C-5636-BC3C-CC480D3*****"
此处仅作为示例。RegionId
、ActivationCode
和ActivationId
的取值,请修改为控制台自动生成脚本中的取值。更多信息,请参见步骤一:创建托管实例激活码。
- Debian及其他Linux操作系统
#/bin/bash
# 注意:地域和代理服务器信息需根据自身环境更改
regionId="cn-hangzhou" ## 注意设置对应的地域
proxyIp="192.168.0.1:80" ## 注意此处IP地址应为您的代理服务器的私网IP地址,端口为代理服务器的端口
if [[ -z $regionId ]]; then
echo "this script should run in ECS instance"
elif [ "${regionId}" == "cn-beijing" ]; then
bucket="aliyun-client-assist.oss-${regionId}-internal.aliyuncs.com"
else
bucket="aliyun-client-assist-${regionId}.oss-${regionId}-internal.aliyuncs.com"
fi
if [[ -n $regionId ]]; then
## 下载云助手客户端
https_proxy=http://${proxyIp} && wget -q https://${bucket}/linux/aliyun_assist_latest.deb
## 安装云助手客户端
sudo dpkg -i aliyun_assist_latest.deb
fi
## 为云助手配置代理
if [ -d /etc/sysconfig ]; then
echo "ALIYUN_ASSIST_PROXY=http://${proxyIp}" >> /etc/sysconfig/aliyun
else
mkdir -p /etc/sysconfig && echo "ALIYUN_ASSIST_PROXY=http://${proxyIp}" >> /etc/sysconfig/aliyun
fi
## 重启云助手服务
systemctl daemon-reload
sleep 2
systemctl restart aliyun.service
## 通过代理服务器注册托管实例
## 注意此处的激活码RegionId、ActivationCode和ActivationId的值需要在从控制台上创建激活码的地方复制
sudo ALIYUN_ASSIST_PROXY=http://${proxyIp} aliyun-service --register --RegionId "cn-hangzhou" \
--ActivationCode "a-hz0f5KlGmF/TsM5uBuq7Eqor+****" \
--ActivationId "2C217D35-FE6C-5636-BC3C-CC480D3*****"
说明 此处仅作为示例。
RegionId
、
ActivationCode
和
ActivationId
的取值,请修改为控制台自动生成脚本中的取值。更多信息,请参见
步骤一:创建托管实例激活码。
在Windows服务器上安装云助手客户端并注册实例
此处以Windows Server 2016 数据中心版为例介绍如何设置代理服务器,Windows安装云助手脚本如下所示,您需要在配置代理服务器过程中使用到
RegionId
、
ActivationCode
和
ActivationId
的取值。

- 通过远程桌面连接等方式远程登录服务器。
- 设置浏览器的代理服务器。
- 选择。
- 单击网络和Internet。
- 单击网络和共享中心。
- 单击左下角的Internet选项。
- 选择连接页签,单击局域网设置。
- 在代理服务器区域,设置您的代理服务器地址和端口,单击确定。
- 为云助手设置代理服务器。
- 选择。
- 单击系统和安全。
- 单击系统。
- 单击左侧的高级系统设置。
- 选择高级页签,单击环境变量。
- 在系统变量区域,单击新建。
- 配置变量名和变量值,单击确定。
- 变量名:设置为ALIYUN_ASSIST_PROXY。
- 变量值:设置为您的代理服务器。
- 下载云助手客户端安装包并安装云助手,然后通过服务器注册为云助手托管实例。
- 单击开始菜单,选择。
- 右键单击Windows PowerShell,选择以管理员身份运行。
- 在Windows PowerShell对话框中,运行以下命令。
Invoke-WebRequest -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' '--register' `
'--RegionId="cn-hangzhou"' '--ActivationCode="a-hz0f6dB8Fg6hhtK0A5n9xqqdH****"' `
'--ActivationId="0A2E5ECE-5C71-4FA3-807B-05962C25****"'
Start-Sleep -s 30
net stop AliyunService
net start AliyunService
说明 此处仅作为示例。
RegionId
、
ActivationCode
和
ActivationId
的取值,请修改为控制台自动生成脚本中的取值。更多信息,请参见
步骤一:创建托管实例激活码。
步骤三:在控制台查看托管实例
安装完成后,您需要回到ECS管理控制台,查看托管实例是否连接正常。
- 在左侧导航栏,选择。
- 在顶部菜单栏左上角处,选择地域。
- 单击托管实例页签,查看托管实例列表。
如上图所示,如果托管实例的连接状态已经处于正常,表示您已经成功注册托管实例。
后续您可以通过云助手免登录管理此服务器。关于如何使用云助手,请参见立即执行命令和发送本地文件到ECS实例。
(可选)注销托管实例并卸载云助手客户端
如果您打算不再使用云助手服务,可以注销托管实例,停用并卸载云助手服务。
Linux操作系统
- 通过SSH等方式登录服务器。
具体操作,请参见连接方式概述。
- 运行以下命令,注销托管实例。
sudo aliyun-service --deregister
- 停止并卸载云助手守护进程。
- 运行以下命令,停止云助手守护进程。
sudo /usr/local/share/assist-daemon/assist_daemon --stop
说明 /usr/local/share/assist-daemon/assist_daemon为云助手守护进程的默认路径。
- 运行以下命令,卸载云助手守护进程。
sudo /usr/local/share/assist-daemon/assist_daemon --delete
- 运行以下命令,停用云助手客户端。
说明 Linux的内核版本不同,使用的是不同的初始化进程服务,采用较新内核版本的Linux(例如Ubuntu 18.04)一般使用Systemd初始化进程服务,本示例以Systemd初始化进程服务为例。关于其他初始化进程服务如何操作,请参见
启动、停止或者卸载云助手客户端。
sudo systemctl stop aliyun.service
- 运行以下命令,卸载云助手客户端。
- 删除云助手守护进程和云助手客户端。
- 运行以下命令,删除云助手守护进程目录。
sudo rm -rf /usr/local/share/assist-daemon
- 运行以下命令,删除云助手客户端目录。
sudo rm -rf /usr/local/share/aliyun-assist
Windows操作系统
说明 示例以Windows Service 2019为例,其他Windows版本的Windows PowerShell和服务的路径可能有所差异,请根据实际情况处理。
- 通过远程桌面连接方式远程登录服务器。
具体操作,请参见连接方式概述。
- 运行Windows PowerShell。

- 单击开始菜单。
- 选择。
- 右键单击Windows PowerShell,选择以管理员身份运行。
- 在Windows PowerShell中运行以下命令,注销托管实例。
aliyun-service --deregister
- 打开服务管理窗口。

- 单击开始菜单。
- 选择。
- 找到Aliyun Assist Service,单击停止此服务。
