文档首页/ 企业主机安全 HSS/ 用户指南（吉隆坡区域）/ 并接入HSS/ 为主机安装Agent/ 为云平台主机安装Agent
更新时间：2025-10-10 GMT+08:00
查看PDF
分享

为云平台主机安装Agent

操作场景

安装Agent后，您才能为服务器开启主机安全防护。本章节为您介绍如何为云平台主机安装Agent。

前提条件

  • 安装Agent对安全组出方向端口以及第三方安全软件等有限制要求，为避免安装Agent失败，请您参考安装前环境准备，完成相关排查后再安装Agent。
  • 安装Agent前，请先将VPCOperatePolicy和VPCEPOperatePolicy权限授予HSS，详细操作请参见授权管理。

Agent安装模式说明

HSS提供两种类别的安装模式，两者的区别请参见表1。

表1 安装模式说明

Agent安装模式

特点

适用场景

界面安装

操作便捷，比通过命令行安装Agent的效率更高。HSS仅需要您提供服务器账号密码或密钥，即可安装Agent，HSS不会保存您提交的密码文件。

待安装Agent的服务器所在VPC内已有至少1台Agent在线的服务器。

命令行/脚本安装

您需要登录服务器执行命令行或脚本安装Agent，操作比界面安装方式更复杂、效率更低。
  • 首次安装Agent。
  • 待安装Agent的服务器所在VPC内没有Agent在线的服务器。

通过账号密码为单台云平台主机安装Agent

  1. 登录管理控制台。
  2. 在控制台左上角，单击图标，选择区域或项目。
  3. 在页面左上角单击，选择“安全 > 企业主机安全 HSS”，进入“企业主机安全”页面。
  4. 在左侧导航栏中，选择“安装与配置 > 主机安装与配置”，进入“主机安装与配置”界面。
  5. （可选）如果您已开通企业项目，可在页面上方“企业项目”下拉框中选择企业项目，查看目标企业项目下的相关信息和数据。
  6. 在页面右上角，单击“安装主机安全Agent”，弹出“安装主机安全Agent”对话框。
  7. 选择“弹性云服务器ECS安装”，并单击“开始配置”。
  8. 选择安装方式。

    • 选择安装模式：界面安装
    • 选择服务器验证模式：账号密码方式
    • 选择安装数量：单台

  9. 选中目标服务器，并单击“下一步”。
  10. 根据界面提示填写账号密码信息。

    • Linux
      根据主机是否能通过root账号直接登录，填写信息。
      • 勾选“允许以root权限直连”

        表示服务器可以通过root账号直接登录，您填写服务器root密码、服务器登录端口后，HSS将通过您的root账号为主机安装Agent。

      • 不勾选“允许以root权限直连”

        表示服务器不能通过root账号直接登录，您填写其他可以登录主机的账号信息（其中root密码用于提权），HSS将通过您提供的账号信息为主机安装Agent。

    • Windows

      填写登录用户名、登录密码。

  11. 确认信息无误后，单击“确认”，Agent开始安装。

    您可以查看“Agent状态”列，确认Agent安装进度。Agent状态显示“在线”，表示安装完成。

通过账号密码为多台云平台主机安装Agent

  1. 登录管理控制台。
  2. 在控制台左上角，单击图标，选择区域或项目。
  3. 在页面左上角单击，选择“安全 > 企业主机安全 HSS”，进入“企业主机安全”页面。
  4. 在左侧导航栏中，选择“安装与配置 > 主机安装与配置”，进入“主机安装与配置”界面。
  5. （可选）如果您已开通企业项目，可在页面上方“企业项目”下拉框中选择企业项目，查看目标企业项目下的相关信息和数据。
  6. 在页面右上角，单击“安装主机安全Agent”，弹出“安装主机安全Agent”对话框。
  7. 选择“弹性云服务器ECS安装”，并单击“开始配置”。
  8. 选择安装方式。

    • 选择安装模式：界面安装
    • 选择服务器验证模式：账号密码方式
    • 选择安装数量：批量

  9. 上传安装模板。

    1. 单击“下载批量模板”，下载批量模板表格至本地。
    2. 打开下载好的表格，按表格要求填写服务器相关信息并保存。
    3. 单击“添加文件”，上传已填写完成的表格。

      HSS将根据IP地址自动匹配服务器。如果服务器匹配失败，您可以单击“查看失败主机”，确认失败原因。

  10. 勾选目标服务器。
  11. 确认信息无误后，单击“确认”，Agent开始安装。

    您可以查看“Agent状态”列，确认Agent安装进度。Agent状态显示“在线”，表示安装完成。

通过DEW为单台或多台云平台主机安装Agent

  1. 登录管理控制台。
  2. 在控制台左上角，单击图标，选择区域或项目。
  3. 在页面左上角单击，选择“安全 > 企业主机安全 HSS”，进入“企业主机安全”页面。
  4. 在左侧导航栏中，选择“安装与配置 > 主机安装与配置”，进入“主机安装与配置”界面。
  5. （可选）如果您已开通企业项目，可在页面上方“企业项目”下拉框中选择企业项目，查看目标企业项目下的相关信息和数据。
  6. 在页面右上角，单击“安装主机安全Agent”，弹出“安装主机安全Agent”对话框。
  7. 选择“弹性云服务器ECS安装”，并单击“开始配置”。
  8. 选择安装方式。

    • 选择安装模式：界面安装
    • 选择服务器验证模式：密钥方式
    • 选择密钥来源：云密钥（DEW）

  9. 选中目标服务器，并单击“确认”，Agent开始安装。

    可选服务器列表，仅展示已绑定云密钥（DEW）的服务器。

  10. 在目标服务器所在行的“Agent状态”列，确认Agent安装进度。

    Agent状态显示“在线”，表示安装完成。

通过自建密钥为单台或多台云平台主机安装Agent（仅支持 Linux）

  1. 登录管理控制台。
  2. 在控制台左上角，单击图标，选择区域或项目。
  3. 在页面左上角单击，选择“安全 > 企业主机安全 HSS”，进入“企业主机安全”页面。
  4. 在左侧导航栏中，选择“安装与配置 > 主机安装与配置”，进入“主机安装与配置”界面。
  5. （可选）如果您已开通企业项目，可在页面上方“企业项目”下拉框中选择企业项目，查看目标企业项目下的相关信息和数据。
  6. 在页面右上角，单击“安装主机安全Agent”，弹出“安装主机安全Agent”对话框。
  7. 选择“弹性云服务器ECS安装”，并单击“开始配置”。
  8. 选择安装方式。

    • 选择安装模式：界面安装
    • 选择服务器验证模式：密钥方式
    • 选择密钥来源：自建密钥（仅支持Linux）

  9. 上传安装模板。

    1. 单击“下载批量模板”，下载批量模板表格至本地。
    2. 打开下载好的表格，按表格要求填写服务器相关信息并保存。
    3. 单击“添加文件”，上传已填写完成的表格。

      HSS将自动解析您填写的服务器。如果服务器解析失败，您可以单击“查看失败主机”，确认失败原因。

  10. 确认信息无误后，单击“确认”，Agent开始安装。
  11. 在目标服务器所在行的“Agent状态”列，确认Agent安装进度。

    Agent状态显示“在线”，表示安装完成。

通过命令行为单台云平台Linux主机安装Agent

  1. 登录管理控制台。
  2. 在控制台左上角，单击图标，选择区域或项目。
  3. 在页面左上角单击，选择“安全 > 企业主机安全 HSS”，进入“企业主机安全”页面。
  4. 在左侧导航栏中，选择“安装与配置 > 主机安装与配置”，进入“主机安装与配置”界面。
  5. （可选）如果您已开通企业项目，可在页面上方“企业项目”下拉框中选择企业项目，查看目标企业项目下的相关信息和数据。
  6. 在页面右上角，单击“安装主机安全Agent”，弹出“安装主机安全Agent”对话框。
  7. 选择“弹性云服务器ECS安装”，并单击“开始配置”。
  8. 选择安装方式。

    • 选择安装模式：命令行安装
    • 选择服务器操作系统：Linux
    • 选择安装数量：单台

  9. 根据界面提示，安装Agent。

    1. 单击控制台界面“安装主机安全Agent”对话框中复制安装命令。
    2. 以root账号登录服务器，并粘贴执行安装命令。

      界面回显如图 Agent安装完成所示，表示Agent安装完成。

      图1 Agent安装完成
    3. 等待5~10分钟，返回企业主机安全控制台，在“主机安装与配置 > Agent管理 > 已安装主机”页面，查看目标服务器Agent状态。

      Agent状态显示在线，表示Agent安装成功。

通过命令行为多台云平台Linux主机安装Agent

  1. 登录管理控制台。
  2. 在控制台左上角，单击图标，选择区域或项目。
  3. 在页面左上角单击，选择“安全 > 企业主机安全 HSS”，进入“企业主机安全”页面。
  4. 在左侧导航栏中，选择“安装与配置 > 主机安装与配置”，进入“主机安装与配置”界面。
  5. （可选）如果您已开通企业项目，可在页面上方“企业项目”下拉框中选择企业项目，查看目标企业项目下的相关信息和数据。
  6. 在页面右上角，单击“安装主机安全Agent”，弹出“安装主机安全Agent”对话框。
  7. 选择“弹性云服务器ECS安装”，并单击“开始配置”。
  8. 选择安装方式。

    • 选择安装模式：命令行安装
    • 选择服务器操作系统：Linux
    • 选择安装数量：批量
    • 选择服务器验证模式：根据服务器的验证方式，选择“账号密码方式”或“密钥方式”。

  9. 根据界面提示，安装Agent。

    在任一服务器执行如下操作即可。

    1. 单击控制台界面“安装主机安全Agent”对话框中“linux-host-list.csv”下载模板。
    2. 按模板“linux-host-list.csv”要求填写服务器信息并保存。

      请确保您填写的服务器验证信息与8选择的验证模式一致。

    3. 使用root账号远程登录任一目标主机。
    4. 使用SSH客户端上传模板文件“linux-host-list.csv”至服务器/tmp目录下。
    5. 返回HSS控制台，在“安装主机安全Agent”对话框中，单击复制安装命令。
    6. 在主机中粘贴执行安装命令，安装Agent。

      界面返回如图2所示表示安装完成。

      图2 Agent安装完成
    7. 等待5~10分钟，返回企业主机安全控制台，在“主机安装与配置 > Agent管理 > 已安装主机”页面，查看目标服务器Agent状态。

      Agent状态显示在线，表示Agent安装成功。

通过脚本为单台云平台Windows主机安装Agent

  1. 登录管理控制台。
  2. 在控制台左上角，单击图标，选择区域或项目。
  3. 在页面左上角单击，选择“安全 > 企业主机安全 HSS”，进入“企业主机安全”页面。
  4. 在左侧导航栏中，选择“安装与配置 > 主机安装与配置”，进入“主机安装与配置”界面。
  5. （可选）如果您已开通企业项目，可在页面上方“企业项目”下拉框中选择企业项目，查看目标企业项目下的相关信息和数据。
  6. 在页面右上角，单击“安装主机安全Agent”，弹出“安装主机安全Agent”对话框。
  7. 选择“弹性云服务器ECS安装”，并单击“开始配置”。
  8. 选择安装方式。

    • 选择安装模式：命令行安装
    • 选择服务器操作系统：Windows
    • 选择安装数量：单台

  9. 根据界面提示，安装Agent。

    1. 单击控制台界面“安装主机安全Agent”对话框中“installAgent.ps1”，下载安装脚本。
    2. 以Administrator用户登录待安装Agent的主机。
    3. 将“installAgent.ps1”文件复制粘贴至待安装Agent主机的C:\Users录下。
    4. 鼠标右键单击“installAgent.ps1”，选择“使用PowerShell运行”。
    5. （可选）在弹出的对话框中，键入Y，运行安装脚本安装Agent。

      如果未出现对话框，请跳过此步骤。

      图3 更改执行策略
    6. 运行完成后，打开任务管理器，查看存在“hostguard.exe”和“hostwatch.exe”表示Agent安装完成。
      图4 Agent安装完成
    7. 等待5~10分钟，返回企业主机安全控制台，在“主机安装与配置 > Agent管理 > 已安装主机”页面，查看目标服务器Agent状态。

      Agent状态显示在线，表示Agent安装成功。

通过脚本为多台云平台Windows主机安装Agent

  1. 登录管理控制台。
  2. 在控制台左上角，单击图标，选择区域或项目。
  3. 在页面左上角单击，选择“安全 > 企业主机安全 HSS”，进入“企业主机安全”页面。
  4. 在左侧导航栏中，选择“安装与配置 > 主机安装与配置”，进入“主机安装与配置”界面。
  5. （可选）如果您已开通企业项目，可在页面上方“企业项目”下拉框中选择企业项目，查看目标企业项目下的相关信息和数据。
  6. 在页面右上角，单击“安装主机安全Agent”，弹出“安装主机安全Agent”对话框。
  7. 选择“弹性云服务器ECS安装”，并单击“开始配置”。
  8. 选择安装方式。

    • 选择安装模式：命令行安装
    • 选择服务器操作系统：Windows
    • 选择安装数量：批量

  9. 根据界面提示，安装Agent。

    • 在任一服务器执行如下操作即可。
    • 除了执行脚本的服务器，其他服务器需要设置安全组入方向允许执行脚本的服务器IP访问5985端口；如果安全组规则未允许，HSS会在安装Agent时暂时修改服务器的安全组规则，在Agent安装完成后，删除该规则。
    1. 单击控制台界面“安装主机安全Agent”对话框中“windows-host-list.xlsx”，下载模板至本地。
    2. 根据模板“windows-host-list.xlsx”要求，填写服务器信息并保存。
    3. 返回企业主机安全控制台，单击“BatchInstallAgent.ps1”，下载安装脚本。
    4. 以Administrator用户登录任意一台待安装Agent的主机。
    5. 将“windows-host-list.xlsx”和“BatchInstallAgent.ps1”两个文件复制粘贴到该主机的C:\Users目录下。
    6. 鼠标右键单击“BatchInstallAgent.ps1”，选择 “使用PowerShell运行”。
    7. （可选）在弹出的对话框中，键入Y，运行安装脚本安装Agent。

      如果未出现对话框，请跳过此步骤。

      图5 更改执行策略
    8. 脚本运行成功后，在C:\Users\Administrator目录下查看是否存在“BatchInstallAgent.log”文件。

      存在“BatchInstallAgent.log”文件表示Agent安装完成。

    9. 等待5~10分钟，返回企业主机安全控制台，在“主机安装与配置 > Agent管理 > 已安装主机”页面，查看目标服务器Agent状态。

      Agent状态显示在线，表示Agent安装成功。

后续操作

在为主机安装Agent成功后，请开启防护。

父主题： 为主机安装Agent