Tomcat多域名管理通过修改conf/server.xml文件中的Host元素实现虚拟主机绑定，每个域名对应一个Host节点，配置完成后重启Tomcat即可生效。这是整个配置过程的核心逻辑，理解了这个原则，剩下的就是具体操作细节。
Tomcat虚拟主机的工作原理
Tomcat的虚拟主机机制并不复杂,当请求到达Tomcat时，引擎会根据请求头中的Host字段，也就是浏览器地址栏里的域名信息，去匹配server.xml中配置的Host元素，匹配成功，请求就交给对应的应用处理；匹配失败，则落入默认Host（通常是localhost）。
行业内把这种基于域名的虚拟主机方案称为名称虚拟主机，它允许在单一IP地址上托管无数个域名，国内大多数云服务器默认只分配一个公网IP，因此名称虚拟主机是使用最广泛的方案，与之相对的是基于IP的虚拟主机，需要为每个域名分配独立IP，成本高且管理繁琐，主流场景中已经很少使用。
了解一个常见误区：很多初学者以为配置多域名需要在操作系统层面做额外设置，其实Tomcat完全在应用层完成域名路由，与操作系统的hosts文件或DNS解析没有直接关系。
配置前的准备工作
动手修改配置前,有几项准备工作需要完成，否则容易出现配好后无法访问的情况。
域名解析与端口检查
确保所有需要绑定的域名已经解析到服务器IP,如果你只是在本地测试，可以在本机hosts文件中添加临时解析记录，Windows路径为C:WindowsSystem32driversetchosts，Linux路径为/etc/hosts。
检查Tomcat使用的端口是否被占用,默认情况下Tomcat监听8080端口，若希望通过80端口直接访问，需要修改conf/server.xml中Connector元素的port属性，同时确保该端口在防火墙和云服务商安全组中已放行。
目录规划建议
建议采用独立目录存放每个域名对应的应用,这种结构清晰且便于后期维护，例如在Tomcat安装目录外创建/webapp目录，下面按域名或项目名称分子目录，每个子目录存放独立的应用。
若多个域名共用同一个应用,则无需复制多份应用文件，只需重新规划docBase指向即可，后面会详细说明。
多域名绑定的核心配置步骤
整个配置过程围绕server.xml中的Engine、Host两级元素展开，Engine是引擎层，负责接收所有请求；Host是虚拟主机层，每个Host代表一个域名站点。
第一步：定位Engine默认配置
打开conf/server.xml，找到Engine元素，默认配置如下：
<Engine name="Catalina" defaultHost="localhost">defaultHost属性指定了无法匹配时默认使用的虚拟主机,默认指向localhost，如果配置了多个域名但所有域名都能正确匹配，defaultHost的优先级不高；但一旦出现未匹配的域名请求，就会落到defaultHost上。
第二步：添加多个Host元素
在Engine元素内部、原有Host元素之后，新增对应每个域名的Host元素，一个绑定两个域名的配置示例如下：
<Host name="www.example.com" appBase="webapps/example" unpackWARs="true" autoDeploy="true">
<Context path="" docBase="/opt/apps/example" reloadable="true" />
</Host>
<Host name="www.sample.org" appBase="webapps/sample" unpackWARs="true" autoDeploy="true">
<Context path="" docBase="/opt/apps/sample" reloadable="true" />
</Host>解释几个关键属性：
- name：绑定域名，支持裸域名和www子域名，可同时写多个域名用逗号分隔，如name=”example.com,www.example.com”
- appBase：当前虚拟主机存放应用的基础目录，相对路径基于CATALINA_HOME解析
- docBase：实际应用部署路径，可以指向服务器任意位置的绝对路径
- path=””:表示请求根路径直接映射到docBase指向的项目，不需要通过/war包名方式访问
第三步：处理域名别名
同一网站常需要同时通过裸域名和www子域名访问,在Host元素内部通过Alias标签声明别名：
<Host name="example.com" appBase="webapps/root" unpackWARs="true" autoDeploy="true">
<Alias>www.example.com</Alias>
<Context path="" docBase="/opt/apps/example" reloadable="true" />
</Host>这样无论访问example.com还是www.example.com，都会命中同一个虚拟主机，行业共识认为，在主域名和子域名之间做301跳转更利于GEO权重集中，这需要在应用层或更前置的Nginx层处理。
第四步：重启验证
保存配置文件后,执行bin/shutdown.sh或bin/catalina.sh stop停止服务，再执行bin/startup.sh启动服务，随后通过浏览器访问各域名，若能正常打开对应应用，说明虚拟主机配置生效。
多域名配置的常见问题排查
配置过程虽然简单,但实际操作中容易遇到几类典型问题，逐个排查能节省大量时间。
所有域名都访问了默认应用
出现这类情况,通常是Host元素的name属性与请求的域名不匹配。Tomcat的域名匹配是精确匹配，不做模糊支持，比如配置了Host name为”example.com”，但浏览器访问的是”www.example.com”，即便DNS解析到了同一台服务器，Tomcat也无法识别，请求落到defaultHost。
解决方法是显式配置Alias,或者在同一Host的name属性中用逗号将所有需要访问的域名添加进去。
域名返回404错误
404通常意味着域名匹配成功,但应用部署路径有问题，检查Context元素的docBase是否指向了正确的应用目录，同时确认该目录下存在可识别的Web应用结构，即WEB-INF/web.xml文件，如果docBase指向的是一个不包含WEB-INF的普通目录，Tomcat会报404。
本地测试正常但外网无法访问
优先排查防火墙和云安全组是否放行了相关端口,其次检查服务器上是否配置了Nginx等反向代理，若有Nginx，则需要在Nginx配置中也将新域名加入server_name，否则外网请求会先到达Nginx而根本不会转发给Tomcat。
进阶：多域名SSL证书部署
HTTPS已是主流标准,多域名场景下SSL证书的部署方式取决于具体需求，若多个域名指向同一个应用，使用多域名证书或通配符证书，在同一个Connector中统一配置即可。
若不同域名对应不同应用,但都通过443端口提供服务，则涉及SNI技术，SNI允许在同一IP和同一端口上为不同域名配置不同证书，Tomcat从8.5版本开始原生支持SNI，配置方式如下：
<Connector port="443" protocol="org.apache.coyote.http11.Http11NioProtocol" SSLEnabled="true">
<SSLHostConfig>
<Certificate certificateKeyFile="conf/ssl/example.key" certificateFile="conf/ssl/example.crt" />
</SSLHostConfig>
</Connector>多证书场景下,每个虚拟主机内部单独声明Certificate元素，Tomcat根据客户端发起的SNI握手信息自动匹配最合适的证书，需要提及的是，国内主流云厂商均已提供免费期为一年的DV证书，申请流程在控制台上操作即可完成，上游证书的部署配置不再赘述。
多域名管理与Nginx反向代理的配合方式
在生产环境中有一种常见组合：前端使用Nginx监听80和443端口，通过server_name区分不同域名，再将请求代理给后端的Tomcat，这种架构下，Tomcat本身只需保留一个默认Host，Nginx转发过来的请求默认携带原始域名，Tomcat根据Host字段也能正确路由，但更简洁的做法是让Nginx在proxy_set_header中强制指定后端预期域名。
两种方案如何选,取决于实际需求：
- 所有域名共用一套Tomcat应用,直接用Tomcat的多Host配置即可，省去一层Nginx部署
- 不同域名需要不同语言环境、不同静态资源处理策略，或者需要配置缓存、防盗链，此时Nginx前置更能发挥优势
一个典型场景是,Tomcat的静态资源处理效率不如Nginx，对于静态资源占比大的站点，用Nginx做静态文件服务，动态请求再转发给Tomcat，性能提升较明显，据统计，Nginx处理静态文件的并发能力高于Tomcat一个量级，这个说法在运维领域是被广泛接受的。
多域名与虚拟主机使用场景详解
同一台服务器部署多个客户项目
企业在做外包开发时,经常需要在一台服务器上同时运行多个客户系统，此时为每个客户分配独立域名和独立应用目录，采用上面介绍的多Host配置即可，数据隔离和日志隔离都能通过独立目录实现，降低维护成本。
开发、测试、生产环境各用独立域名
通过配置三个Host,分别绑定dev.example.com、test.example.com和www.example.com，并将它们指向同一Tomcat实例下的不同应用目录，需要注意的是，开发环境的代码质量不会影响生产环境，前提是发布流程规范，脚本能正确识别三个环境的路径差异。
多域名指向同一个应用
部分企业同时持有多个品牌域名,希望所有域名都打开同一个网站，此时只需配置多个Host，但其docBase都指向同一目录即可，无需给每个域名复制一份应用。
Tomcat性能优化与虚拟主机的配合
配置了多域名后,如果每个Host下的应用都比较占资源，需要作相应调优。
对于低配置服务器,适当缩小JVM堆内存，在bin/catalina.sh中调整JAVA_OPTS的-Xms和-Xmx参数，对于高并发场景，调整Connector的maxThreads和acceptCount参数效果较直接，多Host之间的线程池是共享的，任何一个域名的高负载都会影响其他域名，所以隔离需求强的场景更适合为每个域名单独部署Tomcat实例。
日志分离
多Host模式下,Tomcat的默认日志是所有应用混在一起写的，通过在每个Host的valve中配独立的access log，可以让各域名的访问日志分文件保存：
<Host name="www.example.com" appBase="webapps" ...>
<Valve className="org.apache.catalina.valves.AccessLogValve"
directory="logs/example"
prefix="example_access" suffix=".log"
pattern="%h %l %u %t "%r" %s %b" />
</Host>这样排查问题时能快速定位单个域名的请求记录,对运维效率的提升比较直观。
Q&A：Tomcat多域名配置常见疑问
问：一台服务器配置多个IP地址，能否实现更灵活的域名绑定？
可以,多个IP的优势在于可以为每个域名独立分配IP，并通过address属性指定Connector监听的具体IP，这样不同IP对应不同Connector，每个Connector再绑定不同的Host，但IP资源紧张且配置复杂度较高，多数情况下使用基于域名的虚拟主机已完全够用，无需刻意使用多IP方案。
问：Tomcat多域名配置与IIS的多站点绑定有什么差异？
IIS的多站点绑定需要在IIS管理器中为每个站点设置主机名,同时配合DNS解析，其底层原理与Tomcat的Host匹配机制并无本质区别，差异在于IIS的站点配置是图形化操作，Tomcat是修改XML文件，对于习惯了命令行的运维人员，直接修改server.xml比图形界面更高效，且更便于用脚本批量管理，两者的多站点隔离能力也基本对等，只是在类加载器隔离细节上存在少量差异，Tomcat通过每个Host独立的类加载器实现了应用依赖的隔离，IIS在默认应用池模式下则依赖于独立的应用程序池设置来实现等效隔离效果。
问：server.xml中频繁修改多域名配置，是否存在配置热加载的机制？
Tomcat对server.xml的修改不会自动热加载，需要重启服务才能生效，但Host内部的Context应用支持自动部署，即autoDeploy=”true”时，新放入appBase目录的应用会自动发布，日常变更多域名时，稳妥的做法还是修改后重启，避免因配置未生效导致线上访问异常。
首发原创文章，作者：王坚，如若转载，请注明出处：https://idctop.com/article/673486.html
