当前位置：首页 > news >正文

Tomcat配置详情

news 2025/5/21 7:57:58

Apache Tomcat 是一个开源的 Java Servlet 容器和 Web 服务器，以下是 Tomcat 的详细配置说明。

一、Tomcat 目录结构

├── bin/            # 启动/关闭脚本
├── conf/           # 配置文件
│   ├── server.xml       # 主配置文件
│   ├── web.xml          # 全局web应用配置
│   ├── context.xml      # 上下文配置
│   └── tomcat-users.xml # 用户权限配置
├── lib/            # 共享库
├── logs/           # 日志文件
├── webapps/        # 部署目录
├── work/           # 工作目录
└── temp/           # 临时文件

二、核心配置文件详解

1. server.xml (主配置文件)

<Server port="8005" shutdown="SHUTDOWN"><Service name="Catalina"><!-- 连接器配置 --><Connector port="8080" protocol="HTTP/1.1"connectionTimeout="20000"redirectPort="8443" /><!-- AJP连接器 --><Connector port="8009" protocol="AJP/1.3" redirectPort="8443" /><!-- 引擎配置 --><Engine name="Catalina" defaultHost="localhost"><Host name="localhost" appBase="webapps"unpackWARs="true" autoDeploy="true"><!-- 上下文配置 --><Context path="" docBase="myapp" reloadable="true" /></Host></Engine></Service>
</Server>

2. web.xml (全局应用配置)

<web-app><!-- 默认Servlet配置 --><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><load-on-startup>1</load-on-startup></servlet><!-- Session配置 --><session-config><session-timeout>30</session-timeout> <!-- 30分钟 --></session-config><!-- MIME类型映射 --><mime-mapping><extension>pdf</extension><mime-type>application/pdf</mime-type></mime-mapping>
</web-app>

3. context.xml (上下文配置)

<Context><!-- 数据源配置 --><Resource name="jdbc/myDB" auth="Container"type="javax.sql.DataSource"maxTotal="100" maxIdle="30"username="dbuser" password="dbpass"driverClassName="com.mysql.jdbc.Driver"url="jdbc:mysql://localhost:3306/mydb" /><!-- 环境变量 --><Environment name="app.config" value="/etc/myapp/config.properties"type="java.lang.String" />
</Context>

4. tomcat-users.xml (用户权限配置)

<tomcat-users><!-- 角色定义 --><role rolename="manager-gui"/><role rolename="admin-gui"/><!-- 用户定义 --><user username="admin" password="s3cret" roles="manager-gui,admin-gui"/>
</tomcat-users>

三、常用配置项

1. 端口修改

修改 conf/server.xml 中的 Connector 配置：

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

2. 虚拟主机配置

<Host name="www.example.com" appBase="webapps/example" unpackWARs="true"><Alias>example.com</Alias><Context path="" docBase="." /><Valve className="org.apache.catalina.valves.AccessLogValve"directory="logs"prefix="example_access_log" suffix=".log"pattern="%h %l %u %t &quot;%r&quot; %s %b" />
</Host>

3. SSL/TLS 配置

1. 生成秘钥

keytool -genkey -alias tomcat -keyalg RSA -keystore /path/to/keystore

2. 修改 server.xml

<Connector port="8443" protocol="org.apache.catalina.util.NettyEndpoint"maxThreads="150" SSLEnabled="true"><SSLHostConfig><Certificate certificateKeystoreFile="/path/to/keystore"certificateKeystorePassword="changeit"type="RSA" /></SSLHostConfig>
</Connector>

4. 内存配置

修改 bin/catalina.sh (Linux) 或 bin/catalina.bat (Windows)：

# Linux
export JAVA_OPTS="-Xms512m -Xmx1024m -XX:MaxPermSize=256m"# Windows
set JAVA_OPTS=-Xms512m -Xmx1024m -XX:MaxPermSize=256m

5. 访问日志配置

<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" rotatable="true"/>

四、部署应用

1. 自动部署

将 WAR 文件复制到 webapps/ 目录，Tomcat 会自动解压部署。

2. 手动部署

在 conf/Catalina/localhost/ 下创建 XML 文件：

<Context docBase="/path/to/your/app" path="/yourapp" reloadable="true" />

五、性能优化

1. 连接器优化

<Connector port="8080" protocol="org.apache.coyote.http11.Http11Nio2Protocol"maxThreads="200"minSpareThreads="10"acceptCount="100"enableLookups="false"compression="on"compressionMinSize="2048"compressableMimeType="text/html,text/xml,text/plain,text/css,text/javascript,application/javascript" />

2. JVM 优化

JAVA_OPTS="-server -Xms2048m -Xmx2048m -XX:NewSize=512m -XX:MaxNewSize=512m -XX:PermSize=256m -XX:MaxPermSize=256m -XX:+DisableExplicitGC"

3. 禁用不必要的功能

<!-- 在server.xml中禁用AJP连接器（如不使用） -->
<!-- <Connector port="8009" protocol="AJP/1.3" redirectPort="8443" /> -->

六、安全管理

1. 禁用管理界面

删除 webapps/manager 和 webapps/host-manager 目录

2. 限制访问

<Context><Valve className="org.apache.catalina.valves.RemoteAddrValve"allow="192\.168\.1\.\d+|127\.0\.0\.1" />
</Context>

3. 隐藏服务器信息

修改 conf/web.xml：

<servlet><servlet-name>default</servlet-name><init-param><param-name>server</param-name><param-value>Unknown</param-value></init-param>
</servlet>

七、常用命令

# 启动Tomcat
./bin/startup.sh  # Linux
bin\startup.bat   # Windows# 关闭Tomcat
./bin/shutdown.sh  # Linux
bin\shutdown.bat   # Windows# 查看版本
./bin/version.sh# 调试模式
export CATALINA_OPTS="-Xdebug -Xrunjdwp:transport=dt_socket,address=8000,server=y,suspend=n"
./bin/catalina.sh jpda start