Tomcat 基础与安装配置

前置知识

建议你已掌握 Java 基础、Servlet 基础，对 Web 应用有初步了解。

目录

• Tomcat 基础与安装配置
  • 目录
  • Tomcat 简介与应用场景
  • 主要特性与架构
  • 安装前准备
  • Tomcat 下载与安装
  • 环境变量配置
    • Windows
    • Linux
  • 启动与关闭 Tomcat
    • Windows
    • Linux
  • 目录结构初览
  • 常见问题与小结

---

Tomcat 简介与应用场景

Tomcat 是 Apache 软件基金会开发的开源 Java Web 服务器和 Servlet 容器。

• 支持 Servlet、JSP、WebSocket 等 Java Web 技术
• 轻量级、易于部署、广泛应用于开发和生产环境
• 适合中小型网站、微服务、REST API、企业应用等

主要特性与架构

• 支持 Servlet/JSP 规范
• 支持 HTTPS、虚拟主机、会话管理
• 热部署、自动重载
• 可扩展、插件丰富

Tomcat 架构简图

graph TD;
A[客户端] -->|HTTP| B[Connector 连接器];
B --> C[Engine 引擎];
C --> D[Host 虚拟主机];
D --> E[Context 应用];
E --> F[Servlet/JSP];

安装前准备

• JDK 安装：Tomcat 需依赖 JDK，建议 JDK 8 及以上
• 操作系统：支持 Windows、Linux、macOS
• 内存建议：开发 512M+，生产 2G+

检查 JDK

java -version
javac -version

Tomcat 下载与安装

1. 访问 Tomcat 官网
2. 选择合适版本（推荐 9.x/10.x，兼容性好）
3. 下载 zip（Windows）或 tar.gz（Linux）包
4. 解压到任意目录（如 D:/dev/tomcat9 或 /usr/local/tomcat9）

下载与解压命令（Linux）

wget https://dlcdn.apache.org/tomcat/tomcat-9/v9.0.xx/bin/apache-tomcat-9.0.xx.tar.gz
# 解压
sudo tar -zxvf apache-tomcat-9.0.xx.tar.gz -C /usr/local/

环境变量配置

Windows

1. 右键"此电脑"→属性→高级系统设置→环境变量
2. 新建 CATALINA_HOME，值为 Tomcat 解压路径
3. 编辑 Path，添加 %CATALINA_HOME%\bin

Linux

在 ~/.bashrc 或 /etc/profile 添加：

export CATALINA_HOME=/usr/local/apache-tomcat-9.0.xx
export PATH=$PATH:$CATALINA_HOME/bin

配置生效

source ~/.bashrc

启动与关闭 Tomcat

Windows

• 启动：双击 bin/startup.bat
• 关闭：双击 bin/shutdown.bat

Linux

• 启动：$CATALINA_HOME/bin/startup.sh
• 关闭：$CATALINA_HOME/bin/shutdown.sh

启动日志查看

# 查看启动日志
cat $CATALINA_HOME/logs/catalina.out

• 启动成功后，访问 http://localhost:8080 出现 Tomcat 欢迎页

目录结构初览

Tomcat 主要目录说明：

目录	作用
bin	启动/关闭脚本
conf	配置文件（server.xml/web.xml）
lib	依赖 jar 包
logs	日志文件
webapps	部署的 Web 应用目录
work	编译/缓存目录
temp	临时文件

conf/server.xml 片段注释

<!--
  server.xml 是 Tomcat 最核心的配置文件
  主要配置端口、虚拟主机、连接器等
-->
<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>

常见问题与小结

常见问题

1. 无法启动/端口被占用：检查 8080 端口是否被其他程序占用
2. JDK 未配置/找不到 JAVA_HOME：检查环境变量
3. 访问 404/403：检查 webapps 目录、权限、应用部署
4. 乱码问题：修改 conf/server.xml，设置 URIEncoding="UTF-8"

• Tomcat 安装简单，建议优先用 zip/tar 包手动安装
• 环境变量配置有助于命令行操作与多版本管理
• 推荐熟悉目录结构，便于后续配置与排查
• 后续将介绍 Tomcat 管理、部署、调优等内容

本文为 Tomcat 系列教程第一篇，后续将介绍目录结构、管理与部署、性能调优等内容，敬请期待！