Tomcat Server.xml部分配置说明

Service
简介

属性

样本

Connector
简介

属性

样本

Engine
简介

属性

样本

子元素
Host
简介

属性

样本

Alias
样本

Context
简介

属性

样本

子元素
valve
简介

属性

样本

Service

简介

一个服务组件通常包含一个引擎和与此引擎相关联的一个或多个连接器。给服务命名可以方便管理员在日志文件中识别不同服务产生的日志。一个server可以包含多个service组件，但通常情下只为一个service指派一个server。

属性

name: 此服务的名称，默认为Catalina；

className: 用于实现service的类名，一般都是

org.apache.catalina.core.StandardService

样本

<Service name="Catalina"></Service>

Connector

简介

连接器，用以连接客户端（可以是浏览器或Web服务器这可能是Apache, IIS, Nginx等）请求至Servlet容器，Tomcat应该考虑工作情形并为相应情形下的请求分别定义好需要的连接器才能正确接收来自于客户端的请求。一个引擎(Engine)可以有一个或多个连接器，以适应多种请求方式。常见连接器种类：

1) HTTP连接器

2) SSL连接器

3) AJP 1.3连接器

4) proxy连接器

属性

定义连接器时可以配置的属性非常多，但通常定义HTTP连接器时必须定义的属性只有“port”，定义AJP连接器时必须定义的属性只有”protocol”，因为默认的协议为HTTP。以下为常用属性的说明：

1) address：指定连接器监听的地址，默认为所有地址，即0.0.0.0；

2) maxThreads：支持的最大并发连接数，默认为200；

3) port：监听的端口，默认为0；

4) protocol：连接器使用的协议，默认为HTTP/1.1，定义AJP协议时通常为AJP/1.3；

5) redirectPort：如果某连接器支持的协议是HTTP，当接收客户端发来的HTTPS请求时，则转发至此属性定义的端口；

6) connectionTimeout：等待客户端发送请求的超时时间，单位为毫秒，默认为60000，即1分钟；

7) enableLookups：是否通过request.getRemoteHost()进行DNS查询以获取客户端的主机名；默认为true；

8) acceptCount：设置等待队列的最大长度；通常在tomcat所有处理线程均处于繁忙状态时，新发来的请求将被放置于等待队列中；

样本

<Connector port="8008" protocol="AJP/1.3" redirectPort="8443" />

Engine

简介

Engine是Servlet处理器的一个实例，即servlet引擎，默认为定义在server.xml中的Catalina。Engine需要defaultHost属性来为其定义一个接收所有发往非明确定义虚拟主机的请求的host组件。

属性

defaultHost：Tomcat支持基于FQDN的虚拟主机，这些虚拟主机可以通过在Engine容器中定义多个不同的Host组件来实现；但如果此引擎的连接器收到一个发往非非明确定义虚拟主机的请求时则需要将此请求发往一个默认的虚拟主机进行处理，因此，在Engine中定义的多个虚拟主机的主机名称中至少要有一个跟defaultHost定义的主机名称同名；

name：Engine组件的名称，用于日志和错误信息记录时区别不同的引擎

样本

<Service name="Catalina"></Service>

子元素

Host

简介

主机组件类似于Apache中的虚拟主机，但在Tomcat中只支持基于FQDN的“虚拟主机”。一个引擎至少要包含一个主机组件。

属性

appBase：此Host的webapps目录，即存放非归档的web应用程序的目录或归档后的WAR文件的目录路径；可以使用基于$CATALINA_HOME的相对路径；

autoDeploy：在Tomcat处于运行状态时放置于appBase目录中的应用程序文件是否自动进行deploy；默认为true；

unpackWars：在启用此webapps时是否对WAR格式的归档文件先进行展开；默认为true；

样本

<Host name="localhost"  appBase="webapps"
unpackWARs="true" autoDeploy="true">
</Host>

Alias

如果一个主机有两个或两个以上的主机名，额外的名称均可以以别名的形式进行定义

样本

<Host name="localhost"  appBase="webapps"
unpackWARs="true" autoDeploy="true">
<Alias>test.com</Alias>
</Host>

Context

简介

Context组件是最内层次的组件，它表示Web应用程序本身。配置一个Context最主要的是指定Web应用程序的根目录，以便Servlet容器能够将用户请求发往正确的位置。Context组件也可包含自定义的错误页，以实现在用户访问发生错误时提供友好的提示信息。

属性

docBase：相应的Web应用程序的存放位置；也可以使用相对路径，起始路径为此Context所属Host中appBase定义的路径；切记，docBase的路径名不能与相应的Host中appBase中定义的路径名有包含关系，比如，如果appBase为deploy，而docBase绝不能为deploy-bbs类的名字(默认应该是ROOT??)；

path：相对于Web服务器根路径而言的URI；如果为空“”，则表示为此webapp的根路径；如果context定义在一个单独的xml文件中，此属性不需要定(下面的配置中就应该这么访问了http://ip:8080/bbs 会自动访问index.jsp)；

reloadable：是否允许重新加载此context相关的Web应用程序的类；默认为false；

样本

<Host name="helloWorld"  appBase="/web/123"
unpackWARs="true" autoDeploy="true">
<Context path="bbs" docBase="/CHANGE"/>
</Host>

子元素

valve

简介

类似于过滤器，它可以工作于Engine和Host/Context之间、Host和Context之间以及Context和Web应用程序的某资源之间。一个容器内可以建立多个Valve，而且Valve定义的次序也决定了它们生效的次序。

常见的两种Valve：

RemoteHostValve:基于主机名称的访问控制,,控制本身可以通过allow或deny来进行定义

RemoteAddrValve:基于IP地址的访问控,,控制本身可以通过allow或deny来进行定义

属性

className：相关的Java实现的类名，相应于分别应该为org.apache.catalina.valves.RemoteHostValve或org.apache.catalina.valves.RemoteAddrValve；

allow：以逗号分开的允许访问的IP地址列表，支持正则表达式，因此，点号“.”用于IP地址时需要转义；仅定义allow项时，非明确allow的地址均被deny；

deny: 以逗号分开的禁止访问的IP地址列表，支持正则表达式；使用方式同allow；

样本

<Context path="/probe" docBase="probe">
<Valve className="org.apache.catalina.valves.RemoteAddrValve"
allow="127\.0\.0\.1"/>
</Context>