Tomcat基于域名的虚拟主机具体怎么搭建？

在单一服务器上托管多个独立的网站或应用，是现代服务器管理中常见的需求，这不仅能有效节约硬件资源与成本，也便于集中管理，Tomcat作为一款流行的Java Web应用服务器，通过配置基于域名的虚拟主机，可以轻松实现这一目标,本文将详细阐述如何在Tomcat中搭建基于域名的虚拟主机。

核心概念解析

Tomcat的虚拟主机配置主要依赖于其核心配置文件 conf/server.xml，其核心逻辑在于 <Engine> 容器内可以包含多个 <Host> 元素，每个 <Host> 元素就代表一个虚拟主机,即一个独立的网站。

• Engine：引擎，是处理所有请求的顶层容器，它接收来自Connector的请求,并将其传递给相应的Host。
• Host：主机，代表一个虚拟主机，www.app1.com，它通过 name 属性来识别域名，并通过 appBase 属性指定该域名对应的应用程序存放目录。
• defaultHost：Engine的一个关键属性，用于指定默认主机，当接收到的请求域名无法匹配任何一个Host的name时,请求将被转发至该默认Host处理。

配置步骤详解

以下将以一个具体实例，演示如何配置两个域名 app1.example.com 和 app2.example.com 指向同一台Tomcat服务器上的不同应用。

第一步：准备工作

1. 安装Tomcat：确保服务器上已成功安装并可以正常运行Tomcat。
2. 域名解析：在域名服务商处，将 app1.example.com 和 app2.example.com 的A记录均解析到服务器的公网IP地址,这是外部能够访问到服务器的前提。

第二步：创建应用目录

为了避免与Tomcat默认的 webapps 目录混淆，最佳实践是为每个虚拟主机创建独立的应用目录，假设Tomcat安装在 /usr/local/tomcat/,我们可以在外部创建应用目录：

mkdir -p /data/www/app1
mkdir -p /data/www/app2

在 app1 和 app2 目录中分别放置各自的项目文件（一个简单的 index.html 或一个解压后的WAR包）。

第三步：修改 server.xml 配置文件

这是最关键的一步，编辑 $CATALINA_BASE/conf/server.xml 文件，找到 <Engine> 标签，默认情况下，它可能包含一个名为 localhost 的 <Host>，我们需要在此基础上添加新的 <Host> 配置。

假设原始 <Engine> 配置如下：

<Engine name="Catalina" defaultHost="localhost">
  <Realm className="org.apache.catalina.realm.LockOutRealm">
    ...
  </Realm>
  <Host name="localhost"  appBase="webapps" unpackWARs="true" autoDeploy="true">
    ...
  </Host>
</Engine>

我们将其修改为支持多域名：

<Engine name="Catalina" defaultHost="app1.example.com">
  ...
  <!-- 原始的localhost主机可以注释掉或保留作为备用 -->
  <!--
  <Host name="localhost"  appBase="webapps" unpackWARs="true" autoDeploy="true">
  </Host>
  -->
  <!-- 配置第一个虚拟主机 -->
  <Host name="app1.example.com" appBase="/data/www/app1" unpackWARs="true" autoDeploy="true">
    <Valve className="org.apache.catalina.valves.AccessLogValve" 
           directory="logs"
           prefix="app1_access_log" suffix=".txt"
           pattern="%h %l %u %t &quot;%r&quot; %s %b" />
  </Host>
  <!-- 配置第二个虚拟主机 -->
  <Host name="app2.example.com" appBase="/data/www/app2" unpackWARs="true" autoDeploy="true">
    <Valve className="org.apache.catalina.valves.AccessLogValve" 
           directory="logs"
           prefix="app2_access_log" suffix=".txt"
           pattern="%h %l %u %t &quot;%r&quot; %s %b" />
  </Host>
</Engine>

配置说明表：

属性	作用	示例值
name	指定虚拟主机的域名，必须与DNS解析的域名完全一致。	app1.example.com
appBase	指定该主机对应的应用程序基础目录，可以是绝对路径或相对于 $CATALINA_BASE 的路径。	/data/www/app1
unpackWARs	是否自动解压WAR包，设置为 true 便于开发调试。	true
autoDeploy	是否允许自动部署，设置为 true 后，在 appBase 目录下放入新的应用会自动部署。	true

在上述配置中，我们将 defaultHost 设置为 app1.example.com，为每个Host添加了独立的访问日志 <Valve>,这是一个良好的管理习惯。

第四步：部署应用并重启

确保在 /data/www/app1 和 /data/www/app2 目录中已放置了正确的应用文件（ROOT/index.html）,重启Tomcat服务使配置生效。

重启后，在浏览器中分别访问 http://app1.example.com 和 http://app2.example.com，如果一切正常,您将看到对应目录下的网站内容。

---

相关问答FAQs

Q1：我已经按照步骤配置了，为什么访问两个域名都显示同一个网站的内容？
A1：这个问题通常由以下几个原因导致：

1. DNS缓存：本地或运营商DNS可能存在缓存，可以尝试清除本地DNS缓存（Windows使用 ipconfig /flushdns，macOS/Linux根据不同服务重启）,或使用其他网络环境测试。
2. 浏览器缓存：浏览器可能缓存了旧的内容，尝试强制刷新（Ctrl+F5）或使用无痕模式访问。
3. 配置错误：请再次仔细检查 server.xml 文件，最常见的是两个 <Host> 的 appBase 指向了同一个目录，或者 name 属性的域名拼写有误，确保每个 appBase 都指向其专属的应用目录。

A2：defaultHost 定义了 <Engine> 的默认处理主机,它的作用主要体现在两个方面：

1. 处理未匹配的域名：当一个请求的Host头（域名）在所有 <Host> 的 name 属性中都找不到匹配项时，Tomcat会将此请求交给 defaultHost 指定的主机处理，这可以防止用户通过错误的域名或直接使用IP地址访问到不希望被访问的页面，起到一个“兜底”的作用。
2. IP地址访问：当用户直接通过服务器的IP地址访问时，由于没有提供域名，同样会触发 defaultHost 规则。
   如果不设置 defaultHost，Tomcat将无法启动，因为这是 <Engine> 的一个必需属性，如果将其设置为一个不存在的Host名，那么所有不匹配的请求都将导致404错误,通常建议将其设置为主站点或一个提示性的信息页面。