文档首页/ 主机安全服务 HSS/ 常见问题/ Agent相关/ 如何卸载Agent？
更新时间：2024-08-02 GMT+08:00
查看PDF

如何卸载Agent？

提供一键卸载和手动本地卸载两种方式。

操作场景

  • Agent包选择错误，需要卸载Agent后重新安装。
  • 安装命令复制错误（如在32位的主机中安装64位的Agent），需要卸载Agent后重新安装。
  • 主机安全服务升级Agent失败，需要排查执行Agent卸载。

前提条件

通过控制台一键卸载Agent时，云服务器的“Agent状态”为“在线”。

控制台一键卸载Agent

用户可以通过主机安全服务控制台直接卸载Agent，方便用户操作。

卸载Agent后主机安全服务将无法为该服务器提供任何防护。

  1. 登录管理控制台。
  2. 在页面左上角选择“区域”，单击，选择“安全与合规 > 主机安全服务”，进入主机安全平台界面。
  3. 在左侧导航中，选择“安装与配置 > 主机安装与配置 ”，进入“主机安装与配置”界面。
  4. 在目标服务器所在行的“操作”列，单击“卸载Agent”。

    如果需要批量卸载Agent，您可以批量勾选所有待卸载Agent的服务器，单击列表上方的“批量卸载Agent”。

  5. 在弹出的卸载Agent对话框中，单击“确认”。

    云服务列表“Agent状态”显示为“未安装”，卸载Agent成功。

主机本地卸载

用户在不需要使用主机安全服务或需要重新安装Agent时，可从本地卸载版本Agent。

卸载Agent后主机安全服务将无法为该服务器提供任何防护。

  • 卸载Linux版本Agent
    1. 登录需要卸载主机安全服务Agent的云服务器，并执行如下命令切换到root用户。

      su - root

    2. 请按如下操作，停止主机安全服务。
      1. 执行如下命令停止服务。

        /etc/init.d/hostguard stop

      2. （可选）输入界面回显的认证字符。如图 认证字符所示。
        仅开启了主机安全服务自保护的主机，才需要执行此操作。
        图1 认证字符
    3. 在任意目录执行如下命令，卸载Agent。

      不可以在/usr/local/hostguard/目录下执行卸载命令，可以在其他任意目录下执行卸载命令。

      • 针对EulerOS、CentOS、Red Hat等支持rpm安装软件的OS，执行命令：rpm -e hostguard
      • 针对Ubuntu、Debian等支持deb安装软件的OS，执行命令：dpkg -P hostguard

      当界面回显如下类似信息，则表示卸载Agent完成，无需再执行下一步。如果卸载失败请执行步骤3。

      Stopping Hostguard...
Hostguard stopped
Hostguard uninstalled.
    4. （可选）当执行步骤2卸载Agent失败时，可参考如下方式卸载Agent。
      • 针对EulerOS、CentOS、Red Hat等支持rpm安装软件的OS。
        1. 执行如下命令，删除安装记录。

          rpm -e --justdb hostguard

        2. 执行如下命令，查询是否有hostguard残留进程。

          ps -ef | grep hostguard

          如果有残留，请执行命令kill -9“进程pid”停止所有残留进程。

        3. 执行如下命令，查看“/usr/local/hostguard”目录是否存在。

          ll /usr/local/hostguard

          如果该目录存在，请执行命令rm -rf /usr/local/hostguard删除目录。

        4. 执行如下命令，查看“/etc/init.d/hostguard”文件是否存在。

          ll /etc/init.d/hostguard

          如果该文件存在，请执行命令rm -f /etc/init.d/hostguard删除文件。

      • 针对Ubuntu、Debian等支持deb安装软件的OS。
        1. 执行如下命令，查询是否有hostguard残留进程。

          ps -ef | grep hostguard

          如果有残留，请执行命令kill -9“进程pid”停止所有残留进程。

        2. 执行如下命令，查看“/usr/local/hostguard”目录是否存在。

          ll /usr/local/hostguard

          如果该目录存在，请执行命令rm -rf /usr/local/hostguard删除目录。

        3. 执行如下命令，查看“/etc/init.d/hostguard”文件是否存在。

          ll /etc/init.d/hostguard

          如果该文件存在，请执行命令rm -f /etc/init.d/hostguard删除文件。

  • 卸载Windows版本Agent
    1. （可选）关闭主机安全自保护。

      如果开启了主机安全服务自保护功能，请先关闭再卸载Agent，否则无法在主机本地卸载Agent，关闭操作请参见如何关闭自保护。

    2. 登录需要卸载主机安全服务Agent的云服务器。
    3. 在“控制面板 > 程序和功能”中选中“HostGuard”，然后单击“卸载”。
      • 用户也可以进入C:\Program File\HostGuard目录下，双击“unins000.exe”，启动卸载程序。
      • 如果安装Agent时创建了开始菜单下存放Agent快捷方式的文件夹，用户还可以在“开始 > HostGuard”中选择“卸载HostGuard”进行卸载。
    4. 在“HostGuard卸载向导”提示框中，单击“是”，开始卸载。
    5. （可选）重启主机。
      • 如果您开启了网页防篡改，卸载Agent需要重启主机。在“HostGuard卸载向导”弹窗中，单击“是”，重启主机。
      • 如果您未开启网页防篡改，无需重启主机。在“HostGuard卸载向导”弹窗中，单击“否”，不重启主机。
父主题： Agent相关