Tomcat 目录结构与常用管理

前置知识

建议你已完成 Tomcat 安装与基础配置。

目录

• Tomcat 目录结构与常用管理
  • 目录
  • Tomcat 目录结构详解
  • 核心配置文件说明
  • 管理控制台与用户权限
    • 1. 配置管理用户
    • 2. 访问管理后台
  • 日志管理与排查
  • 虚拟主机与多应用部署
  • 常用管理命令
  • 常见问题与小结

---

Tomcat 目录结构详解

目录	作用
bin	启动/关闭脚本、工具
conf	配置文件（server.xml、web.xml、tomcat-users.xml等）
lib	Tomcat 及 Web 应用依赖 jar 包
logs	日志文件（catalina.out、localhost.log等）
webapps	部署的 Web 应用目录（ROOT、examples等）
work	JSP 编译、缓存目录
temp	临时文件

目录结构示意

/apache-tomcat-9.0.xx/
├── bin/
├── conf/
├── lib/
├── logs/
├── temp/
├── webapps/
├── work/

核心配置文件说明

• conf/server.xml：Tomcat 最核心配置，端口、虚拟主机、连接器等
• conf/web.xml：全局 Servlet/JSP 默认配置
• conf/tomcat-users.xml：管理控制台用户与角色
• conf/context.xml：全局 Context 配置

server.xml 主要片段注释

<!--
  <Server>：Tomcat 实例，包含多个 <Service>
  <Connector>：监听端口，处理 HTTP/HTTPS 请求
  <Engine>：请求处理引擎
  <Host>：虚拟主机，可配置多个
  <Context>：Web 应用上下文
-->
<Server port="8005" shutdown="SHUTDOWN">
  <Service name="Catalina">
    <Connector port="8080" protocol="HTTP/1.1"/>
    <Engine name="Catalina" defaultHost="localhost">
      <Host name="localhost" appBase="webapps"/>
    </Engine>
  </Service>
</Server>

管理控制台与用户权限

Tomcat 自带管理后台（Manager、Host Manager），需配置用户权限。

1. 配置管理用户

编辑 conf/tomcat-users.xml，添加如下内容：

<tomcat-users>
  <role rolename="manager-gui"/>
  <role rolename="admin-gui"/>
  <user username="admin" password="123456" roles="manager-gui,admin-gui"/>
</tomcat-users>

• manager-gui：访问 Manager 应用权限
• admin-gui：访问 Host Manager 权限

2. 访问管理后台

• Manager：http://localhost:8080/manager/html
• Host Manager：http://localhost:8080/host-manager/html

安全建议

• 生产环境建议禁用或限制管理后台，仅开发测试开放
• 密码请勿使用弱口令

日志管理与排查

• 日志目录：logs/
• 主要日志文件：
  • catalina.out（主日志）
  • localhost.log（本地主机日志）
  • manager.log（管理后台日志）

日志查看与清理

# 实时查看日志
tail -f logs/catalina.out
# 清理日志
rm logs/*.log

• 日志可用于排查启动失败、端口冲突、应用异常等问题

虚拟主机与多应用部署

• Tomcat 支持配置多个虚拟主机（Host），实现一台服务器部署多个网站
• 每个 Host 可有独立的 appBase（应用目录）

server.xml 虚拟主机配置

<Host name="www.example.com" appBase="webapps_example">
  <Context path="" docBase="/data/webapps/example"/>
</Host>

• 新建应用目录，将 war 包或文件夹放入对应 appBase 即可自动部署

常用管理命令

• 启动 Tomcat：bin/startup.sh 或 bin/startup.bat
• 关闭 Tomcat：bin/shutdown.sh 或 bin/shutdown.bat
• 查看端口占用：

netstat -ano | findstr 8080  # Windows
lsof -i:8080                 # Linux

• 部署/热部署应用：将 war 包/文件夹放入 webapps 目录
• 清理 work 目录（解决 JSP 缓存问题）：

rm -rf work/*

常见问题与小结

常见问题

1. 管理后台 403/401：检查用户权限、IP 限制
2. 日志文件过大：定期清理 logs 目录
3. 虚拟主机不生效：检查 server.xml 配置、DNS 解析
4. 应用无法热部署：确认 war 包/文件夹结构正确

• 熟悉目录结构与配置文件有助于高效管理 Tomcat
• 管理后台仅限开发测试，生产环境需加强安全
• 日志是排查问题的第一手资料
• 后续将介绍 Tomcat 应用部署、性能调优与安全加固

本文为 Tomcat 系列教程第二篇，后续将介绍应用部署、性能调优与安全加固，敬请期待！