主机管理器应用 -- HTML 接口

目录

简介

Tomcat 主机管理器应用允许您在Tomcat中创建、删除和管理虚拟主机。本操作指南最好与以下文档配合使用：

Tomcat 主机管理器应用是Tomcat安装的一部分，默认情况下可使用以下上下文路径访问：/host-manager。您可以通过以下方式使用主机管理器：

  • 使用图形用户界面，可在以下地址访问：{server}:{port}/host-manager/html。
  • 使用一组适合脚本编写的最小HTTP请求。您可在以下地址访问此模式：{server}:{port}/host-manager/text。

这两种方式都允许您添加、删除、启动和停止虚拟主机。可以通过使用persist命令持久化更改。本文档重点介绍HTML接口。有关图形界面的更多信息，请参阅主机管理器应用 -- 文本接口。

配置管理器应用访问

以下描述使用$CATALINA_HOME指代Tomcat的安装根目录。它是您安装Tomcat的目录，例如C:\tomcat9或/usr/share/tomcat9。

主机管理器应用需要具有以下角色之一的用户：

  • admin-gui - 此角色用于图形Web界面。
  • admin-script - 此角色用于脚本Web界面。

要启用对主机管理器应用的HTML接口的访问，请为您的Tomcat用户授予适当的角色，或创建一个具有正确角色的新用户。例如，打开${CATALINA_BASE}/conf/tomcat-users.xml并输入以下内容：

<user username="test" password="chang3m3N#w" roles="admin-gui"/>

无需进一步设置。当您现在访问{server}:{port}/host-manager/html时，即可使用创建的凭据登录。

如果您正在使用不同的域，则需要使用该域的标准用户管理工具将必要的角色添加到相应的用户。

接口描述

接口分为六个部分：

  • 消息 - 显示成功和失败消息。
  • 主机管理器 - 提供基本的主机管理器操作，如列表和帮助。
  • 主机名 - 提供虚拟主机名列表并允许您对其进行操作。
  • 添加虚拟主机 - 允许您添加新的虚拟主机。
  • 持久化配置 - 允许您持久化当前的虚拟主机。
  • 服务器信息 - 有关Tomcat服务器的信息。

消息

显示您执行的最后一条主机管理器命令的成功或失败信息。

  • 成功：显示OK，后可能跟随一条成功消息。
  • 失败：显示FAIL，后跟随一条错误消息。

请注意，您的Tomcat服务器控制台可能会显示有关每条命令的更多信息。

主机管理器

主机管理器部分允许您：

  • 列出虚拟主机 - 刷新当前配置的虚拟主机列表。
  • HTML 主机管理器帮助 - 一个文档链接。
  • 主机管理器帮助 - 一个文档链接。
  • 服务器状态 - 指向管理器应用的链接。请注意，您的用户必须具有足够的权限才能访问该应用。

主机名

主机名部分包含当前配置的虚拟主机名列表。它允许您：

  • 查看主机名
  • 查看主机名别名
  • 执行基本命令，即启动、停止和移除。

添加虚拟主机

添加虚拟主机部分允许您使用图形界面添加虚拟主机。有关每个属性的描述，请参阅主机管理器应用 -- 文本接口文档。请注意，通过此界面添加的任何配置都是非持久性的。

持久化配置

持久化配置部分允许您将当前配置持久化到server.xml文件中。

此功能默认禁用。要启用此选项，您必须首先配置StoreConfigLifecycleListener监听器。为此，请将以下监听器添加到您的server.xml中：

<Listener className="org.apache.catalina.storeconfig.StoreConfigLifecycleListener"/>

配置监听器后，点击全部以使您的配置持久化。

服务器信息

提供有关当前运行的Tomcat实例、JVM和底层操作系统的基本信息。