上一篇
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 应用目录。
准备工作
-
环境要求
- 已安装 JDK（建议 JDK 8 或以上版本）。
- 已部署 Tomcat（建议 9.0 或以上版本）。
- 已注册域名并解析到服务器的公网 IP（如 example.com 解析至 168.1.100）。
-
目录结构
确保 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 节点：
参数说明：
- 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 工具，支持动态添加虚拟主机：
-
启用 Host Manager
- 修改 $CATALINA_HOME/conf/tomcat-users.xml，添加管理员角色： <role rolename="admin-gui,manager-gui"/> <user username="admin" password="password" roles="admin-gui,manager-gui"/>
-
访问 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 应用服务。
