Tomcat的server.xml文件配置详解 Connector和Host设置

server.xml 是 Tomcat 核心配置文件，关键含 Connector（控制请求接入，如端口、协议、线程、SSL）和 Host（定义虚拟主机与应用部署路径），二者协同通过 Host 头匹配路由请求。

Tomcat 的 server.xml 是核心配置文件，直接影响 Web 应用的访问方式、性能和安全性。其中 Connector 和 Host 是最关键的两个配置块：前者定义如何接收请求（端口、协议、线程、SSL 等），后者定义虚拟主机与应用部署路径的映射关系。

Connector 配置：控制请求接入方式

Connector 元素负责监听并处理客户端请求。一个 Tomcat 实例可配置多个 Connector，比如同时启用 HTTP 和 HTTPS 接入。

• 基础 HTTP Connector 示例：
          connectionTimeout="20000"
          redirectPort="8443"
          maxThreads="200" />
  port 指监听端口；connectionTimeout 是连接建立后无数据时的超时（毫秒）；redirectPort 在需要重定向到 HTTPS 时生效；maxThreads 控制最大并发请求数，影响吞吐能力。
• 启用 HTTPS 的 Connector：
  需指定 protocol="org.apache.coyote.http11.Http11NioProtocol"（推荐 NIO）及 SSL 相关属性：
  sslProtocol="TLS"、keystoreFile="/path/to/keystore.jks"、keystorePass="changeit"。
  注意：从 Tomcat 10 开始默认禁用 TLSv1 和 TLSv1.1，建议显式配置 sslEnabledProtocols="TLSv1.2,TLSv1.3"。
• 常见调优项：
  – acceptCount：当所有线程忙时，等待队列长度（默认 100）；
  – minSpareThreads 和 maxSpareThreads：空闲线程上下限（新版 Tomcat 中 maxSpareThreads 已废弃）；
  – compression="on" + compressableMimeType 可启用 GZIP 压缩，减少传输体积。

Host 配置：定义虚拟主机与应用部署逻辑

Host 元素代表一个虚拟主机，通常对应一个域名或 IP。每个 Host 下可部署多个 Web 应用（通过 Context 或自动扫描 webapps 目录）。

• 基本 Host 示例：
  appBase="webapps"
          unpackWARs="true" autoDeploy="true">
           directory="logs" prefix="localhost_access_log" suffix=".txt"
        pattern="%h %l %u %t "%r" %s %b" />
  
  name 是匹配请求头中 Host 字段的值（如浏览器地址栏域名）；appBase 是该 Host 下 Web 应用的根目录，默认为 $CATALINA_HOME/webapps。
• 多域名支持：
  可通过多个 Host 实现不同域名指向不同应用：
  
  
  注意：DNS 或 hosts 文件需确保域名能解析到服务器 IP；若使用反向代理（如 Nginx），则由代理转发 Host 头，Tomcat 依赖该头做路由。
• 关键属性说明：
  – unpackWARs="true"：自动解压 WAR 包（设为 false 可提升启动速度，但部分功能受限）；
  – autoDeploy="true"：运行时监控 appBase 目录，自动部署新增或更新的 WAR；
  – deployOnStartup="true"：启动时加载已存在的应用（默认开启）。

Connector 与 Host 协同工作的关键点

两者不直接嵌套，但行为紧密关联：Connector 接收请求后，根据请求中的 Host 头匹配对应的 Host 元素，再由该 Host 查找匹配的 Context（即应用）来处理。

• 若请求头中 Host: example.com，而 server.xml 中没有 ，Tomcat 将交由默认 Host（name 属性匹配失败时的第一个 Host）处理，通常是 localhost。
• 可在 Host 内嵌套 支持多个域名指向同一 Host：
  

  
  
    www.main.site
  
    alias.site
  
  

• 生产环境建议关闭 autoDeploy 和 deployOnStartup，改用 Manager App 或脚本手动部署，避免热部署引发的类加载问题或内存泄漏。

基本上就这些。server.xml 不复杂但容易忽略细节，修改后务必重启 Tomcat 并验证日志（catalina.out）是否报错。线上环境建议备份原文件，并避免在 Host 内直接写 Context（应使用独立 context.xml 文件或 conf/Catalina/[host]/[app].xml 方式管理）。