我们知道，行云管家是一个云计算管理平台，目前行云管家已经通过API的形式支持了业界主流的云厂商，但是，用户的主机资源并非只有公有云主机一类，OpenStack、VMware等私有云平台应用也非常广泛，另外传统的IDC托管服务器也并未完全消亡，甚至还有相当数量的小公有云厂商由于诸如API等问题无法进行支持。

基于以上行业现状，行云管家为用户提供了局域网主机的解决方案，把这类无法通过API导入的主机，均以局域网主机的形式接入到行云管家上来。因此，行云管家中的局域网主机，并非我们传统意义上的“局域网络内的主机”，而是相对公有云API导入方式而言的另外一种主机导入方式。

行云管家为用户提供了一站式的IT运维管理功能，其中即有主机监控、堡垒机安全审计、自动化运维等基础运维功能，也有成本等公有云特有的功能，因此，公有云主机和局域网主机在管理功能上来说，存在一些差异，主要体现在：

需要在行云管家中管理局域网主机，首先要建立一个局域网与行云管家之间的数据通讯链路。在行云管家中，我们通过在局域网中部署一个Proxy来实现这个连接，这个Proxy负责局域网主机和行云管家的通信代理，部署模型如下图所示：

了解了局域网主机管理原理后，我们接下来介绍如何将局域网接入到行云管家中。

点击“导入局域网主机”，如果是第一次导入局域网主机，将出现“暂无可用的局域网Proxy，是否立即接入新的局域网”提示，点击“确定”按钮，打开“接入局域网”向导；

只需为您的局域网设置一个名称即可，点击“下一步”；

Proxy负责局域网与行云管家之间的通讯，选择一台主机作为宿主机（如何选择Proxy宿主机），无需逐台安装，请根据您的Proxy宿主机操作系统选择脚本类型，获得相应的Proxy的安装脚本，并将其复制；

将脚本粘贴到宿主机的CMD窗口上（Windows）或SSH终端中（Linux），再执行安装脚本（必须是管理员身份）；

请注意，Proxy安装脚本是在您上一步选取的Proxy宿主机上执行的，而非您的个人终端，如果安装脚本无法执行，您可以尝试 手动下载安装包。

不论您是否安装了Proxy，您都可以直接点击“下一步”后直接关闭向导，但要想继续完成导入局域网主机的功能，您必须确保您的Proxy处于正常工作状态。

如果您已经正确安装了Proxy，但界面上仍然提示“未检测到Proxy，无法将局域网主机接入行云管家”，请点击“已经安装，立即刷新”。

在Proxy正常运行之后，您可以将局域网中的主机导入到行云管家中进行管理。

点击“导入局域网主机”，选择上一步所创建的局域网账户，点击“确定”按钮，打开“导入局域网主机”窗口；

输入您欲导入到行云管家的主机IP规则，点击“检索”，Proxy将会自动将这些IP扫描出来，目前IP规则支持以下格式：

a）单个IP：当输入单IP时，不论该IP是否存在，都可以将其导入；

b）IP网段：支持扫描Proxy宿主机所在IP段存在哪些主机，用户可自由决定要将哪些主机导入到行云管家；

主机扫描完成后，选择相应的主机，点击“添加”，将所选主机全部导入到行云管家中进行管理；

在导入局域网主机时，用户可以通过IP段来将网段中的主机扫描出来，但有些情况下，部分主机却一直扫描不出来，这是为什么呢？

这其实和网段的扫描手段有关，行云管家是通过Proxy来对网段中的主机进行Ping来发现主机，如果主机设置了禁止Ping，则会导致无法扫描出来；

如果碰到这种情况，用户可以通过以下手段来处理：

1、用户可以直接输入该主机的IP，单独将主机导入，在输入单IP时，并不会扫描该主机是否存在，可以强制将其导入；

2、开启主机的Ping服务，让Proxy能够发现该主机的存在；

在安装Proxy之前，我们需要先选择Proxy宿主机，Proxy的宿主机选择需要遵循以下原则：

a）宿主机和其它主机处于同一个局域网内，且能够和其它主机通过局域网互通；

b）宿主机无需具备公网IP，但必须要能够访问公网；

c）宿主机拥有大于100M的可用磁盘空间，以及64M以上的可用内存。

在网络中，如果Proxy发生了单点故障，将导致严重后果。行云管家支持在一个网络中部署多个Proxy，以起到负载均衡的目的。

1、进入“网络”功能模块，查看当前团队所有网络；

2、找到您要部署多台Proxy的局域网，点击进入；

3、在局域网页面，左侧是当前所有的Proxy，右侧是当前网络内所有主机，点击下方“可在同一个网络中部署多个Proxy以起到负载均衡的目的”；

4、打开“安装行云管家Proxy”向导，阅读完第一步安装要求后，点击“下一步”；

5、选择宿主机时，如果您是将Proxy安装在“未导入到行云管家的主机”上，那么您将直接获取一个Proxy安装脚本，后续步骤和“接入局域网/获取Proxy安装脚本”一致；

6、如果Proxy的宿主机已经导入到行云管家，您可以选择“在当前网络中选择一台主机”上，并选中该台主机，点击“下一步”；

7、提供“自动安装”和“手动安装”两种安装方式，自动安装只需输入主机的登录凭证或者选择一个已用的快捷方式，即可完成安装；

8、如果选择手动安装，系统会根据宿主机操作系统，生成相应的安装脚本，您需要复制脚本内容（强烈建议您通过 云拷贝 功能复制脚本内容），将脚本在宿主机上执行；

9、如果您已经实现了“云拷贝”功能，您可以直接将脚本粘贴到宿主机的CMD窗口上（Windows）或SSH中（Linux），再执行安装脚本（必须是管理员身份）；

11、如果您没有“云拷贝”功能，请通过行云管家的“复制/粘贴”功能将安装脚本发送到宿主机中；

12、安装过程如果遇到问题，您可以点击“安装遇到问题”链接，打开常见问题的帮助指引。

13、最后一步“安装行云管家Proxy”中，如果是“自动安装”，将会出现安装进度与结果。而如果是“手动安装”，则直接“关闭”安装向导，待安装脚本在宿主机上执行成功后Proxy将会自动出现。

Proxy通过心跳的方式与行云管家进行门户通信，当助手运行状况出现异常，能够实时向门户汇报，因此，我们可能会在门户中看到以下状态：

通常情况下，Proxy运行异常可能由于以下原因导致：

1、升级失败：当行云管家对Proxy进行升级时，运行在用户主机上的Proxy均会自动升级，但如果用户日常将助手停用，会断开其与门户的正常通信，导致无法正常升级；

2、Proxy文件损坏：可能由于文件误删除、助手被卸载等情况，导致Proxy本身无法正常启动；

当Proxy出现异常时，建议先尝试重启解决，如果是Linux，请直接输入以下命令进行重启：

如果是Windows，请进入安装目录（默认是：C:\Program Files (x86)\Cloudbility\CloudGateway\bin）执行以下命令：

如果重启仍无法解决，您可以先删除Proxy再重新安装，删除Proxy操作步骤请见下文。

如果您要将网络中的某个Proxy删除，只需点击打开该Proxy的属性窗口，点击“卸载”即可。

一般情况下，主机中的Proxy程序会自动卸载，如果由于各种原因导致Proxy程序未自动卸载，请手工执行以下脚本：

使用root权限执行以下脚本：

使用管理员身份打开CMD命令提示行，进入安装目录（默认是：C:\Program Files (x86)\Cloudbility\CloudGateway\bin），执行以下命令：

如果您的Windows服务器由于环境原因，Powershell和Bat脚本都无法执行，那么您可以通过下载安装包的方式来安装Proxy，具体步骤请参考以下说明：

根据您的操作系统类型从以下地址将Proxy安装包下载到宿主机上（如果是私有部署版，请将域名https://dl.cloudbility.com修改成您的实际行云管家门户地址）：

32位：https://dl.cloudbility.com/downloads/cloudGateway/CloudGateway-windows32-latest.zip

64位：https://dl.cloudbility.com/downloads/cloudGateway/CloudGateway-windows64-latest.zip

在宿主机上手工创建目录：C:\Program Files (x86)\Cloudbility\（32位系统目录是：C:\Program Files\Cloudbility\），并将安装包解压到这个目录中；

打开一个安装Proxy的窗口，切换到“Windows主机”，按照下图中的2，找到安装脚本中这段信息，第一段是key，第二段和第三段是两个URL地址，将其复制下来，注意保留中间的空格，不要拷贝多余字符；

用文本编辑器打开解压目录下的文件：\wrapper\conf\parameter_file.conf，将上一步拷贝的信息，粘贴到文件末尾最后一行，并保存。如图所示：

使用管理员身份打开CMD命令提示行，根据操作系统32位或64位来选择执行以下命令：

如果结果如下图所示，则表示Proxy安装成功。