Apache Tomcat如何配置多个域名？虚拟主机怎么设置？

Apache Tomcat 域名配置详解

在 Web 服务器配置中，域名映射是实现多站点访问的核心技术，Apache Tomcat 作为主流的 Java Web 应用服务器，支持通过域名访问不同的 Web 应用，本文将详细介绍 Apache Tomcat 域名配置的步骤、原理及常见问题解决方案，帮助用户高效完成多域名部署。

域名配置的基本原理

Tomcat 的域名配置主要依赖于 server.xml 文件中的 Engine、Host 和 Context 组件。

• Engine：表示整个 Catalina 引擎，负责处理所有虚拟主机请求。
• Host：定义虚拟主机，每个 Host 对应一个域名或 IP 地址。
• Context：部署在虚拟主机下的具体 Web 应用。

通过配置 Host 组件，Tomcat 可以根据不同的域名将请求转发到对应的 Web 应用目录。

准备工作

1. 环境要求

   • 已安装 JDK（建议 JDK 8 或以上版本）。
   • 已部署 Tomcat（建议 9.0 或以上版本）。
   • 已注册域名并解析到服务器的公网 IP（如 example.com 解析至 168.1.100）。

2. 目录结构
   确保 Tomcat 的 webapps 目录下已部署多个 Web 应用，

   $CATALINA_HOME/webapps/app1  
   $CATALINA_HOME/webapps/app2  

修改 server.xml 配置文件

server.xml 位于 Tomcat 的 conf 目录下，是域名配置的核心文件。

配置默认主机（Engine）

在 server.xml 中，Engine 组件默认包含一个 Host（localhost），若需添加多个域名，需在 Engine 内新增 Host 节点：

<Engine name="Catalina" defaultHost="localhost">  
    <!-- 默认主机 -->  
    <Host name="localhost" appBase="webapps" unpackWARs="true" autoDeploy="true">  
        <Context path="" docBase="app1" reloadable="true"/>  
    </Host>  
    <!-- 新增域名主机 -->  
    <Host name="www.example.com" appBase="webapps" unpackWARs="true" autoDeploy="true">  
        <Context path="" docBase="app2" reloadable="true"/>  
    </Host>  
</Engine>  

参数说明：

• name：域名（需与 DNS 解析的域名完全匹配）。
• appBase：Web 应用根目录（默认为 webapps）。
• docBase：指定具体应用的路径（可相对于 appBase 或绝对路径）。

使用 Context 路径映射

若需通过子路径访问不同应用（如 www.example.com/app1），可修改 Context 的 path 属性：

<Host name="www.example.com" appBase="webapps">  
    <Context path="/app1" docBase="app1"/>  
    <Context path="/app2" docBase="app2"/>  
</Host>  

配置端口与连接器

Tomcat 默认通过 8080 端口提供服务，若需通过 80 端口（HTTP）或 443 端口（HTTPS）直接访问域名，需修改 Connector 配置：

HTTP 端口（80）

在 server.xml 中添加或修改 Connector 节点：

<Connector port="80" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443"/>  

HTTPS 端口（443）

若需启用 HTTPS，需配置 SSL 证书（以 Let’s Encrypt 为例）：

<Connector port="443" protocol="HTTP/1.1" SSLEnabled="true" maxThreads="150" scheme="https" secure="true">  
    <SSLHostConfig certificateVerification="false">  
        <Certificate certificateKeystoreFile="conf/keystore.p12" type="PKCS12" certificateKeystorePassword="password"/>  
    </SSLHostConfig>  
</Connector>  

通过 Host Manager 管理虚拟主机

Tomcat 提供了图形化的 Host Manager 工具，支持动态添加虚拟主机：

1. 启用 Host Manager

   • 修改 $CATALINA_HOME/conf/tomcat-users.xml，添加管理员角色：

     <role rolename="admin-gui,manager-gui"/>  
     <user username="admin" password="password" roles="admin-gui,manager-gui"/>  

2. 访问 Host Manager
   浏览器访问 http://<server-ip>:8080/host-manager/html，输入管理员账号后，通过界面添加 Host 并指定 appBase 路径。

常见问题与解决方案

访问域名时提示 404 错误

• 原因：docBase 路径错误或应用未正确部署。
• 解决：检查 docBase 是否指向有效的应用目录，并确认应用中包含 WEB-INF/web.xml 文件。

多域名冲突

• 原因：多个 Host 的 name 属性重复或 DNS 解析错误。
• 解决：确保每个 Host 的 name 唯一，并通过 ping 命令验证域名是否解析至正确 IP。

HTTPS 配置后浏览器显示不安全

• 原因：证书无效或未正确配置。
• 解决：使用 keytool 工具验证证书有效性，或通过 OpenSSL 生成自签名证书测试。

配置示例

以下是一个完整的 server.xml 配置示例，支持两个域名（www.example.com 和 api.example.com）：

<Server port="8005" shutdown="SHUTDOWN">  
    <Service name="Catalina">  
        <Connector port="80" protocol="HTTP/1.1"/>  
        <Connector port="443" protocol="HTTP/1.1" SSLEnabled="true">  
            <SSLHostConfig>  
                <Certificate certificateKeystoreFile="conf/keystore.p12" password="password"/>  
            </SSLHostConfig>  
        </Connector>  
        <Engine name="Catalina" defaultHost="www.example.com">  
            <Host name="www.example.com" appBase="webapps">  
                <Context path="" docBase="webapp1"/>  
            </Host>  
            <Host name="api.example.com" appBase="webapps">  
                <Context path="" docBase="webapp2"/>  
            </Host>  
        </Engine>  
    </Service>  
</Server>  

Apache Tomcat 的域名配置通过 server.xml 中的 Host 和 Context 组件实现灵活的多站点管理，用户可根据需求选择手动编辑配置文件或通过 Host Manager 工具进行管理，在实际部署中，需注意路径匹配、端口冲突及 HTTPS 证书配置等问题，以确保域名访问的稳定性和安全性，通过合理的规划与测试，Tomcat 可高效支持多域名环境下的 Web 应用服务。