Tomcat作为Java Web开发中使用最广泛的开源Servlet容器，在Linux服务器上的部署频率非常高。但不少初学者在安装完Tomcat后，面对conf目录下的一堆XML文件不知道从哪里下手，改错了配置还会导致启动失败。其实Tomcat的日常运维配置主要集中在几个文件上，掌握了它们的结构和修改方法，大部分场景都能轻松应对。本文将按照实际使用频率，逐一讲解server.xml、catalina.sh、web.xml等核心配置文件的修改位置、参数含义以及修改后的生效方式。
一、server.xml：Tomcat最核心的配置文件
server.xml位于Tomcat安装目录的conf文件夹下，是整个容器的骨架配置文件，定义了服务器端口、连接器、虚拟主机、上下文路径等关键信息。修改这个文件前建议先备份一份，命令如下：
cp $CATALINA_HOME/conf/server.xml $CATALINA_HOME/conf/server.xml.bak
最常见的需求是修改HTTP访问端口，默认是8080。找到<Connector>节点中的port="8080"，将其改为目标端口即可，例如改为80：
<Connector port="80" protocol="HTTP/1.1"
connectionTimeout="20000"
redirectPort="8443"
URIEncoding="UTF-8" />其中protocol指定协议处理方式，connectionTimeout是连接超时时间（毫秒），redirectPort用于SSL请求转发，URIEncoding则决定了URL中中文参数的解码方式，强烈建议显式设置为UTF-8，可以有效避免GET请求中文乱码问题。
另一个常改的地方是Shutdown端口，位于文件顶部的<Server>节点，默认为8005。这个端口用于接收关闭指令，如果被占用Tomcat将无法正常启动，可以改成其他空闲端口。此外<Host>节点中的appBase属性指定了Web应用部署目录，默认为webapps，如果需要指定其他目录，可以在这里修改，也可以在<Host>内部添加<Context>元素来定义单个应用的部署路径：
<Context docBase="/opt/myapp" path="/myapp" reloadable="true" />
其中docBase是应用真实路径，path是访问路径前缀，reloadable表示是否监听class文件变化自动重载，生产环境建议设为false以提升性能。
二、catalina.sh：JVM内存与远程调试配置
catalina.sh位于bin目录下，是Tomcat在Linux下的启动脚本。虽然它本身是脚本文件，但JVM内存参数、GC策略、远程调试端口等都习惯配置在这里。找到脚本开头的注释区域，在正式逻辑执行前添加JAVA_OPTS变量：
JAVA_OPTS="-server -Xms1024m -Xmx2048m -Xmn512m -XX:MetaspaceSize=256m -XX:MaxMetaspaceSize=512m -Dfile.encoding=UTF-8"
-Xms和-Xmx分别设置堆内存初始值和最大值，一般建议两者设置相同，避免运行期动态扩容带来的开销。-Xmn设置新生代大小，Metaspace相关参数控制元空间，JDK 8以后永久代已被移除，务必使用Metaspace参数而不是PermSize。内存设置过小会出现java.lang.OutOfMemoryError，设置过大则可能与系统其他进程争抢资源，需要根据服务器实际内存合理分配。
如果需要开启远程调试，方便在本地IDE连接服务器上的Tomcat，可以在catalina.sh中添加如下配置：
JAVA_OPTS="$JAVA_OPTS -Xdebug -Xrunjdwp:transport=dt_socket,address=8888,server=y,suspend=n"
其中address指定调试端口，suspend=n表示Tomcat启动时不等待调试器连接。配置完成后需要重启Tomcat，并在防火墙中放行8888端口。要注意生产环境不建议长期开启远程调试，存在安全风险，调试完成后应及时移除该配置。
三、web.xml与其他辅助配置文件的修改
conf目录下的web.xml是全局的默认部署描述符，所有Web应用都会继承这里的配置。常见的修改包括设置默认Servlet的列表行为、会话超时时间以及欢迎页列表。比如修改session默认超时时长：
<session-config>
<session-timeout>30</session-timeout>
</session-config>单位为分钟，30表示30分钟无操作后session失效。如果希望目录访问不列出文件内容（安全加固的常见操作），需要找到default servlet的配置，将listings参数设为false：
<init-param>
<param-name>listings</param-name>
<param-value>false</param-value>
</init-param>除了web.xml，logging.properties控制日志输出级别与格式，tomcat-users.xml用于配置管理界面的账号角色。如果需要使用Tomcat自带的管理页面，可以在tomcat-users.xml中添加：
<role rolename="manager-gui"/> <user username="admin" password="yourpassword" roles="manager-gui"/>
同时还要注意，新版本Tomcat出于安全考虑，默认只允许本机访问manager页面，远程访问需要在conf/Catalina/localhost目录下为manager应用添加Context配置放行指定IP。
四、常见问题与注意事项
第一个高频问题是修改配置后不生效。原因通常是Tomcat中运行的Java进程并没有真正重启。正确的做法是先执行shutdown.sh，再用ps -ef | grep tomcat确认进程是否退出，如果进程仍然存在，用kill -9 进程号强制结束后再执行startup.sh，否则旧配置会一直被旧进程持有。
第二个问题是启动时报端口被占用。可以先用netstat -tlnp | grep 8080或者ss -tlnp | grep 8080查看占用端口的进程，要么结束该进程，要么修改server.xml换一个端口。第三个问题是日志中文乱码，通常需要保持catalina.sh中的-Dfile.encoding=UTF-8与系统的locale设置一致，可以通过echo $LANG检查当前系统编码。
还有几点注意事项需要牢记：修改任何配置文件前务必备份；server.xml是XML格式文件，标签必须严格闭合，多写或少写一个引号都会导致启动失败，可以在修改后用xmllint --noout server.xml校验格式是否正确；配置JVM内存时要结合服务器物理内存与其他进程占用情况综合评估；生产环境应关闭reloadable自动重载、关闭目录列表、使用强密码并限制manager页面的访问来源。掌握这些要点后，Linux下Tomcat的配置管理就会变得清晰有序。
Linux Tomcat配置server.xml修改Tomcat端口设置修改时间：2026-09-02 07:56:29