【Tomcat】Tomcat服务器核心配置说明及标签-云科普blog

【Tomcat】Tomcat服务器核心配置说明及标签

# it 2021-01-25 00:17 0 24 来源：云科普blog

首先带着疑问

问题一：去哪配置?
核心配置在Tomcat目录下 conf/目录下的server.xml文件中

问题二：怎么配置？

如下

Tomcat 作为服务器的配置，主要是 server.xml ⽂件的配置；
server.xml中包含了 Servlet容器的相关配置，即 Catalina 的配置；

【Tomcat】Tomcat服务器核心配置说明及标签

一，主要标签结构

<!--
	Server 根元素，创建⼀个Server实例，⼦标签有 Listener、GlobalNamingResources、Service
-->
<Server>
     <!--定义监听器-->
     <Listener/>
     <!--定义服务器的全局JNDI资源 -->
     <GlobalNamingResources/>
     <!-- 定义⼀个Service服务，⼀个Server标签可以有多个Service服务实例 -->
 	<Service/>
</Server>

二，Server标签

标签属性：

port
shutdown

说明Tomcat来监听port端口来执行关闭

<!--
	port：关闭服务器的监听端⼝
	shutdown：关闭服务器的指令字符串
-->
<Server port="8005" shutdown="SHUTDOWN">
     <!-- 以⽇志形式输出服务器 、操作系统、JVM的版本信息 -->
     <Listener className="org.apache.catalina.startup.VersionLoggerListener" />
     <!-- Security listener. Documentation at /docs/config/listeners.html
     <Listener className="org.apache.catalina.security.SecurityListener" />
     -->
     <!--APR library loader. Documentation at /docs/apr.html -->
     <!-- 加载（服务器启动） 和 销毁 （服务器停⽌） APR。 如果找不到APR库， 则会输出⽇志， 并不影响 Tomcat启动 -->
     <Listener className="org.apache.catalina.core.AprLifecycleListener" SSLEngine="on" />
     <!-- Prevent memory leaks due to use of particular java/javax APIs-->
     <!-- 避免JRE内存泄漏问题 -->
     <Listener className="org.apache.catalina.core.JreMemoryLeakPreventionListener" />
     <!-- 加载（服务器启动） 和 销毁（服务器停⽌） 全局命名服务 -->
     <Listener className="org.apache.catalina.mbeans.GlobalResourcesLifecycleListener" />
     <!-- 在Context停⽌时重建 Executor 池中的线程， 以避免ThreadLocal 相关的内存泄漏 -->
     <Listener className="org.apache.catalina.core.ThreadLocalLeakPreventionListener" />


     <!-- Global JNDI resources Documentation at /docs/jndi-resources-howto.html 
        GlobalNamingResources 中定义了全局命名服务
     -->
     <GlobalNamingResources>
     <!-- Editable user database that can also be used by
     UserDatabaseRealm to authenticate users
     -->
     <Resource name="UserDatabase" auth="Container"
         type="org.apache.catalina.UserDatabase"
         description="User database that can be updated and saved"
         factory="org.apache.catalina.users.MemoryUserDatabaseFactory"
         pathname="conf/tomcat-users.xml" />
     </GlobalNamingResources>
     <!-- A "Service" is a collection of one or more "Connectors" that share
         a single "Container" Note: A "Service" is not itself a "Container",
         so you may not define subcomponents such as "Valves" at this level.
         Documentation at /docs/config/service.html
     -->
     <Service name="Catalina">
         ...
     </Service>
</Server>

子标签：

Listener
- VersionLoggerListener（以⽇志形式输出服务器、操作系统、JVM的版本信息）
- AprLifecycleListener （加载（服务器启动）和销毁（服务器停⽌） APR。如果找不到APR库，则会输出⽇志，并不影响 Tomcat启动）
- JreMemoryLeakPreventionListener （避免JRE内存泄漏问题）
- GlobalResourcesLifecycleListener （加载（服务器启动）和销毁（服务器停⽌）全局命名服务）
- ThreadLocalLeakPreventionListener （在Context停⽌时重建 Executor 池中的线程，以避免ThreadLocal 相关的内存泄漏）
GlobalNamingResources （中定义了全局命名服务）
Service （如下）

以上标签Listener、GlobalNamingResources一般情况下保持默认即可，不需要而外操作，重点在于Service 标签

三，Service 标签

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

该标签⽤于创建 Service 实例，默认使⽤ org.apache.catalina.core.StandardService。默认情况下，Tomcat 仅指定了Service 的名称，值为 "Catalina"。

子标签：

Listener (Listener ⽤于为Service添加⽣命周期监听器)
Executor (⽤于配置Service 共享线程池，给Connector使用)
Connector （⽤于配置Service 包含的链接器）
Engine （⽤于配置Service中链接器对应的Servlet 容器引擎）

四，Executor 标签

用来定义共享线程池的。

【Tomcat】Tomcat服务器核心配置说明及标签

默认是被注释掉的，且属性不全。那么该如何使用呢?

默认情况下，Service 并未添加共享线程池配置。如果我们想添加⼀个线程池，可以在下添加如下配置：

<Executor name="commonThreadPool"
 	namePrefix="thread-exec-"
 	maxThreads="200"
 	minSpareThreads="100"
 	maxIdleTime="60000"
 	maxQueueSize="Integer.MAX_VALUE"
 	prestartminSpareThreads="false"
 	threadPriority="5"
 	className="org.apache.catalina.core.StandardThreadExecutor"/>

属性：

name：线程池名称，⽤于 Connector中指定
namePrefix：所创建的每个线程的名称前缀，⼀个单独的线程名称为 namePrefix+threadNumber
maxThreads：池中最⼤线程数
minSpareThreads：活跃线程数，也就是核⼼池线程数，这些线程不会被销毁，会⼀直存在
maxIdleTime：线程空闲时间，超过该时间后，空闲线程会被销毁，默认值为6000（1分钟），单位毫秒
maxQueueSize：在被执⾏前最⼤线程排队数⽬，默认为Int的最⼤值，也就是⼴义的⽆限。除⾮特殊情况，这个值不需要更改，否则会有请求不会被处理的情况发⽣
prestartminSpareThreads：启动线程池时是否启动 minSpareThreads部分线程。默认值为 false，即不启动
threadPriority：线程池中线程优先级，默认值为5，值从1到10
className：线程池实现类，未指定情况下，默认实现类为：
org.apache.catalina.core.StandardThreadExecutor。如果想使⽤⾃定义线程池⾸先需要实现 org.apache.catalina.Executor接⼝

五，Connector标签

Connector 标签⽤于创建链接器实例默认情况下，server.xml配置了两个链接器，⼀个⽀持HTTP协议，⼀个⽀持AJP协议，⼤多数情况下，我们并不需要新增链接器配置，只是根据需要对已有链接器进⾏优化。

<!--org.apache.coyote.http11.Http11NioProtocol ， ⾮阻塞式 Java NIO 链接器-->
<Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" />
<Connector port="8009" protocol="AJP/1.3" redirectPort="8443" />

属性：

port：端⼝号，Connector ⽤于创建服务端Socket 并进⾏监听，以等待客户端请求链接。如果该属性设置为0， Tomcat将会随机选择⼀个可⽤的端⼝号给当前Connector 使⽤
protocol：当前Connector ⽀持的访问协议。默认为 HTTP/1.1 ，并采⽤⾃动切换机制选择⼀个基于 JAVA NIO 的链接器或者基于本地APR的链接器（根据本地是否含有Tomcat的本地库判定）
connectionTimeOut: Connector接收链接后的等待超时时间，单位为毫秒。 -1 表示不超时。
redirectPort：当前Connector 不⽀持SSL请求，接收到了⼀个请求，并且也符合security-constraint 约束，需要SSL传输，Catalina⾃动将请求重定向到指定的端⼝。比如说：如果访问的是8080端口，然后它发现是一个https的请求，那么他就会转发到8443端口，当然也可以直接访问8443端口
executor：指定共享线程池的名称(就是Executor标签的name属性)，也可以通过maxThreads、minSpareThreads等属性配置内部线程池。
URIEncoding: ⽤于指定编码URI的字符编码， Tomcat8.x版本默认的编码为 UTF-8 , Tomcat7.x版本默认为ISO8859-1

可以使用共享线程池：

<Connector port="8080"
     protocol="HTTP/1.1"
     executor="commonThreadPool"
     maxThreads="1000"		
     minSpareThreads="100"
     acceptCount="1000"	//往往和maxThreads保持一致
     maxConnections="1000" //往往和maxThreads保持一致
     connectionTimeout="20000"
     compression="on"	//要不要启动gzip压缩
     compressionMinSize="2048" //压缩处理的最小大小，超过此大小才压缩
     disableUploadTimeout="true" //单独的给servlet放宽超时时间
     redirectPort="8443"
     URIEncoding="UTF-8" />

可以看到Connector标签和Executor都有maxThreads和minSpareThreads标签。

每一个Connector都可以自己定义一个线程池，如果每个Connector都自己定义线程池就浪费了。所以为什么不用一个呢？于是就有了Executor标签来定义一个共享线程池。

六，Engine标签

Engine 表示 Servlet 引擎

<Engine name="Catalina" defaultHost="localhost">
 ...
</Engine>

属性：

name：⽤于指定Engine 的名称，默认为Catalina
defaultHost：默认使⽤的虚拟主机名称，当客户端请求指向的主机⽆效时，将交由默认的虚拟主机处理，默认为localhost

【Tomcat】Tomcat服务器核心配置说明及标签

子标签：

Cluster：集群方面的标签
Realm：验证安全的标签
Host：⽤于配置⼀个虚拟主机

七，Host标签

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

标签属性：

appBase：这个网站的程序存放的位置，可以是绝对路径也可以是相对路径。webapps就是相对路径，在tomcat的根目录下
unpackWARs：默认为true，把war包解压成文件夹
autoDeploy：自动部署，当资源变更时自动部署，类似于热部署

子标签：

<Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs"
               prefix="localhost_access_log" suffix=".txt"
               pattern="%h %l %u %t &quot;%r&quot; %s %b" />

当请求来临时，日志存放起来，

存放在directory值的目录
prefix：日志文件前缀
suffix：日志文件后缀
pattern：打印的日志格式

启动Tomcat 浏览器输入：http://localhost:8080

【Tomcat】Tomcat服务器核心配置说明及标签

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

hostname是localhost，appBase是webapps，去webapps文件夹下找应用程序文件夹，没有指定，默认就去ROOT文件夹下：
【Tomcat】Tomcat服务器核心配置说明及标签

我们来做个实验：

把host标签复制一份，两个host标签的name分别为www.abc.com，www.def.com。appBase分别为webapps、webapps2
进入Tomcat根目录，把webapps拷贝一份到根目录，命名为webapps2
为了方便区分，把webapps2/ROOT/index.jsp 中的Home改为Home-webapps2
重新启动Tomcat
配置hosts文件
访问浏览器http://localhost:8080、 http://www.abc.com和http/www.def.com
可以看到：

可以看到localhost:8080访问不到了，因为这个虚拟主机被我们修改了

而abc和def均可以找到。同时def.com的Home也被修改为Home-webapps2了。

八，Context标签

用于配置一个Web应用——一个虚拟主机下可以配置多个应用

<Host name="www.abc.com" appBase="webapps" unpackWARs="true"
autoDeploy="true">
<!--
 docBase：Web应⽤⽬录或者War包的部署路径。可以是绝对路径，也可以是相对于 Host appBase的
相对路径。
 path：Web应⽤的Context 路径。如果我们Host名为localhost， 则该web应⽤访问的根路径为：
 http://localhost:8080/web_demo。
-->
 <Context docBase="E://dengxhh" path="/dengxh"></Context>

 <Valve className="org.apache.catalina.valves.AccessLogValve"
directory="logs"
 prefix="localhost_access_log" suffix=".txt"
 pattern="%h %l %u %t &quot;%r&quot; %s %b" />
</Host>

刚才我们访问的是http://www.abc.com:8080，那么现在我想输入http://www.abc.com:8080/dengxh，dengxh所代表的位置是我的磁盘上的某个文件夹，这个文件夹里放的我的程序资源。如何做？

为了方便演示，我们就拿ROOT中的程序做例子，把webapps中的ROOT文件夹复制到E盘根目录，取名为dengxhh
在Host标签中，增加 <Context docBase="E://dengxhh" path="/dengxh"></Context>
重启Tomcat，访问www.abc.com/dengxh/ ，成功跳转了。

如此操作就可以在一个虚拟主机中，配置多个应用，只需要在host标签中配置多个Context标签，区分的时候只需要在虚拟主机后跟上Context的path属性的值即可找到对应的资源。
例如：Host name="www.abc.com" ，Context path ="dengxh" ，那么浏览器中输入 www.abc.com/dengxh即可。