tomcat常用配置详解

转载

nuli888 2023-09-26 10:14:32 博主文章分类：java

文章标签 xml tomcat apache 文章分类 JavaScript 前端开发

1 目录结构
/bin：脚本文件目录。
/common/lib：存放所有web项目都可以访问的公共jar包（使用Common类加载器加载）。
/conf：存放配置文件，最重要的是server.xml。
/logs：存放日志文件。
/server/webapps：来管理Tomcat-web服务用的。仅对TOMCAT可见，对所有的WEB APP都不可见（使用Catalina类加载器加载）。
/shared/lib：仅对所有WEB APP可见，对TOMCAT不可见（使用Shared类加载器加载）。
/temp：Tomcat运行时候存放临时文件用的。
/webapps：web应用发布目录。
/work：Tomcat把各种由jsp生成的servlet文件放在这个目录下。删除后，启动时会自动创建。

2 配置文件
server.xml：主要的配置文件。
web.xml：缺省的web app配置，WEB-INF/web.xml会覆盖该配置。
context.xml：不清楚跟server.xml里面的context是否有关系。

server.xml配置
server标签
port：指定一个端口，这个端口负责监听关闭tomcat的请求。
shutdown：指定向端口发送的命令字符串。

service标签
name：指定service的名字。

Connector(表示客户端和service之间的连接)标签
port：指定服务器端要创建的端口号，并在这个断口监听来自客户端的请求。
minProcessors：服务器启动时创建的处理请求的线程数。
maxProcessors：最大可以创建的处理请求的线程数。
enableLookups：如果为true，则可以通过调用request.getRemoteHost()进行DNS查询来得到远程客户端的实际主机名，若为false则不进行DNS查询，而是返回其ip地址。
redirectPort：指定服务器正在处理http请求时收到了一个SSL传输请求后重定向的端口号。
acceptCount：指定当所有可以使用的处理请求的线程数都被使用时，可以放到处理队列中的请求数，超过这个数的请求将不予处理。
connectionTimeout：指定超时的时间数(以毫秒为单位)。

Engine(表示指定service中的请求处理机，接收和处理来自Connector的请求)标签
defaultHost：指定缺省的处理请求的主机名，它至少与其中的一个host元素的name属性值是一样的。

Context(表示一个web应用程序，通常为WAR文件，关于WAR的具体信息见servlet规范)标签
docBase：该web应用的文档基准目录（Document Base，也称为Context Root），或者是WAR文件的路径。可以使用绝对路径，也可以使用相对于context所属的Host的appBase路径。
path：表示此web应用程序的url的前缀，这样请求的url为http://localhost:8080/path/****。
reloadable：这个属性非常重要，如果为true，则tomcat会自动检测应用程序的/WEB-INF/lib和/WEB-INF/classes目录的变化，自动装载新的应用程序，我们可以在不重起tomcat的情况下改变应用程序。
useNaming：如果希望Catalina为该web应用使能一个JNDI InitialContext对象，设为true。该InitialialContext符合J2EE平台的约定，缺省值为true。
workDir：Context提供的临时目录的路径，用于servlet的临时读/写。利用javax.servlet.context.tempdir属性，servlet可以访问该目录。如果没有指定，使用$CATALINA_HOME/work下一个合适的目录。
swallowOutput：如果该值为true，System.out和System.err的输出被重定向到web应用的logger。如果没有指定，缺省值为false
debug：与这个Engine关联的Logger记录的调试信息的详细程度。数字越大，输出越详细。如果没有指定，缺省为0。

host(表示一个虚拟主机)标签
name：指定主机名。
appBase：应用程序基本目录，即存放应用程序的目录。
unpackWARs：如果为true，则tomcat会自动将WAR文件解压，否则不解压，直接从WAR文件中运行应用程序。

Logger(表示日志，调试和错误信息)标签
className：指定logger使用的类名，此类必须实现org.apache.catalina.Logger接口。
prefix：指定log文件的前缀。
suffix：指定log文件的后缀。
timestamp：如果为true，则log文件名中要加入时间，如下例:localhost_log.2001-10-04.txt。

Realm(表示存放用户名，密码及role的数据库)标签
className：指定Realm使用的类名，此类必须实现org.apache.catalina.Realm接口。

Valve(功能与Logger差不多，其prefix和suffix属性解释和Logger 中的一样)标签
className：指定Valve使用的类名，如用org.apache.catalina.valves.AccessLogValve类可以记录应用程序的访问信息。
directory：指定log文件存放的位置。
pattern：有两个值，common方式记录远程主机名或ip地址，用户名，日期，第一行请求的字符串，HTTP响应代码，发送的字节数。combined方式比common方式记录的值更多。

3 配置虚拟目录
1）直接部署到webapps目录下面访问。
2）修改conf/server.xml文件。在<Host name="localhost" appBase="webapps" unpackWARs="true" xmlValidation="false" xmlNamespaceAware="false"></host>中加入<Context path="/test" docBase="webdemo" debug="0" reloadable="true" />。docBase目录默认使用appBase="webapps"这个目录。也可以是绝对路径。
配置主目录，可以将path=""。
3）当项目没有放在webapps目录下时，可以在conf/Catalina/localhost新建一个XXX.XML文件。里面加入<Context docBase="E:webdemo" debug="0" reloadable="true" />。
注意：这里的path属性不需要设置，设置了也不会起作用的。
也可以使用该方法建立主目录指向另一个目录，例如：<Context docBase="E:webdemo" debug="0" reloadable="true" />命名为ROOT.xml，这样默认访问的主目录就被修改过了。

4 配置连接数
maxThreads：Tomcat使用线程来处理接收的每个请求。这个值表示Tomcat可创建的最大的线程数。
acceptCount：指定当所有可以使用的处理请求的线程数都被使用时，可以放到处理队列中的请求数，超过这个数的请求将不予处理。
minSpareThreads：Tomcat初始化时创建的线程数。
maxSpareThreads：一旦创建的线程超过这个值，Tomcat就会关闭不再需要的socket线程。
enableLookups：是否反查域名，取值为：true或false。为了提高处理能力，应设置为false
connectionTimeout：网络连接超时，单位：毫秒。设置为0表示永不超时，这样设置有隐患的。默认可设置为20000毫秒。

web server允许的最大连接数还受制于操作系统的内核参数设置，通常Windows是2000个左右，Linux是1000个左右。

5 配置内存大小
修改bin/catalina.bat中的set CATALINA_OPTS=-Xms64m -Xmx128m。
Xms指最小内存，Xmx指最大内存。

6 安全配置
1）将<Server port="8005" shutdown="SHUTDOWN">SHUTDOWN修改为其他一些字符串。否则就容易被人给停止掉了。

2）对应tomcat3.1中，屏蔽目录文件自动列出
修改conf/web.xml中的

<servlet>
          <servlet-name>default</servlet-name>
          <servlet-class>org.apache.catalina.servlets.DefaultServlet</servlet-class>
          <init-param>
              <param-name>debug</param-name>
              <param-value>0</param-value>
          </init-param>
          <init-param>
              <param-name>listings</param-name>
              <param-value>true</param-value><!-- 改成false -->
          </init-param>
          <load-on-startup>1</load-on-startup>
      </servlet>

3）访问日志设置
在server.xml中加入

<Valve className="org.apache.catalina.valves.AccessLogValve"
                   directory="logs"  prefix="localhost_access_log." suffix=".txt"
                   pattern="common" resolveHosts="false"/>

这样访问日志会记录到Logs中。

4）修改用户名、密码
conf/tomcat-users.xml

5）屏蔽后台管理入口
方法一：从控制用户和权限着手。废掉要管理权限的用户就可以了。
方法二：将conf/Catalina/localhost/manager.xml改名。

6）配置403,404,500错误页面
默认情况下，报出HTTP错误的时候会暴露tomcat版本号。如果不想暴露的话，就需要重新定义错误跳转页面。

<error-page>
   <error-code>401</error-code>
   <location>/401.jsp</location>
  </error-page>
  <error-page>
   <error-code>404</error-code>
   <location>/404.jsp</location>
  </error-page>
  <error-page>
   <error-code>500</error-code>
   <location>/500.jsp</location>
  </error-page>

注意：在测试的时候碰到一个奇怪的现象，平时项目里面的时候测试正常的。可是今天在tomcat目录里面新建一个测试目录测试并不能跳转到指定错误页面。暂时不知道为什么。

7 配置Log4j日志记录
项目中抛出的异常，抛到tomcat中的异常会被tomcat记录下来，存放至logs/localhost.yyyy-MM-dd.log文件中。
平时我们在项目中使用的log4j记录日志跟tomcat是没有任何关系的，是独立的一个程序，记录的文件是自定义的。
我们可以在tomcat中定义一个log4j的公共日志处理方式，这样在项目中就不需要在定义log4j的配置了。
1）将log4j-1.2.15.jar加入到commonlib目录。
2）将log4j.properties加入到commonclasses目录。
内容例如：
# Output pattern : date [thread] priority category - message
log4j.rootLogger=DEUBG, stdout, logfile

log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%d [%t] %-5p [%c] - %m%n

log4j.appender.logfile=org.apache.log4j.DailyRollingFileAppender
log4j.appender.logfile.File=${catalina.home}/logs/tomcat_app.log
log4j.appender.logfile.layout=org.apache.log4j.PatternLayout
log4j.appender.logfile.layout.ConversionPattern=%d [%t] %-5p [%c] - %m%n

#3rd party library level
log4j.logger.org.hibernate.cache=ERROR

注意：我们项目中使用e.printStackTrace();输出的异常会在控制台输出来，但是，不会记录到tomcat日志中。
而且，也不会记录到log4j的日志中。要想记录到log4j日志中，必须使用log4j输出来。
所以，实际上web项目中进行异常处理应该将e.printStackTrace();写写法多改成log4j的形式才对！
但是，实际项目中很多项目多偷懒使用了e.printStackTrace();方式输出异常。当出现异常的时候在控制台上查看一下就可以了，也不考虑实际运行时候的维护。假如有人不小心关了控制台，那么，你不就看不到异常了吗？
个人介意使用log4j的形式记入web异常！

8 Tomcat5乱码问题
Tomcat5跟Tomcat4对参数处理是不一样的，在Tomcat4中get与post的编码是一样的，所以只要在过滤器中通过request.setCharacterEncoding()设定一次就可以解决get与set的问题。然而，在Tomcat5中，get与post的处理是分开的，对get请求使用URIEncoding进行处理，对post使用request.setCharacterEncoding()处理。Tomcat5中，在server.xml的Connector元素增加了以下配置参数：
URIEncoding：用来设定通过URI传递的