---
title: "Tomcat5.5.x配置整理"
author: "fanjava"
date: "2005-03-16T20:33:00Z"
tags: []
slug: "tomcat5-5-x"
draft: false
lastmod: "2005-03-16T20:33:00Z"
id: 601771
url: "https://fanjava.iteye.com/blog/601771"
---

1.下载：

[http://www.eu.apache.org/dist/jakarta/tomcat-5/](http://www.eu.apache.org/dist/jakarta/tomcat-5/)

[http://www.apache.org/dist/jakarta/tomcat-5/v5.5.x/bin/jakarta-tomcat-5.5.x-admin.zip](http://www.apache.org/dist/jakarta/tomcat-5/v5.5.x/bin/jakarta-tomcat-5.5.x-admin.zip)  
[http://www.apache.org/dist/jakarta/tomcat-5/v5.5.x/bin/jakarta-tomcat-5.5.x-compat.zip](http://www.apache.org/dist/jakarta/tomcat-5/v5.5.x/bin/jakarta-tomcat-5.5.x-compat.zip)  
[http://www.apache.org/dist/jakarta/tomcat-5/v5.5.x/bin/jakarta-tomcat-5.5.x.zip](http://www.apache.org/dist/jakarta/tomcat-5/v5.5.x/bin/jakarta-tomcat-5.5.x.zip)

[http://www.apache.org/dist/jakarta/tomcat-5/v5.5.x/bin/jakarta-tomcat-5.5.x-deployer.zip](http://www.apache.org/dist/jakarta/tomcat-5/v5.5.x/bin/jakarta-tomcat-5.5.x-deployer.zip)

把jakarta-tomcat-5.5.x.zip

和jakarta-tomcat-5.5.x-compat.zip

和jakarta-tomcat-5.5.x-admin.zip  
(Tomcat 默认是没有内置admin模块了

Tomcat's administration web application is no longer installed by default. Download and install the "admin" package to use it. )

都解压到同一个目录下面。比如：D:\\jakarta-tomcat-5.5.x\\

(如果使用jdk1.4，才需要compat.zip用jdk1.5就可以免了这个。)

2.修改jakarta-tomcat-5.5.x\\conf\\tomcat-users.xml.  
添加管理员账号lizongbo，密码为lizongbopass.  
新xml如下：  
&lt;?xml version='1.0' encoding='utf-8'?&gt;  
&lt;tomcat-users&gt;  
&lt;role rolename="tomcat"/&gt;  
&lt;role rolename="role1"/&gt;  
&lt;role rolename="manager"/&gt;  
&lt;role rolename="admin"/&gt;  
&lt;user username="tomcat" password="tomcat" roles="tomcat"/&gt;  
&lt;user username="role1" password="tomcat" roles="role1"/&gt;  
&lt;user username="both" password="tomcat" roles="tomcat,role1"/&gt;  
&lt;user username="lizongbo" password="lizongbopass" roles="admin,manager"/&gt;  
&lt;/tomcat-users&gt;

3.修改jakarta-tomcat-5.5.x\\conf\\server.xml来解决编码问题。  
(给Connector添加URIEncoding参数，参考[http://blog.csdn.net/darkxie/archive/2004/10/25/TOMCATAPP.aspx](http://blog.csdn.net/darkxie/archive/2004/10/25/TOMCATAPP.aspx))

(可以设置成GB18030)  
&lt;Connector port="8080"  
maxThreads="150" minSpareThreads="25" maxSpareThreads="75"  
enableLookups="false" redirectPort="8443" acceptCount="200"  
connectionTimeout="20000" disableUploadTimeout="true" URIEncoding="GBK"  
compression="on" compressionMinSize="2048"  
noCompressionUserAgents="gozilla, traviata"  
compressableMimeType="text/html,text/xml"/&gt;

&lt;Connector port="8009"  
enableLookups="false" redirectPort="8443" protocol="AJP/1.3" URIEncoding="GBK"/&gt;

4.启用支持gzip压缩.  
([http://www.linuxaid.com.cn/forum/showdoc.jsp?l=1&i=81169](http://www.linuxaid.com.cn/forum/showdoc.jsp?l=1&i=81169))  
添加下列属性  
compression="on"  
compressionMinSize="2048"  
noCompressionUserAgents="gozilla, traviata"  
compressableMimeType="text/html,text/xml"

5.设置虚拟主机。

在jakarta-tomcat-5.5.x\\下建立文件夹vhost\\www.mydomain.com。

然后修改jakarta-tomcat-5.5.x\\conf\\server.xml

&lt;Engine defaultHost="localhost" name="Catalina"&gt;  
&lt;Host appBase="vhost/www.mydomain.com" name="[www.mydomain.com](http://www.mydomain.com/)"&gt;  
&lt;/Host&gt;  
&lt;Host appBase="webapps" name="localhost"&gt;  
&lt;/Host&gt;  
&lt;Realm className="org.apache.catalina.realm.UserDatabaseRealm"/&gt;  
&lt;/Engine&gt;

6.添加数据库驱动,更新mail.jar和actiovation.jar

复制mysql-connector-java-3.0.16-ga-bin.jar,pg74.215.jdbc3.jar到 jakarta-tomcat-5.5.x\\common\\lib\\

还有javamail 1.3.2的mail.jar，jaf-1\_0\_2的 activation.jar

msSQl 2000 JDBC sp3，msbase.jar,msutil,jar,mssqlserver.jar

7.配置SSL

参考 [http://jakarta.apache.org/tomcat/tomcat-5.5-doc/ssl-howto.html](http://jakarta.apache.org/tomcat/tomcat-5.5-doc/ssl-howto.html)

D:\\j2sdk1.4.2\_06\\bin&gt;%JAVA\_HOME%\\bin\\keytool -genkey -alias tomcat -keyalg RSA  
输入keystore密码： lizongbossl  
您的名字与姓氏是什么？  
\[tomcat5.5.x]： tomcat5.5.x  
您的组织单位名称是什么？  
\[jakarta]： jakarta  
您的组织名称是什么？  
\[apache]： apache  
您所在的城市或区域名称是什么？  
\[hzcity]： hzcity  
您所在的州或省份名称是什么？  
\[gdp]： gdp  
该单位的两字母国家代码是什么  
\[CN]： CN  
CN=tomcat5.5.x, OU=jakarta, O=apache, L=hzcity, ST=gdp, C=CN 正确吗？  
\[否]： y

输入&lt;tomcat&gt;的主密码  
（如果和 keystore 密码相同，按回车）：

(必须密码一致，因此直接回车)

然后再把userhome(例如：C:\\Documents and Settings\\lizongbo\\)下的.keystore复制到

tomcat的conf\\目录下。

(例如：D:\\jakarta-tomcat-5.5.x\\conf\\.keystore )

配置jakarta-tomcat-5.5.x\\conf\\server.xml

加上

&lt;Connector port="8443"  
maxThreads="150" minSpareThreads="25" maxSpareThreads="75"  
enableLookups="false" disableUploadTimeout="true"  
acceptCount="100" scheme="https" secure="true"  
clientAuth="false" sslProtocol="TLS"  
keystoreFile="conf/.keystore"  
keystorePass="lizongbossl"&gt; &lt;!--与先前设置的密码一致--&gt;  
&lt;/Connector&gt;

8.禁止文件目录列表，

修改jakarta-tomcat-5.5.x\\conf\\web.xml，把listing设置为false

&lt;servlet&gt;  
&lt;servlet-name&gt;default&lt;/servlet-name&gt;  
&lt;servlet-class&gt;org.apache.catalina.servlets.DefaultServlet&lt;/servlet-class&gt;  
&lt;init-param&gt;  
&lt;param-name&gt;debug&lt;/param-name&gt;  
&lt;param-value&gt;0&lt;/param-value&gt;  
&lt;/init-param&gt;  
&lt;init-param&gt;  
&lt;param-name&gt;listings&lt;/param-name&gt;  
&lt;param-value&gt;true&lt;/param-value&gt;  
&lt;/init-param&gt;  
&lt;load-on-startup&gt;1&lt;/load-on-startup&gt;  
&lt;/servlet&gt;

9.指定了自己的javaEncoding

(参考 [http://gceclub.sun.com.cn/staticcontent/html/sunone/app7/app7-dg-webapp/ch6/ch6-4.html](http://gceclub.sun.com.cn/staticcontent/html/sunone/app7/app7-dg-webapp/ch6/ch6-4.html))

&lt;servlet&gt;  
&lt;servlet-name&gt;jsp&lt;/servlet-name&gt;  
&lt;servlet-class&gt;org.apache.jasper.servlet.JspServlet&lt;/servlet-class&gt;  
&lt;init-param&gt;  
&lt;param-name&gt;fork&lt;/param-name&gt;  
&lt;param-value&gt;false&lt;/param-value&gt;  
&lt;/init-param&gt;  
&lt;init-param&gt;  
&lt;param-name&gt;javaEncoding&lt;/param-name&gt;  
&lt;param-value&gt;GB18030&lt;/param-value&gt;  
&lt;/init-param&gt;  
&lt;init-param&gt;  
&lt;param-name&gt;xpoweredBy&lt;/param-name&gt;  
&lt;param-value&gt;true&lt;/param-value&gt;  
&lt;/init-param&gt;  
&lt;load-on-startup&gt;3&lt;/load-on-startup&gt;  
&lt;/servlet&gt;

10.添加rar,iso等的mime-type映射

避免在浏览器里直接打开。

&lt;mime-mapping&gt;  
&lt;extension&gt;mht&lt;/extension&gt;  
&lt;mime-type&gt;text/x-mht&lt;/mime-type&gt;  
&lt;/mime-mapping&gt;

&lt;mime-mapping&gt;  
&lt;extension&gt;rar&lt;/extension&gt;  
&lt;mime-type&gt;application/octet-stream&lt;/mime-type&gt;  
&lt;/mime-mapping&gt;  
&lt;mime-mapping&gt;  
&lt;extension&gt;iso&lt;/extension&gt;  
&lt;mime-type&gt;application/octet-stream&lt;/mime-type&gt;  
&lt;/mime-mapping&gt;  
&lt;mime-mapping&gt;  
&lt;extension&gt;ape&lt;/extension&gt;  
&lt;mime-type&gt;application/octet-stream&lt;/mime-type&gt;  
&lt;/mime-mapping&gt;  
&lt;mime-mapping&gt;  
&lt;extension&gt;rmvb&lt;/extension&gt;  
&lt;mime-type&gt;application/octet-stream&lt;/mime-type&gt;  
&lt;/mime-mapping&gt;

&lt;mime-mapping&gt;  
&lt;extension&gt;ico&lt;/extension&gt;  
&lt;mime-type&gt;image/x-icon&lt;/mime-type&gt;  
&lt;/mime-mapping&gt;

10.1对html静态页面设置编码

&lt;!--修改下面两行以支持静态超文本的自动编码  
\--&gt;  
&lt;mime-mapping&gt;  
&lt;extension&gt;htm&lt;/extension&gt;  
&lt;mime-type&gt;text/html;charset=gb2312&lt;/mime-type&gt;  
&lt;/mime-mapping&gt;  
&lt;mime-mapping&gt;  
&lt;extension&gt;html&lt;/extension&gt;  
&lt;mime-type&gt;text/html;charset=gb2312&lt;/mime-type&gt;  
&lt;/mime-mapping&gt;  
&lt;/web-app&gt;

11.添加welcome-file-list，并调整顺序。

&lt;welcome-file-list&gt;  
&lt;welcome-file&gt;index.jsp&lt;/welcome-file&gt;  
&lt;welcome-file&gt;index.html&lt;/welcome-file&gt;  
&lt;welcome-file&gt;index.htm&lt;/welcome-file&gt;  
&lt;welcome-file&gt;default.html&lt;/welcome-file&gt;  
&lt;welcome-file&gt;default.htm&lt;/welcome-file&gt;  
&lt;welcome-file&gt;default.jsp&lt;/welcome-file&gt;  
&lt;/welcome-file-list&gt;

12.如果你的webapp需要只能够进行https方式访问，那么在webapp的web.xml里加上：

&lt;security-constraint&gt;  
&lt;web-resource-collection&gt;  
&lt;web-resource-name&gt;must https&lt;/web-resource-name&gt;  
&lt;url-pattern&gt;/lizongbo/\*&lt;/url-pattern&gt;  
&lt;/web-resource-collection&gt;  
&lt;user-data-constraint&gt;  
&lt;transport-guarantee&gt;CONFIDENTIAL&lt;/transport-guarantee&gt;  
&lt;/user-data-constraint&gt;  
&lt;/security-constraint&gt;

参考：[http://jakarta.apache.org/tomcat/faq/security.html#https](http://jakarta.apache.org/tomcat/faq/security.html#https)

[http://marc.theaimsgroup.com/?l=tomcat-user&m=104951559722619&w=2](http://marc.theaimsgroup.com/?l=tomcat-user&m=104951559722619&w=2)

13.修改远程关闭服务器的命令。

server.xml默认有下面一行：

&lt;Server port="8005" shutdown="SHUTDOWN"&gt;

这样允许任何人只要telnet到服务器的8005端口，输入"SHUTDOWN"，然后回车，服务器立即就被关掉了。

从安全的角度上考虑，我们需要把这个shutdown指令改成一个别人不容易猜测的字符串。

例如修改如下：

&lt;Server port="8006" shutdown="lizongbo"&gt;，这样就只有在telnet到8006，并且输入"lizongbo"才能够关闭Tomcat.

注意：这个修改不影响shutdown.bat的执行。运行shutdown.bat一样可以关闭服务器。

参考：[http://jakarta.apache.org/tomcat/faq/security.html#8005](http://jakarta.apache.org/tomcat/faq/security.html#8005)

以下皆可以参考：[http://www.cnjsp.org/document/user/tuman/valve.html](http://www.cnjsp.org/document/user/tuman/valve.html)

14.配置http访问日志。Tomcat自带的能够记录的http访问日志已经很详细了

取消下面这段的注释：

&lt;Valve className="org.apache.catalina.valves.AccessLogValve"  
directory="logs" prefix="localhost\_access\_log." suffix=".txt"  
pattern="common" resolveHosts="false"/&gt;

然后修改为：

&lt;Valve className="org.apache.catalina.valves.FastCommonAccessLogValve"  
directory="logs" prefix="localhost\_access\_log." suffix=".txt"  
pattern="combined" resolveHosts="false" fileDateFormat="yyyy-MM-dd.HH"/&gt;

pattern="combined" 记录的日志内容更详细，fileDateFormat="yyyy-MM-dd.HH"，会让日志文件按小时进行滚卷，

比默认的按天滚卷要好些，尤其是访问量大的网站，可以考虑写成fileDateFormat="yyyy-MM-dd.HH.mm"，就会是每分钟一个日志文件了。

而且可以分别按[Engine](http://jakarta.apache.org/tomcat/tomcat-5.0-doc/config/engine.html#Access%20Logs), [Host](http://jakarta.apache.org/tomcat/tomcat-5.0-doc/config/host.html#Access%20Logs), or [Context](http://jakarta.apache.org/tomcat/tomcat-5.0-doc/config/context.html#Access%20Logs),来记录自己的日志

详情参考：

[http://jakarta.apache.org/tomcat/tomcat-5.5-doc/config/valve.html](http://jakarta.apache.org/tomcat/tomcat-5.5-doc/config/valve.html)

[http://jakarta.apache.org/tomcat/tomcat-5.0-doc/config/logger.html](http://jakarta.apache.org/tomcat/tomcat-5.0-doc/config/logger.html)

[http://jakarta.apache.org/tomcat/tomcat-5.0-doc/config/host.html#Access%20Logs](http://jakarta.apache.org/tomcat/tomcat-5.0-doc/config/host.html#Access%20Logs)

而且还可以配合awstats来进行日志统计分析： [http://www.chedong.com/tech/awstats.html](http://www.chedong.com/tech/awstats.html)

15.限制ip，限制主机访问等。

如果想禁止指定的ip或者主机名来拒绝某些机器访问，或者指定某些机器来访问。

也支持分别按[Engine](http://jakarta.apache.org/tomcat/tomcat-5.0-doc/config/engine.html#Access%20Logs), [Host](http://jakarta.apache.org/tomcat/tomcat-5.0-doc/config/host.html#Access%20Logs), or [Context](http://jakarta.apache.org/tomcat/tomcat-5.0-doc/config/context.html#Access%20Logs),进行以下配置：

&lt;Context path="/examples" ...&gt; ...  
&lt;Valve className="org.apache.catalina.valves.RemoteHostValve"  
allow="\*.mycompany.com,www.yourcompany.com"/&gt;  
&lt;Valve className="org.apache.catalina.valves.RemoteAddrValve"  
deny="192.168.1.\*"/&gt;  
&lt;/Context&gt;  
参考：

[http://jakarta.apache.org/tomcat/tomcat-5.0-doc/config/context.html](http://jakarta.apache.org/tomcat/tomcat-5.0-doc/config/context.html)

16.发布webapp到网站根目录

1。直接复制到ROOT目录下。

2.因为无法创建无名字的xml文件，并且在xml文件里指定path也是无效的(tomcat靠文件名字来判断的)，

因此必须在server.xml里写下面一段：

&lt;Context docBase="${catalina.home}/vhost/www.lizongbo.com" path="/"  
privileged="true" antiResourceLocking="false" antiJARLocking="false"&gt;  
&lt;Manager className="org.apache.catalina.session.StandardManager" algorithm="SHA-512"  
entropy="suijisifuchuansuijisifuchuansuijisifuchuansuijisifuchuan"  
maxActiveSessions="800" /&gt;  
&lt;Valve className="org.apache.catalina.valves.FastCommonAccessLogValve"  
directory="logs" prefix="localhost\_mytest\_access\_log." suffix=".txt"  
pattern="combined" resolveHosts="true" fileDateFormat="yyyy-MM-dd.HH"/&gt;

&lt;/Context&gt;

而且必须把ROOT目录删除掉，否则Tomcat还是优先部署ROOT目录为"/"。

17.在重新启动Tomcat的webapp的时候，禁止把session写入文件。

修改conf/web.xml

取消注释：

&lt;!----&gt;  
&lt;Manager pathname="" /&gt;

18.增强SessiionID的生成算法和长度。

&lt;Manager className="org.apache.catalina.session.StandardManager" algorithm="SHA-512" sessionIdLength="40"&gt;  
&lt;/Manager&gt;

（默认的是MD5,长度是16位。）

19.配置日志：([http://jakarta.apache.org/tomcat/tomcat-5.5-doc/logging.html](http://jakarta.apache.org/tomcat/tomcat-5.5-doc/logging.html))

在D:\\jakarta-tomcat-5.5.8\\common\\classes\\新建log4j.properties

内容：

log4j.rootLogger=debug, R  
log4j.appender.R=org.apache.log4j.RollingFileAppender  
log4j.appender.R.File=${catalina.home}/logs/tomcat5.5.log  
log4j.appender.R.MaxFileSize=10MB  
log4j.appender.R.MaxBackupIndex=10  
log4j.appender.R.layout=org.apache.log4j.PatternLayout  
log4j.appender.R.layout.ConversionPattern=%p %t %c - %m%n  
log4j.logger.org.apache.catalina=DEBUG, R

log4j.logger.org.apache.catalina.core.ContainerBase.Catalina.localhost=DEBUG, R  
log4j.logger.org.apache.catalina.core=DEBUG, R  
log4j.logger.org.apache.catalina.session=DEBUG, R

复制log4j-1.2.9.jar和commons-logging.jar到

D:\\jakarta-tomcat-5.5.8\\common\\lib

20.使用windows域用户验证

[http://jcifs.samba.org/src/docs/ntlmhttpauth.html](http://jcifs.samba.org/src/docs/ntlmhttpauth.html)