server.xml 是 Tomcat 核心配置文件,关键含 Connector(控制请求接入,如端口、协议、线程、SSL)和 Host(定义虚拟主机与应用部署路径),二者协同通过 Host 头匹配路由请求。
Tomcat 的 server.xml 是核心配置文件,直接影响 Web 应用的访问方式、性能和安全性。其中 Connector 和 Host 是最关键的两个配置块:前者定义如何接收请求(端口、协议、线程、SSL 等),后者定义虚拟主机与应用部署路径的映射关系。
Connector 元素负责监听并处理客户端请求。一个 Tomcat 实例可配置多个 Connector,比如同时启用 HTTP 和 HTTPS 接入。
port 指监听端口;connectionTimeout 是连接建立后无数据时的超时(毫秒);redirectPort 在需要重定向到 HTTPS 时生效;maxThreads 控制最大并发请求数,影响吞吐能力。protocol="org.apache.coyote.http11.Http11NioProtocol"(推荐 NIO)及 SSL 相关属性:sslProtocol="TLS"、keystoreFile="/path/to/keystore.jks"、keystorePass="changeit"。sslEnabledProtocols="TLSv1.2,TLSv1.3"。acceptCount:当所有线程忙时,等待队列长度(默认 100);minSpareThreads 和 maxSpareThreads:空闲线程上下限(新版 Tomcat 中 maxSpareThreads 已废弃);compression="on" + compressableMimeType 可启用 GZIP 压缩,减少传输体积。Host 元素代表一个虚拟主机,通常对应一个域名或 IP。每个 Host 下可部署多个 Web 应用(通过 Context 或自动扫描 webapps 目录)。
name 是匹配请求头中 Host 字段的值(如浏览器地址栏域名);appBase 是该 Host 下 Web 应用的根目录,默认为 $CATALINA_HOME/webapps。Host 实现不同域名指向不同应用:
反向代理(如 Nginx),则由代理转发 Host 头,Tomcat 依赖该头做路由。unpackWARs="true":自动解压 WAR 包(设为 false 可提升启动速度,但部分功能受限);autoDeploy="true":运行时监控 appBase 目录,自动部署新增或更新的 WAR;deployOnStartup="true":启动时加载已存在的应用(默认开启)。两者不直接嵌套,但行为紧密关联:Connector 接收请求后,根据请求中的 Host 头匹配对应的 Host 元素,再由该 Host 查找匹配的 Context(即应用)来处理。
Host: example.com,而 server.xml 中没有 ,Tomcat 将交由默认 Host(name 属性匹配失败时的第一个 Host)处理,通常是 localhost。 支持多个域名指向同一 Host:
www.main.site
alias.site
autoDeploy 和 deployOnStartup,改用 Manager App 或脚本手动部署,避免热部署引发的类加载问题或内存泄漏。基本上就这些。server.xml 不复杂但容易忽略细节,修改后务必重启 Tomcat 并验证日志(catalina.out)是否报错。线上环境建议备份原文件,并避免在 Host 内直接写 Context(应使用独立 context.xml 文件或 conf/Catalina/[host]/[app].xml 方式管理)。