Tomcat 9+ 版本默认主页迁移至 webapps.dist

文章目录

• • • 官方说明
    • 修改的意义或目的
    • 如何恢复默认主页？
    • 总结

在 Apache Tomcat 9.0.x 版本中，默认的主页和示例应用从 webapps 目录移动到了 webapps.dist 目录。这一变化从 Tomcat 9.0.0.M4 (Milestone 4) 开始引入，并在后续版本中保持。

官方说明

根据 Apache Tomcat 官方文档和发布说明：

• 在 Tomcat 9.0.0.M4 的 Release Notes 中提到： "The default web applications (ROOT, examples, docs, etc.) are now packaged in the webapps.dist directory. To install them, users must manually copy them to the webapps directory."

修改的意义或目的

1. 安全性增强 ：
   • 默认不部署示例应用（如 examples、docs）可以减少潜在的安全风险，因为这些应用可能包含已知漏洞或暴露不必要的功能。
   • 用户需要显式启用这些应用，避免在生产环境中误用。
2. 最小化默认部署 ：
   • Tomcat 更倾向于提供一个"干净"的启动环境，避免不必要的资源占用。
   • 用户可以根据需求选择性部署示例或文档。
3. 容器化友好 ：
   • 在 Docker 或云原生环境中，轻量化的默认配置更符合最佳实践，用户可以通过卷挂载或构建镜像时自行决定是否包含示例应用。

如何恢复默认主页？

如果希望启用默认的主页（ROOT）和示例应用，需手动将 webapps.dist 中的内容复制到 webapps 目录：

cp -r webapps.dist/* webapps/

然后重启 Tomcat 即可访问 http://localhost:8080 的主页。

总结

• 版本影响：Tomcat 9.0.0.M4 及后续版本（包括 Tomcat 10.x）。
• 目的：提高安全性、减少默认部署、适应现代化部署场景。
• 官方依据 ：Tomcat 9.0 的 Changelog 和 邮件列表讨论。

这一变更是 Tomcat 项目对安全性和灵活性的权衡，符合当前服务器软件的简化趋势。