Tomcat虚拟主机配置文件在哪里，具体怎么修改？

在单个Tomcat服务器上托管多个独立的网站或Web应用，这一强大功能主要通过虚拟主机实现，它允许一台物理服务器根据不同的域名或IP地址，将请求分发到不同的应用程序，从而实现资源的有效利用和应用的隔离，这一切配置的核心，都集中在Tomcat的主配置文件——server.xml之中。

核心配置文件：server.xml

Tomcat的虚拟主机配置完全依赖于位于$CATALINA_BASE/conf/目录下的server.xml文件，这个文件定义了整个Tomcat服务器的组件结构，包括服务、连接器、引擎和主机等，要理解虚拟主机,就必须先理解这些核心元素及其嵌套关系。

一个典型的与虚拟主机相关的配置结构如下：

<Server>
  <Service>
    <Connector ... />
    <Engine name="Catalina" defaultHost="localhost">
      <Host name="localhost" appBase="webapps" ... />
      <Host name="www.example.com" appBase="example-apps" ... />
    </Engine>
  </Service>
</Server>

关键元素剖析

<Engine> 元素

<Engine>是处理所有请求的核心容器，它位于<Service>内部，并接收来自一个或多个<Connector>的请求，然后将其传递给适当的<Host>进行处理。

• defaultHost属性：这是<Engine>元素中至关重要的一个属性，它指定了默认的虚拟主机名称，当一个请求的Host头信息（即域名）没有匹配到任何已配置的<Host>元素的name属性时，Tomcat将会把该请求交给defaultHost指定的主机来处理，这通常设置为localhost,但可以根据需求更改。

<Host> 元素

<Host>元素是虚拟主机的直接体现，它定义了一个特定的虚拟主机，每个<Host>都代表一个独立的网站或应用集合，并且必须嵌套在<Engine>元素内部，一个<Engine>可以包含多个<Host>。

<Host>元素的主要属性包括：

• name：这是虚拟主机的标识符，必须与客户端请求中使用的域名完全匹配（不区分大小写），如果用户访问http://www.app1.com，Tomcat会查找name属性为www.app1.com的<Host>元素。
• appBase：指定该虚拟主机对应的应用程序基础目录，它可以是相对于$CATALINA_BASE的相对路径（如webapps），也可以是绝对路径,Tomcat会在此目录下自动部署和运行Web应用。
• unpackWARs：布尔值（true/false），如果设置为true，Tomcat在启动时会将appBase目录下的WAR文件自动解压成目录结构后运行，设置为false则直接从WAR文件运行，建议在开发环境中设置为true,便于调试。
• autoDeploy：布尔值（true/false），如果设置为true，Tomcat会定期检查appBase目录，当发现有新的Web应用或应用有更新时，会自动进行部署或重新部署，这在开发阶段非常方便,但在生产环境中可能需要谨慎使用。
• xmlBase：指定该虚拟主机特定的Context配置文件的基础目录，默认为$CATALINA_BASE/conf/[Engine_name]/[Host_name]/，你可以在此目录下为每个应用创建独立的XML描述文件,实现更精细化的配置管理。

配置实战：部署两个虚拟主机

假设我们需要在一台Tomcat服务器上部署两个网站：www.app1.com和www.app2.com。

第一步：准备应用目录和文件

1. 在Tomcat安装目录外创建两个应用目录，/data/tomcat-apps/app1和/data/tomcat-apps/app2。
2. 在每个目录中放置一个简单的index.html文件，以便区分。
   • /data/tomcat-apps/app1/ROOT/index.html 内容为：<h1>Welcome to App 1</h1>
   • /data/tomcat-apps/app2/ROOT/index.html 内容为：<h1>Welcome to App 2</h1>
     （注意：ROOT目录是应用的根路径，即访问www.app1.com/会映射到ROOT目录下的应用）

第二步：修改server.xml

编辑$CATALINA_BASE/conf/server.xml，在<Engine>元素内添加两个新的<Host>配置。

<Engine name="Catalina" defaultHost="www.app1.com">
  <!-- 原始的localhost主机，可以保留或删除 -->
  <!--
  <Host name="localhost" appBase="webapps" unpackWARs="true" autoDeploy="true">
  </Host>
  -->
  <!-- 虚拟主机1 -->
  <Host name="www.app1.com" appBase="/data/tomcat-apps/app1"
        unpackWARs="true" autoDeploy="true">
  </Host>
  <!-- 虚拟主机2 -->
  <Host name="www.app2.com" appBase="/data/tomcat-apps/app2"
        unpackWARs="true" autoDeploy="true">
  </Host>
</Engine>

这里，我们将defaultHost设置为了www.app1.com。

第三步：配置本地Hosts文件（用于测试）

由于这是本地测试，我们需要模拟DNS解析,在操作系统的hosts文件中添加以下条目：

• Windows: C:WindowsSystem32driversetchosts
• Linux/macOS: /etc/hosts

0.0.1 www.app1.com
127.0.0.1 www.app2.com

第四步：启动Tomcat并验证

启动Tomcat服务器，然后在浏览器中分别访问http://www.app1.com和http://www.app2.com,你应该能看到对应网站的不同欢迎页面。

高级配置与最佳实践

使用 <Alias> 添加域名别名

如果一个虚拟主机需要响应多个域名，可以使用<Alias>子元素。

<Host name="www.app1.com" appBase="/data/tomcat-apps/app1">
  <Alias>app1.com</Alias>
  <Alias>www.app1.org</Alias>
</Host>

这样，无论用户访问www.app1.com、app1.com还是www.app1.org,都会被导向同一个虚拟主机。

日志隔离

为了方便排查问题，可以为每个虚拟主机配置独立的访问日志，这通过在<Host>内部配置<Valve>元素实现。

<Host name="www.app1.com" appBase="/data/tomcat-apps/app1">
  <Valve className="org.apache.catalina.valves.AccessLogValve"
         directory="logs"
         prefix="app1_access_log" suffix=".txt"
         pattern="%h %l %u %t "%r" %s %b" />
</Host>

这样，www.app1.com的访问日志就会被记录到logs/app1_access_log.txt文件中。

<Host> 核心属性小编总结

相关问答 (FAQs)

问题1：我已经按照教程配置了server.xml，但是访问两个不同的域名时，总是显示同一个网站的内容，这是为什么？
解答： 这个问题通常由以下几个原因造成：

1. name属性不匹配：请再次检查<Host>元素的name属性是否与您在浏览器中输入的域名完全一致（包括www前缀）。name="app1.com"无法匹配www.app1.com的请求。
2. 本地Hosts文件未配置或配置错误：如果您是在本地测试，请确保已正确修改了操作系统的hosts文件，并且将域名指向了Tomcat服务器的IP地址（如0.0.1）,修改后可能需要刷新DNS缓存。
3. defaultHost设置问题：如果请求的域名没有匹配到任何<Host>，Tomcat会使用<Engine>的defaultHost指定的主机，请检查defaultHost是否设置为您期望的默认主机。
4. 浏览器缓存：浏览器可能缓存了DNS解析结果或页面内容，尝试清除浏览器缓存或使用无痕/隐私模式访问。
5. Tomcat未重启：修改server.xml后,必须完全重启Tomcat服务才能使配置生效。

问题2：我希望将一个Web应用部署到appBase目录之外的位置，应该如何配置？
解答： 这是一个常见的需求，可以实现应用与Tomcat主目录的分离，最佳实践是使用独立的Context配置文件，而不是直接在server.xml中嵌入<Context>元素。
操作步骤如下：

1. 确定您的虚拟主机名称，例如www.app1.com。
2. 在$CATALINA_BASE/conf/目录下创建对应的目录结构：conf/Catalina/www.app1.com/。
3. 在此目录下创建一个XML文件，文件名即为应用的访问路径（myapp.xml，则访问路径为/myapp；若为ROOT.xml，则访问路径为）。
4. 编辑myapp.xml如下：

   <?xml version="1.0" encoding="UTF-8"?>
   <Context docBase="/path/to/your/external/app" />

   这里的docBase属性指向您Web应用的实际绝对路径。

5. 重启Tomcat，Tomcat会自动加载这个Context配置文件，并将/path/to/your/external/app目录下的应用部署为www.app1.com下的/myapp路径。
   这种方法的优点是无需修改全局的server.xml，配置更加模块化，且对应用的更改（如重新部署myapp.xml）通常可以动态生效,无需重启整个Tomcat。