编程技术是改变世界的力量。
本站
当前位置:网站首页 > 后端语言 > 正文

Tomcat Server.xml配置详解 tomcat的xml配置

gowuye 2024-04-04 11:55 6 浏览 0 评论


在理解Tomcat配置之前,需要先熟悉一下Tomcat的架构,便于更好的修改配置。

一、Tomcat结构

server:即服务器,每个tomcat程序启动后,就是一个server。

service:这是一种抽象的服务,通常是在日志或者管理时使用这样一个概念。它把连接器和处理引擎结合在一起。

connector:用于处理连接和并发,通常包括两种方式HTTP和AJP。HTTP是用于网页地址栏http这种访问方式;AJP一般用于搭配Apache服务器。

engine:处理引擎,所有的请求都是通过处理引擎处理的。

host:虚拟主机,用于进行请求的映射处理。每个虚拟主机可以看做独立的请求文件。

realm:用于配置安全管理角色,通常读取tomcat-uesrs.xml进行验证。

context:上下文,对应于web应用

组件之间的整体关系,总结如下:

一个Server元素中可以有一个或多个Service元素。

一个Service可以包含多个Connector,但是只能包含一个Engine;Connector接收请求,Engine处理请求。

Engine、Host和Context都是容器,且 Engine包含一个或者多个Host。

Host包含零个或多个Context。每个Host组件代表Engine中的一个虚拟主机;

Valve、Realm可以嵌入在Host/Engine/Context元素内。

二、Tomcat目录

三、Server.xml配置

1、<Server>节点

<Server port="8005" shutdown="SHUTDOWN">

属性

描述

示例

className

要使用的java 类名


address

服务器等待接收shutdown 命令的地址,默认localhost


port

接收shutdown命令的端口,设置为-1 为禁用关闭端口,也就是你不能通过这种方式来关闭了,这样就会影响你使用脚本(catalina.sh 或者是shutdown.sh)来stop了,默认绑定8005端口

port="8005"

shutdown

指定shutdown 命令的别名,默认值SHUTDOWN

shutdown="SHUTDOWN"

2、<Service>节点

<Service name="Catalina">

属性

描述

className

要使用的java类名,未指定的话就使用标准的实现

name

service显示的名称

3、 <Connector>节点

<Connector port="8080" protocol="HTTP/1.1" maxHttpHeaderSize="409600" connectionTimeout="20000" redirectPort="8443" />

当前以下所有的说明是针对 tomcat 8.5版本来说的,其他版本详情见官方文档。

参数

含义

示例

port

绑定的端口,如果设置为0,tomcat则随机获取一个空闲端口

默认 port="8080"

protocol

传输协议和版本

默认 protocol = "HTTP/1.1"

connectionTimeout

连接超时时间,单位毫秒

默认 connectionTimeout="20000"

redirectPort

接收到的ssl请求后重定向的端口

默认 redirectPort="8443"

maxThreads

tomcat能创建来处理请求的最大线程数,也为最大并发数 超过则放入请求队列中进行排队,默认值为200;需要根据业务和系统性能进行调整

maxThreads="1000"

URIEncoding

url的字符编码,在tomcat8.5版本中,该值默认为UTF-8,除非在org.apache.catalina.STRICT_SERVLET_COMPLIANCE 将system property 设置为true才会使用ISO-8859-1

URIEncoding="UTF-8"

minProcessors

启动时创建的线程数(最小线程数)

minProcessors="50"

acceptCount

指定当所有可以使用的处理请求的线程数都被使用时,可以放到队列中的请求数,就是被排队的请求数,超过这个数的请求将拒绝连接 默认值为100

acceptcount="500"

acceptorThreadCount

可以用于接受连接的进程数,默认为1,但是在一些多核的的服务器上,我们会将它的值设置为2或者更大的数,来应对一些不活跃的连接。


minSpareThreads

最小空闲线程数,任何情况都会存活的线程数,即便超过了最大空闲时间,也不会被回收,默认值10;

minSpareThreads="25"

maxSpareThreads

最大空闲线程数,在最大空闲时间(maxIdleTime)内活跃过,此时空闲,当空闲时间大于maxIdleTime则被回收,小则继续存活,等待被调度,默认值50;


enableLookups

调用request、getRemoteHost()执行DNS查询,以返回远程主机的主机名,如果设置为false,则直接返回IP地址 默认是禁用的,在请求过滤中的根据远程主机名过滤,需要将该参数设置为true

enableLookups="false"

maxIdleTime

最大空闲时间,超过这个空闲时间,且线程数大于minSpareThreads的,都会被回收,默认值1分钟(60000ms)

maxPostSize

address

对于一些具有多个ip的服务器,我们可以通过该参数指定绑定的ip,默认情况下监听所有的地址

address="192.168.1.110"

compressibleMimeType

该值用来指定哪些文件类型的文件可以进行压缩,默认值为:text/html,text/xml,text/plain,text/css,text/javascript,application/javascript


compression

开启gzip 压缩,可以接受的值是 "off"(禁用压缩),"on"(开启压缩),"force(强制压缩)","1-9"(等效于开启压缩,并且设定压缩等级),开启了压缩,也就意味着要占用更多的cpu资源

compression

compressionMinSize

在compression 参数指定为on后,该参数用来指定压缩的阈值,只有大于该阈值才会被压缩,默认为 2048


keepAliveTimeout

指connector两个HTTP请求直接的等待时间,超过该时间没有接收到第二个HTTP请求就关闭连接,默认是使用connectionTimeout 的值,单位为毫秒


maxConnections

在一定时间内可以接受和处理的最大连接数,达到限制后,服务器接受但不处理该链接,但可以存放到acceptCount,该默认值因连接器类型而异。对于NIO和NIO2,默认值为10000。对于APR / native,默认为8192。


maxCookieCount

请求允许的最大cookie 数,值小于0表示无限制,默认值为 200


disableUploadTimeout

默认是true ,禁用数据上传超时


connectionUploadTimeout

设定数据上传的超时时间,只有在disableUploadTimeout设置为false才生效,单位毫秒

connectionUploadTimeout="50000"

processorCache

进程缓冲器,默认值是maxThreads的值,使用好该值可以提升并发请求。


配置样例

<Connector port="8080"

protocol="HTTP/1.1" connectionTimeout= "20000"redirectPort= "8443"

acceptCount="300" <!--默认值为100-- acceptorThreadCount="2" <!--默认值为1,在多核的情况下可设置该值-->

compression="on" <!-- 开启对响应数据的压缩传输-->

keepAliveTimeout="25000" <!-- 等待请求时间 默认值是使用为connectionTimeout属性设置的值 -->

maxConnections="5000" <!-- 服务器在给定时间接受和处理的最大连接数,对于NIO和NIO2,默认值为10000。对于APR / native,默认为8192。-->

maxThreads="400" <!-- 最大并发数,默认为200-->

minSpareThreads="25" <!-- 始终保持运行的最小连接数,默认值为10--> />

4、<Engine>节点

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

属性

描述

className

要使用的实现的Java类名。

defaultHost

默认的主机名

name

Engine 的名称,在一个server 中使用多个service元素时,必须给每个Engine分配一个唯一的名称

startStopThreads

启动Host 的线程数,默认为1

5、<host>节点

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

属性

描述

name

域名名称,tomcat会将其全部转化为小写,如果你设置的是*.baidu.com,那么你将匹配www.baidu.com admin.baidu.com 等等以baidu.com 结尾的域名。那么只有是符合该域名的条件的请求才能接受。

appBase

指的是虚拟主机的应用程序目录,可以是绝对路径,也可以是相对tomcat目录的相对路径,如果未指定将使用默认值"webapps"

unpackWARs

默认为true,如果设置为true 表示将web应用程序war包解压,false表示直接从war文件运行。注意点1:如果设置为true,tomcat解压了该应该程序的包,会向该解压缩的包里面添加一个文件(/META-INF/war-tracker),用于在tomcat未运行时检测war文件(注意是war文件而不是解压目录里面的文件)是否更改。如果war文件更改了,则会重新加载。是针对未启动的时候啊,如果是tomcat正常启动的话更改war包的话是会自动重新加载发布的。注意点2: 如果该属性设置为false的话将导致性能下降

autoDeploy

指tomcat在运行时是否要定期检查有没有新的应用程序,如果true,tomcat会定期检查appBase 和xmlBase 目录,如果找到了会自动部署的web应用程序,默认为true

xmlBase

指包含该Host部署的应用程序的Context的xml文件路径。可以是绝对路径也可以是相对tomcat目录的相对路径。如果未指定将使用"conf//"

createDirs

指在tomcat启动的时候将创建appBase和xmlBase定义的目录,默认为true

className

要使用的实现的Java类名,如果没有指定,将使用标准值。

deployIgnore

这个属性是相对appBase的,foo只能匹配文件或者目录foo,而不能匹配foo.war

deployOnStartup

指tomcat在启动时是否应该自动部署来自该Host的web应用程序,默认为true

startStopThreads

指Host用于启动Context的线程数,默认值为1

undeployOldVersions

在自动部署的情况下,tomcat是否检查旧的未使用的web应用程序,如果找到,将其删除,在autoDeploy为true且本属性为true才生效,默认值为false

deployXML

如果你不想使用web应用程序的/META-INF/context.xml,你可以将该值设置为false,线上环境也建议设置为false,

copyXML

该属性的值如果设置为true,会在程序启动时(且xmlBase无该应用程序对应的xml文件)将位于应用程序的/META-INF/context.xml 的文件,复制到xmlBase下,如果有的话是不会复制的,后续是会以xmlBase里的xml的配置为主的,即使应用程序的/META-INF/context.xml更新了,也是不会生效的。默认为false. copyXML的属性要生效的话前提得deployXML 属性为true,否则不生效。

workDir

指该Host 应用程序要使用的临时目录的路径名,如果在Context中也指定了workDir将替换掉这里的配置,如果未指定,默认为$CATALINA_BASE/work。

当autoDeploy 为true 时,tomcat 在启动后会监控部署的web应用程序的文件是否改变,根据具体的改变,web应用程序将重新加载或重新部署。重新部署的不会保留用户会话,重新加载的则会保留。

Context 中的docBase 的路径应该在appBase(Host)之外,否则可能会导致部署两次,属性deployIgnore可以避免这种情况。

如果在server.xml 中定义了Context 属性,则应该关闭deployIgnore,和自动部署应用程序。

6、<Valve>节点中的访问日志记录部分

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

属性

描述

buffered

是否缓冲日志记录,默认为True,如果设置为false,则在每次请求后将写入访问日志记录

className

要使用的实现的java类名

directory

存放日志文件的目录的相对路径或者绝对路径,默认值为$ CATALINA_BASE/logs

encoding

用于写日志文件的字符集。空字符串表示使用系统默认字符集。默认值:使用系统默认字符集。

fileDateFormat

设定访问日志文件切割时间,默认值为.yyyy-MM-dd,也就是每天切割一次,如果你希望每小时切割一次则设置为.yyyy-MM-dd.HH

maxDays

保留日志的最大天数,如果未指定的话,默认值为-1,意味着将永远不会删除旧文件

maxLogMessageBufferSize

日志消息缓冲区大小,默认大小为256bytes,该值应该设置为大于常规日志的消息大小

prefix

日志前缀,为每个日志文件名称的开头,如果未指定,则默认值为"access_log"

renameOnRotate

设置为true 时,当天的日志是不会带有时间戳的,过往日志是会带有的,设置为false当天的日志也带有时间戳的,默认为false

rotatable

用于设置日志是否切割的标准,默认为true,如果设置为false的话,则该文件永远不会被切割,且忽略参数fileDateFormat

suffix

日志文件的后缀名称,默认为"",表示不添加后缀

pattern

是指日志格式,也就是我们日志输出的内容和格式具体配置见下文

pattern

%a - 远程IP地址 
%A - 本地IP地址 
%b - 发送的字节数,不包括HTTP标头,如果为零则为“ - ” 
%B - 发送的字节数,不包括HTTP标头 
%h - 远程主机名(如果enableLookups连接器为false,则为IP地址 )
%H - 请求协议 %l - 来自identd的远程逻辑用户名(始终返回' - ')
%m - 请求方法(GET,POST等) %p - 收到此请求的本地端口。
%q - 查询字符串(前缀为'?',如果存在) 
%r - 请求首行(方法和请求URI) 
%s - 响应的HTTP状态代码 
%S - 用户会话ID 
%t - 日期和时间,采用通用日志格式 
%u - 经过身份验证的远程用户(如果有),否则为“ - ” 
%U - 请求的URL路径 %v - 本地服务器名称 
%D - 处理请求所用的时间(以毫秒为单位) 
%T - 处理请求所用的时间,以秒为单位 
%F - 提交响应所用的时间,以毫秒为单位 
%I - 当前请求线程名称 
%X - 响应完成时的连接状态: X =连接在响应完成之前中止。 + =发送响应后,连接可以保持活动状态。 - =发送响应后将关闭连接。

pattern="common" 对应于'%h%l%u%t“%r”%s%b'定义的通用日志格式 。
pattern="combined" 将 每个双引号中的Referer和User-Agent标题的值附加到common模式。

7、<context>节点

<Context docBase="/tmp/foo" reloadable="false" />

属性

描述

示例

docBase

web应用程序的路径,如果使用了符号链接的话,那么更改了链接的话需要重新启动tomcat才能生效

docBase="/tmp/svnadmin.war"

override

设置为true,则忽略全局中的设置,以现有的来覆盖之前的,默认为false


path

匹配对应的web应用,与请求的url的开头匹配,如果指定为""的话,该应用接收未匹配的所有请求


reloadable

设置为true表示Catalina将监视 /WEB-INF/classes/和/WEB-INF/lib的文件,一旦发生更改将自动重新加载Web应用程序。它可以在在开发的时候使用,但需要消耗更多资源,官方文档写到不建议在生产环境上使用,所以它的默认值是false.


workDir

设置临时文件和目录的路径,如果未指定,默认临时目录在在$CATALINA_BASE/work


preemptiveAuthentication

默认为false,当设置为true,用户为不受安全约束保护的资源提供凭据,如果身份验证器支持抢占式身份验证,那么将处理用户的凭据,该参数和过滤请求中的属性invalidAuthenticationWhenDeny关联


除了server.xml 外,任何定义Context的文件只能定义一个context 元素

资料收集与网上,感谢网友分享。参考链接如下。

Tomcat 6 —— Realm域管理

详解Tomcat 配置文件server.xml

官方配置说明

如果本文对你有帮助,别忘记给我个3连 ,点赞,转发,评论,

咱们下期见

相关推荐

嵌入式C语言中常量的应用实例(嵌入式c语言中常量的应用实例是什么)

常量,我们都知道,就是数值保持不变的量。在C语言中,常量一旦初始化了,它的值将在整个程序运行周期内,不允许发生任何变化。常量与变量是相对的,我们实际项目中经常会用到它。定义常量的两种方式C语言中主要有...

C语言编程基础知识汇总学习,适合初学者!更新常量知识

(二)整型常量整型常量有3种形式:十进制整型常量、八进制整型常量和十六进制整型常量。(注意:c语言中没有直接表示二进制的整型常量,在c语言源程序中不会出现二进制。)书写方式如下:十进制整型常量:123...

【C语言】第二章第六节:字符串常量

第二章第六节:字符串常量。下表C语言中的常用转义字符。·字符形式功能:ASCIl码(十进制形式)。→\t水平制表(横向跳格:跳到下一个tab位置)。→\b退格8。→\r回车(不换行,光标移到本行行首)...

「GCTT 出品」Go 系列教程——5. 常量

这是我们Golang系列教程的第五篇。定义在Go语言中,术语”常量”用于表示固定的值。比如5、-89、IloveGo、67.89等等。看看下面的代码:varaint=50v...

每日C语言-常量指针、指针常量、指向常量的指针常量

一、常量指针1)什么是常量指针?通过该指针不可以修改其所指向存储单元中的值指针本身即地址可以被修改2)定义:类型说明符const*指针变量;类型说明符表示指针所指向存储单元中的值得数据类型指针...

C语言-符号常量、常变量、变量之我见

更新内容:新增音频。音频和文章一起更配oHello,大家好,又和大家见面了~~相信很多朋友们听了C语言的“符号常量”、“常变量”、“变量”后还是对这三者一脸懵逼吧。不管老师怎么歇斯底里地讲解,同学们迷...

零基础带你学习C语言:四:探索常量与变量

前言常量与变量学习;一:分析:short、float、long类型#include<stdio.h>intmain(){shortage=18;floatweight=12...

C语言中是如何定义常量的?那定义字符串呢?

常量有整型常量、浮点型常量、字符型常量及字符串常量。‘常量定义是指定义符号常量,用一个标识符来代表一个常量,通过宏定义预处理指令来实现。常量的定义:#definecount60这就定义了一个常量...

C语言符号常量的优点,会是那几点?

符号常量是一个常量,是不变量,所以,在编译的时候,就把符号常量出现的地方,替换为符号常量对应的常量。符号常量一般用户定义一个全局使用的数据,而且要改变该数据的时候,只需要改变符号常量的值,代码中引用符...

嵌入式开发- C语言数据类型-常量(c语言嵌入式是干嘛的)

基本数据类型的常量-掌握**整型常量:**常量是指在程序运行期间其数值不发生变化的数据。整型常量通常简称为整数整数可以是十进制数、八进制数、十六进制数八进制06334十六进制0xd1...

c语言解剖课:只读变量、常量、字面量傻傻分不清?

写在前面本篇主题的缘起,是因为一个计算机专业的大学生在和我讨论c语言问题时,说const常量如何如何,我说变量被const修饰了,还是变量,不是“常量”。他给了我一个截图:他说大模型都是这样回答的,变...

C/C++编程笔记:C数组、字符串常量和指针!三分钟弄懂它

想弄懂C语言中数组和指针的关系吗?这篇文章就占据你三分钟时间,看完你肯定会有收获!数组数组声明为数据类型名称[constant-size],并将一个数据类型的一个或多个实例分组到一个可寻址的位...

C语言入门到精通【第008讲】——C语言常量

C语言常量常量是固定值,在程序执行期间不会改变。这些固定的值,又叫做字面量。常量可以是任何的基本数据类型,比如整数常量、浮点常量、字符常量,或字符串字面值,也有枚举常量。常量就像是常规的变量,只不过常...

这是C语言无法修改得东西,C语言基础教程之常量解析

常量是指程序在执行期间不会改变的固定值。这些固定值也称为文字。常量可以是任何基本数据类型,如整数常量,浮点常量,字符常量或字符串文字,还有枚举常量。常量被视为常规变量,除了它们的值在定义后无法修改。整...

C语言中的单精度、双精度、常量等都有什么意思?

刚接触C语言时,对于常量,变量,浮点,单精度,双精度等问题的理解,大都很模糊不清,其实在程序运行过程中,其值不能改变的量称为常量。如12、0、-3为整型常量,4.6、-1.23为实型常量,'a'、'...

取消回复欢迎 发表评论: