Apache Tomcat 官方文档翻译站点

一、网站简介

Apache Tomcat 官方文档（tomcat.apache.org）是 Java Servlet 和 Jakarta Server Pages 容器的权威参考中心。它提供了从安装部署、应用开发到集群配置和安全管理的一站式文档体系，是 Java Web 开发者部署和运维服务端应用的基础设施级参考。

二、公司背景

Apache Tomcat 是 Apache 软件基金会的顶级项目，最初由 Sun Microsystems 捐赠代码并启动。作为全球使用最广泛的 Java Web 容器，Tomcat 为无数企业级应用和云平台提供底层支撑。当前主要维护版本为 Tomcat 10.1.x（实现 Jakarta EE 10 规范）和 Tomcat 9.0.x（实现 Java EE 8 规范），最新发布分别为 10.1.55 和 9.0.118（2026 年 5 月）。

三、核心功能

• 用户指南（User Guide）：从下载安装、目录结构说明到基本配置和常见问题排查的完整入门路径，适合首次接触 Tomcat 的开发者。
• 应用开发指南（Application Developer‘s Guide）：介绍如何使用 Tomcat 搭建开发环境、组织源代码、构建和测试 Web 应用，涵盖 Servlet、JSP、WebSocket 等 Jakarta EE 技术。
• 配置参考（Configuration Reference）：详细说明 server.xml、web.xml、context.xml 等核心配置文件的每个元素和属性，包括连接器（Connector）、虚拟主机（Host）、数据源（DataSource）的配置方法。
• 规范实现文档：列出 Tomcat 各版本实现的 Jakarta Servlet、JSP、EL、WebSocket 和 Authentication 规范的具体版本号，帮助开发者确认 API 兼容性。
• 集群与会话复制指南：介绍如何通过 DeltaManager 或 BackupManager 实现 Tomcat 集群中的 HTTP 会话共享，构建高可用部署方案。
• 安全与 SSL/TLS 配置：涵盖 HTTPS 连接器配置、证书管理、认证 Realm 设置和安全约束（Security Constraint）的详细说明。

四、网站特点

• 双版本线清晰区隔：文档明确区分 Tomcat 10.x（Jakarta EE）和 Tomcat 9.x（Java EE）两条版本线，并提供 Jakarta EE 迁移工具文档帮助用户从 9 升级到 10。
• Wiki 知识库补充：除正式文档外，Apache Tomcat Wiki 提供了 FAQ、监控技巧、性能调优经验和第三方资源链接，是正式文档的有力补充。
• 详细变更日志：每个版本均有详尽的 changelog，记录每一个 bug 修复、功能增强和配置变更，方便运维人员评估升级影响。
• 多格式文档覆盖：同时提供在线 HTML 文档和 PDF 下载版本，满足不同使用场景。

五、适用人群

• Java Web 开发工程师：学习 Servlet/JSP 开发规范，调试应用部署问题，参考配置参数优化应用性能。
• 运维工程师：负责 Tomcat 服务器的安装、集群配置、性能调优和安全加固。
• 企业架构师：在技术选型中评估 Tomcat 作为 Servlet 容器的成熟度、社区活跃度和企业级支持。
• 中间件管理员：管理生产环境中数十甚至数百个 Tomcat 实例的配置标准化和批量运维。

六、应用场景

• Spring Boot 应用部署：将 Spring Boot 打包为 WAR 文件部署到 Tomcat，查阅配置参考优化连接池和线程池参数以应对高并发。
• 传统企业级 Web 应用：运行基于 Servlet 3.1/JSP 2.3 的遗留企业管理系统，查阅 Tomcat 9.0 文档进行维护和升级。
• 反向代理架构：在 Tomcat 前部署 Nginx/HTTPD 做反向代理，通过 AJP 连接器文档配置高效的代理通信协议。
• 微服务容器化部署：将 Tomcat 作为基础镜像构建 Docker 容器，查阅环境变量和安全配置文档实现无状态部署。

七、常见问题（FAQ）

Q：国内能否直接访问？
A：可以。tomcat.apache.org 为 Apache 官方域名，在国内网络环境下可以正常直接访问。

Q：Tomcat 10 和 Tomcat 9 有什么区别，应该用哪个？
A：Tomcat 10 实现了 Jakarta EE 10 规范，包名从 javax.* 变为 jakarta.*，不向后兼容旧的 Java EE 应用。Tomcat 9 实现 Java EE 8 规范。如果是新项目，推荐直接使用 Tomcat 10；如果维护遗留应用，使用 Tomcat 9。Tomcat 10 内置了迁移工具帮助自动转换旧应用。

Q：Tomcat 默认端口是多少，如何修改？
A：Tomcat 默认 HTTP 端口为 8080，HTTPS 端口为 8443，关闭端口为 8005。修改 conf/server.xml 中 Connector 元素的 port 属性即可更改。文档的配置参考章节有详细的 Connector 配置说明。

Q：Tomcat 适合直接在生产环境中暴露给外部流量吗？
A：官方不建议将 Tomcat 直接暴露在生产环境最前端。推荐在前端部署 Nginx 或 Apache HTTP Server 作为反向代理，处理静态资源和 SSL 终止，将动态请求转发给后端 Tomcat。文档中有 Nginx 反向代理配置的专题说明。

八、类似网站

• Jetty 官方文档：Eclipse 基金会维护的轻量级 Servlet 容器，以嵌入式模式著称。
• Undertow 官方文档：Red Hat 开发的灵活高性能 Web 服务器，为 WildFly 应用服务器核心。
• GlassFish 官方文档：Eclipse 基金会维护的完整 Jakarta EE 应用服务器，功能比 Tomcat 更全面。