0

0

server.xml是什么 如何用它来配置Tomcat服务器

煙雲

煙雲

发布时间:2026-01-19 10:27:10

|

749人浏览过

|

来源于php中文网

原创

server.xml是tomcat核心配置文件,定义service、connector等严格嵌套的组件结构,修改前须备份、校验xml语法并重启生效;关键配置包括端口、https证书参数及context根路径部署。

server.xml是什么 如何用它来配置tomcat服务器

server.xml 是 Tomcat 的核心配置文件,位于 $CATALINA_HOME/conf/server.xml,它定义了服务器的顶层结构:Service、Connector、Engine、Host、Context 等组件。改错或乱配这个文件,Tomcat 很可能直接启动失败。

修改 server.xml 前必须知道的三件事

它不是“越配越强”的配置项集合,而是声明式拓扑描述 —— 每个 <connector></connector> 对应一个监听端口,每个 <host></host> 对应一个虚拟主机,嵌套关系严格,缩进不解决语法问题,XML 标签必须正确闭合。

  • Tomcat 启动时会校验 server.xml 的 XML 语法,哪怕多一个空格在 外也会报 org.xml.sax.SAXParseException
  • 修改后必须重启 Tomcat 生效,热加载不支持该文件
  • 不要在生产环境直接编辑原始 server.xml,建议先备份为 server.xml.bak,再用 diff 对比变更

常用配置项:端口、HTTP/HTTPS、应用路径

最常动的其实是三个 <connector></connector> 属性和一个 <context></context> 声明:

Eclipse中创建Web Maven Project并部署到Tomcat中 中文WORD版
Eclipse中创建Web Maven Project并部署到Tomcat中 中文WORD版

大家都知道,在进行J2EE项目的开发过程中,在调试阶段如果只是修改了页面是不需要重启应用服务器的,比如不需要重启Tomcat。只需要在浏览器中 进行页面刷新即可。其实之所以不用重启Tomcat等应用服务器,其根本原因是因为我们可以在应用服务器的配置文件中设置虚拟目录,这样就可以知道web 项目所在的目录,于是就可以省去打包、然后再重新发布到服务器的步骤。感兴趣的朋友可以过来看看

下载
  • port:默认 8080,改它可避开端口占用,比如改成 8081
  • redirectPort:当 HTTP 请求需跳转 HTTPS 时用,通常设为 8443
  • protocol:设为 "org.apache.coyote.http11.Http11Nio2Protocol" 启用 NIO2(JDK 11+ 推荐),旧版写 "HTTP/1.1" 会自动匹配阻塞式或 NIO
  • 若要强制部署某个 WAR 到根路径(/),可在 <host></host> 内加:
    <Context path="" docBase="/path/to/your/app" reloadable="false"/>
    注意 path="" 表示根,不能写 path="/",否则 Tomcat 会忽略

HTTPS 配置:keystore 和 protocol 容易配错

启用 HTTPS 不只是改端口,关键在 <connector></connector> 的证书参数。常见错误是路径写错、密码不一致、或 protocol 未切到 TLS。

  • 确保 keystoreFile 是绝对路径或相对于 $CATALINA_HOME 的相对路径,例如 "conf/keystore.jks"
  • keystorePass 必须和生成 keystore 时设的密码完全一致(区分大小写)
  • 必须把 protocol 改成 "org.apache.coyote.http11.Http11NioProtocol""org.apache.coyote.http11.Http11Nio2Protocol",不能保留 "HTTP/1.1"
  • 完整 HTTPS Connector 示例:
    <Connector port="8443" protocol="org.apache.coyote.http11.Http11Nio2Protocol"
               maxThreads="200" scheme="https" secure="true"
               keystoreFile="conf/keystore.jks" keystorePass="changeit"
               keyAlias="tomcat" sslProtocol="TLS" />

别碰这些地方:Engine name、defaultHost、Server port

除非你明确在搭集群或做嵌入式定制,否则以下字段建议保持默认:

  • <server port="8005"></server>:这是 shutdown 端口,仅用于发送 SHUTDOWN 命令,改它会导致 catalina.sh stop 失效
  • <engine name="Catalina" defaulthost="localhost"></engine>:name 是内部标识,defaultHost 要和下面 <host name="localhost"></host> 严格一致,改错会导致所有请求 404
  • <listener></listener> 标签:如 AprLifecycleListenerJreMemoryLeakPreventionListener,禁用前务必查清作用,否则可能引发内存泄漏或 APR 功能异常

真正难的不是怎么写,而是改完之后要不要删掉注释里的示例 Connector、要不要把 unpackWARs="true" 关掉、以及为什么 reloadable="true" 在生产中必须为 false —— 这些细节不报错,但会在某次高并发或 classloader 场景下突然暴露。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
如何配置Tomcat环境变量
如何配置Tomcat环境变量

配置Tomcat环境变量需要在系统中添加CATALINA_HOME变量,并将Tomcat的安装路径添加到PATH变量中。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

117

2023.10.26

idea如何集成Tomcat
idea如何集成Tomcat

idea集成Tomcat的步骤:1、添加Tomcat服务器配置;2、配置项目部署;3、运行Tomcat服务器;4、访问项目;5、注意事项;6、关闭Tomcat服务器。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

172

2024.02.23

怎么查看Tomcat源代码
怎么查看Tomcat源代码

查看Tomcat源代码的步骤:1、下载Tomcat源代码;2、在IDEA中导入Tomcat源代码;3、查看源代码;4、理解Tomcat的工作原理;5、参与社区和贡献;6、注意事项;7、持续学习和更新;8、使用工具和插件。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

98

2024.02.23

常见的tomcat漏洞有哪些
常见的tomcat漏洞有哪些

常见的tomcat漏洞有:1、跨站脚本攻击;2、跨站请求伪造;3、目录遍历漏洞;4、缓冲区溢出漏洞;5、配置漏洞;6、第三方组件漏洞。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

169

2024.02.23

tomcat日志乱码怎么解决
tomcat日志乱码怎么解决

tomcat日志乱码的解决办法:1、修改tomcat的日志编码设置;2、检查ide的编码设置;3、检查操作系统的编码设置;4、使用过滤器处理日志;5、检查外部系统的编码设置;6、检查文件编码方式等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

157

2024.02.23

weblogic和tomcat有哪些区别
weblogic和tomcat有哪些区别

weblogic和tomcat的区别:1、功能;2、性能;3、规模;4、价格;5、安全性;6、配置和管理;7、社区支持;8、集成能力;9、升级和更新;10、可靠性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

200

2024.02.23

tomcat和nginx有哪些区别
tomcat和nginx有哪些区别

tomcat和nginx的区别:1、应用领域;2、性能;3、功能;4、配置;5、安全性;6、扩展性;7、部署复杂性;8、社区支持;9、成本;10、日志管理。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

244

2024.02.23

tomcat启动闪退怎么解决
tomcat启动闪退怎么解决

tomcat启动闪退的解决办法:1、检查java环境;2、检查环境变量配置;3、检查端口被占用;4、检查配置文件编码;5、检查启动时需要的配置文件;6、检查相关文件是否丢失;7、检查防火墙和杀毒软件设置。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

169

2024.02.23

JavaScript浏览器渲染机制与前端性能优化实践
JavaScript浏览器渲染机制与前端性能优化实践

本专题围绕 JavaScript 在浏览器中的执行与渲染机制展开,系统讲解 DOM 构建、CSSOM 解析、重排与重绘原理,以及关键渲染路径优化方法。内容涵盖事件循环机制、异步任务调度、资源加载优化、代码拆分与懒加载等性能优化策略。通过真实前端项目案例,帮助开发者理解浏览器底层工作原理,并掌握提升网页加载速度与交互体验的实用技巧。

1

2026.03.06

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
RunnerGo从入门到精通
RunnerGo从入门到精通

共22课时 | 1.8万人学习

尚学堂Mahout视频教程
尚学堂Mahout视频教程

共18课时 | 3.3万人学习

Linux优化视频教程
Linux优化视频教程

共14课时 | 3.2万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号