在单一服务器上托管多个独立的网站或应用,是现代服务器管理中常见的需求,这不仅能有效节约硬件资源与成本,也便于集中管理,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服务器上的不同应用。
第一步:准备工作
- 安装Tomcat:确保服务器上已成功安装并可以正常运行Tomcat。
- 域名解析:在域名服务商处,将
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 "%r" %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 "%r" %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:这个问题通常由以下几个原因导致:
- DNS缓存:本地或运营商DNS可能存在缓存,可以尝试清除本地DNS缓存(Windows使用
ipconfig /flushdns,macOS/Linux根据不同服务重启),或使用其他网络环境测试。 - 浏览器缓存:浏览器可能缓存了旧的内容,尝试强制刷新(Ctrl+F5)或使用无痕模式访问。
- 配置错误:请再次仔细检查
server.xml文件,最常见的是两个<Host>的appBase指向了同一个目录,或者name属性的域名拼写有误,确保每个appBase都指向其专属的应用目录。
Q2:defaultHost 属性具体有什么作用?不设置会怎么样?
A2:defaultHost 定义了 <Engine> 的默认处理主机,它的作用主要体现在两个方面:
- 处理未匹配的域名:当一个请求的Host头(域名)在所有
<Host>的name属性中都找不到匹配项时,Tomcat会将此请求交给defaultHost指定的主机处理,这可以防止用户通过错误的域名或直接使用IP地址访问到不希望被访问的页面,起到一个“兜底”的作用。 - IP地址访问:当用户直接通过服务器的IP地址访问时,由于没有提供域名,同样会触发
defaultHost规则。 如果不设置defaultHost,Tomcat将无法启动,因为这是<Engine>的一个必需属性,如果将其设置为一个不存在的Host名,那么所有不匹配的请求都将导致404错误,通常建议将其设置为主站点或一个提示性的信息页面。