3.2 Tomcat 安装步骤

文档摘要

3.2 Tomcat 安装步骤 3.2 Tomcat 安装步骤 Tomcat 作为一款流行的开源 Servlet 容器，被广泛应用于 Java Web 应用的部署和运行。本章节将详细介绍 Tomcat 的安装步骤，帮助你快速搭建 Tomcat 运行环境。Tomcat 的安装过程相对简单，主要包括环境准备、下载 Tomcat、解压安装、配置环境变量（可选）以及启动和验证安装。 3.2.1 环境准备在安装 Tomcat 之前，需要确保你的系统已经安装了 Java Development Kit (JDK)。Tomcat 是一个 Java 应用程序，因此必须依赖 Java 运行时环境。 1.

3.2 Tomcat 安装步骤

Tomcat 作为一款流行的开源 Servlet 容器，被广泛应用于 Java Web 应用的部署和运行。本章节将详细介绍 Tomcat 的安装步骤，帮助你快速搭建 Tomcat 运行环境。Tomcat 的安装过程相对简单，主要包括环境准备、下载 Tomcat、解压安装、配置环境变量（可选）以及启动和验证安装。

3.2.1 环境准备

在安装 Tomcat 之前，需要确保你的系统已经安装了 Java Development Kit (JDK)。Tomcat 是一个 Java 应用程序，因此必须依赖 Java 运行时环境。

1. 检查 JDK 安装：

打开终端（Linux/macOS）或命令提示符（Windows），输入以下命令检查 Java 版本：


java -version

如果你的系统已经安装了 JDK，并且配置了环境变量，你将会看到类似以下的输出信息，其中会显示 Java 的版本信息：


java version "1.8.0_291"
Java(TM) SE Runtime Environment (build 1.8.0_291-b10)
Java HotSpot(TM) 64-Bit Server VM (build 25.291-b10, mixed mode)

如果命令 java -version 无法识别，或者显示的 Java 版本过低（Tomcat 通常建议使用 JDK 8 或更高版本，具体版本兼容性请参考 Tomcat 官方文档），你需要先安装或更新 JDK。

2. 安装 JDK (如果需要)：

你可以从 Oracle 官网或者 OpenJDK 项目下载适合你操作系统的 JDK 版本。

Oracle JDK: 访问 Oracle Java 官方下载页面 (以 JDK 15 为例，请根据实际情况选择版本)，根据你的操作系统选择合适的安装包进行下载并安装。安装过程中请注意记录 JDK 的安装路径。
OpenJDK: 对于 Linux 系统，通常可以使用包管理器直接安装 OpenJDK。例如，在 Debian/Ubuntu 系统上，可以使用 apt 命令：


sudo apt update
sudo apt install openjdk-11-jdk  # 安装 OpenJDK 11，可选择其他版本

在 CentOS/RHEL 系统上，可以使用 yum 命令：


sudo yum update
sudo yum install java-11-openjdk-devel # 安装 OpenJDK 11，可选择其他版本

安装完成后，再次使用 java -version 命令验证 JDK 是否安装成功。

3. 配置 JAVA_HOME 环境变量 (推荐)：

为了方便 Tomcat 找到 Java 运行时环境，建议配置 JAVA_HOME 环境变量，指向 JDK 的安装目录。

Linux/macOS:

打开终端，编辑 ~/.bashrc 或 ~/.zshrc 文件 (取决于你使用的 shell)，在文件末尾添加以下内容，并将 /path/to/jdk 替换为你的 JDK 安装路径：


export JAVA_HOME=/path/to/jdk
export PATH=$JAVA_HOME/bin:$PATH

例如，如果你的 JDK 安装在 /usr/lib/jvm/java-11-openjdk-amd64，则配置应为：


export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64
export PATH=$JAVA_HOME/bin:$PATH

保存文件后，执行以下命令使配置生效：


source ~/.bashrc  # 或 source ~/.zshrc

Windows:
1. 右键点击 "此电脑" 或 "我的电脑"，选择 "属性"。
2. 点击 "高级系统设置"。
3. 在 "系统属性" 窗口中，点击 "环境变量" 按钮。
4. 在 "系统变量" 区域，点击 "新建"。
5. 变量名输入 JAVA_HOME，变量值输入你的 JDK 安装路径，例如 C:\Program Files\Java\jdk-11.0.12 (实际路径可能不同)。
6. 在 "系统变量" 区域，找到名为 Path 的变量，选中并点击 "编辑"。
7. 在 "编辑环境变量" 窗口中，点击 "新建"，添加 %JAVA_HOME%\bin。
8. 点击 "确定" 关闭所有窗口。
配置完成后，重新打开命令提示符，再次使用 java -version 命令验证环境变量是否配置成功。

3.2.2 下载 Tomcat

Tomcat 可以从 Apache Tomcat 官网下载。访问 Apache Tomcat 下载页面 (以 Tomcat 9 为例，请根据实际情况选择版本)。

1. 选择 Tomcat 版本：

在下载页面，你会看到不同版本的 Tomcat，例如 Tomcat 9, Tomcat 10, Tomcat 8 等。通常建议选择最新的稳定版本。请注意 Tomcat 版本与 Java 版本之间的兼容性，具体可以参考 Tomcat 官方文档。

2. 选择发行版本：

在每个 Tomcat 版本下，你会看到 "Binary Distributions" (二进制发行版) 和 "Source Distributions" (源码发行版)。对于安装和运行 Tomcat，我们通常选择 Binary Distributions。

在 "Binary Distributions" 下，根据你的操作系统选择合适的压缩包格式：

Core: 核心发行版，包含运行 Tomcat 所需的最基本组件。
Windows zip: Windows 操作系统下的 ZIP 压缩包。
tar.gz: Linux/macOS 操作系统下的 tar.gz 压缩包。

通常选择 "Core" 下的 apache-tomcat-x.x.xx.zip (Windows) 或 apache-tomcat-x.x.xx.tar.gz (Linux/macOS) 文件进行下载。

mermaid graph TD


A[访问 Tomcat 官网下载页] --> B{选择 Tomcat 版本};

B --> C{选择 Binary Distributions};

C --> D{选择 Core 发行版};

D --> E{选择压缩包格式 (zip/tar.gz)};

E --> F[下载压缩包];

F --> G[下载完成];

style A fill:#f9f,stroke:#333,stroke-width:2px

style G fill:#ccf,stroke:#333,stroke-width:2px

3.2.3 解压安装 Tomcat

下载完成后，需要将 Tomcat 压缩包解压到你想要安装 Tomcat 的目录。Tomcat 的安装实际上就是解压过程，解压后的目录即为 Tomcat 的安装目录。

1. 创建 Tomcat 安装目录 (可选)：

你可以选择将 Tomcat 解压到任何你希望的位置。为了组织方便，建议在你的系统上创建一个专门用于存放 Tomcat 的目录，例如 /opt/tomcat (Linux/macOS) 或 C:\Tomcat (Windows)。当然，你也可以直接解压到用户主目录或其他位置。

2. 解压压缩包：

Linux/macOS:

打开终端，进入你存放 Tomcat 压缩包的目录，使用 tar 命令解压 .tar.gz 文件。例如，如果压缩包在 ~/Downloads 目录，并且你想要解压到 /opt/tomcat 目录：


sudo mkdir /opt/tomcat  # 如果 /opt/tomcat 目录不存在，则创建
sudo tar -zxvf ~/Downloads/apache-tomcat-9.0.xx.tar.gz -C /opt/tomcat

解压后，Tomcat 的目录结构将会出现在 /opt/tomcat/apache-tomcat-9.0.xx 下。为了方便后续操作，可以将解压后的目录重命名为 tomcat (可选)：


sudo mv /opt/tomcat/apache-tomcat-9.0.xx /opt/tomcat/tomcat

Windows:

找到下载的 ZIP 压缩包，右键点击压缩包，选择 "解压到..." 或 "提取到..."，选择你想要安装 Tomcat 的目录，例如 C:\Tomcat。解压后，Tomcat 的目录结构将会出现在 C:\Tomcat\apache-tomcat-9.0.xx 下。同样，为了方便，可以将解压后的目录重命名为 tomcat (可选)：

将 C:\Tomcat\apache-tomcat-9.0.xx 重命名为 C:\Tomcat\tomcat。

3. Tomcat 目录结构详解：

解压完成后，进入 Tomcat 安装目录，你会看到以下主要目录和文件：


tomcat/
├── bin/          # 存放启动、停止 Tomcat 的脚本文件 (startup.sh, shutdown.sh, catalina.sh 等)
├── conf/         # 存放 Tomcat 的配置文件 (server.xml, web.xml, context.xml, tomcat-users.xml 等)
├── lib/          # 存放 Tomcat 运行时需要的 JAR 包
├── logs/         # 存放 Tomcat 的日志文件 (catalina.out, localhost.log, manager.log 等)
├── temp/         # 存放 Tomcat 运行时创建的临时文件
├── webapps/      # 默认的 Web 应用部署目录，可以将你的 Web 应用 war 包或解压后的 Web 应用目录放在这里
├── work/         # 存放 Tomcat 运行时的工作目录，用于编译 JSP 文件等
├── LICENSE       # Tomcat 许可证文件
├── NOTICE        # Tomcat 注意事项文件
└── README.txt    # Tomcat README 文件

mermaid graph TD


subgraph Tomcat 安装目录

    bin

    conf

    lib

    logs

    temp

    webapps

    work

    LICENSE

    NOTICE

    README.txt

end

style bin fill:#f9f9f9,stroke:#333,stroke-dasharray: 5 5

style conf fill:#f9f9f9,stroke:#333,stroke-dasharray: 5 5

style lib fill:#f9f9f9,stroke:#333,stroke-dasharray: 5 5

style logs fill:#f9f9f9,stroke:#333,stroke-dasharray: 5 5

style temp fill:#f9f9f9,stroke:#333,stroke-dasharray: 5 5

style webapps fill:#f9f9f9,stroke:#333,stroke-dasharray: 5 5

style work fill:#f9f9f9,stroke:#333,stroke-dasharray: 5 5

3.2.4 配置 CATALINA_HOME 环境变量 (可选但推荐)

虽然 Tomcat 可以不配置 CATALINA_HOME 环境变量直接运行，但配置 CATALINA_HOME 可以让 Tomcat 的启动脚本更清晰地知道 Tomcat 的安装位置，也方便在其他脚本或程序中引用 Tomcat 安装目录。

1. 配置 CATALINA_HOME 环境变量：

Linux/macOS:

编辑 ~/.bashrc 或 ~/.zshrc 文件，在 JAVA_HOME 环境变量配置的下方，添加以下内容，并将 /opt/tomcat/tomcat 替换为你的 Tomcat 安装目录：


export CATALINA_HOME=/opt/tomcat/tomcat
export PATH=$CATALINA_HOME/bin:$PATH  # 可选，如果需要直接在命令行运行 startup.sh/shutdown.sh 等脚本

例如，如果 Tomcat 安装在 /opt/tomcat/tomcat，则配置应为：


export CATALINA_HOME=/opt/tomcat/tomcat
export PATH=$CATALINA_HOME/bin:$PATH

保存文件后，执行 source ~/.bashrc 或 source ~/.zshrc 使配置生效。

Windows:
1. 按照配置 JAVA_HOME 环境变量的步骤，打开 "环境变量" 设置窗口。
2. 在 "系统变量" 区域，点击 "新建"。
3. 变量名输入 CATALINA_HOME，变量值输入你的 Tomcat 安装目录，例如 C:\Tomcat\tomcat。
4. 如果你希望在命令提示符中直接运行 Tomcat 的脚本，可以编辑 Path 环境变量，添加 %CATALINA_HOME%\bin。
5. 点击 "确定" 关闭所有窗口。

配置完成后，重新打开终端或命令提示符。

3.2.5 启动 Tomcat

Tomcat 提供了启动和停止服务器的脚本，位于 Tomcat 安装目录的 bin 目录下。

1. 启动脚本：

Linux/macOS: 使用 startup.sh 脚本启动 Tomcat。

打开终端，进入 Tomcat 安装目录的 bin 目录：


cd /opt/tomcat/tomcat/bin  # 替换为你的 Tomcat 安装目录
./startup.sh

或者，如果你已经配置了 CATALINA_HOME 环境变量并将其 bin 目录添加到 PATH，可以直接在任何目录下执行：


startup.sh

Windows: 使用 startup.bat 脚本启动 Tomcat。

打开命令提示符，进入 Tomcat 安装目录的 bin 目录：


cd C:\Tomcat\tomcat\bin  # 替换为你的 Tomcat 安装目录
startup.bat

或者，如果配置了 CATALINA_HOME 和 PATH，可以直接执行：


startup.bat

2. 查看启动日志：

启动 Tomcat 后，可以查看 logs 目录下的 catalina.out 文件 (Linux/macOS) 或 catalina.yyyy-MM-dd.log 文件 (Windows) 查看启动日志，确认 Tomcat 是否成功启动。

在 Linux/macOS 上，可以使用 tail -f logs/catalina.out 命令实时查看日志。

3. 验证 Tomcat 启动：

打开浏览器，访问 http://localhost:8080。如果 Tomcat 成功启动，你将会看到 Tomcat 的默认欢迎页面，通常显示 "It works!" 或者 Tomcat 的标志性猫咪图片。

mermaid graph TD


A[执行 startup.sh 或 startup.bat] --> B{Tomcat 启动进程};

B --> C{加载配置};

C --> D{初始化 Servlet 容器};

D --> E{部署 Web 应用 (webapps 目录)};

E --> F{启动 Web 服务};

F --> G[Tomcat 启动完成];

G --> H[访问 http://localhost:8080];

H --> I{显示 Tomcat 默认页};

style A fill:#f9f,stroke:#333,stroke-width:2px

style I fill:#ccf,stroke:#333,stroke-width:2px

3.2.6 停止 Tomcat

当你需要停止 Tomcat 服务器时，可以使用停止脚本。

1. 停止脚本：

Linux/macOS: 使用 shutdown.sh 脚本停止 Tomcat。

打开终端，进入 Tomcat 安装目录的 bin 目录，执行：


cd /opt/tomcat/tomcat/bin  # 替换为你的 Tomcat 安装目录
./shutdown.sh

或者，如果配置了 CATALINA_HOME 和 PATH，可以直接执行：


shutdown.sh

Windows: 使用 shutdown.bat 脚本停止 Tomcat。

打开命令提示符，进入 Tomcat 安装目录的 bin 目录，执行：


cd C:\Tomcat\tomcat\bin  # 替换为你的 Tomcat 安装目录
shutdown.bat

或者，如果配置了 CATALINA_HOME 和 PATH，可以直接执行：


shutdown.bat

2. 查看停止日志：

停止 Tomcat 后，可以再次查看 logs/catalina.out 或 catalina.yyyy-MM-dd.log 文件，确认 Tomcat 是否成功停止。

3.2.7 常见问题排查

在 Tomcat 安装和启动过程中，可能会遇到一些问题。以下是一些常见问题和排查思路：

1. 端口占用：

如果 Tomcat 启动失败，并在日志中看到类似 "Address already in use" 的错误信息，可能是 8080 端口被其他程序占用。

解决方法:
- 查找占用 8080 端口的进程并停止它，或者修改 Tomcat 的端口配置 (在 conf/server.xml 文件中修改 Connector 元素的 port 属性)。
- 使用命令查看端口占用情况：
  - Linux/macOS: sudo lsof -i :8080 或 netstat -tulnp | grep 8080
  - Windows: netstat -ano | findstr "8080"

2. JAVA_HOME 未正确配置：

如果启动脚本找不到 Java 运行时环境，可能是 JAVA_HOME 环境变量未正确配置。

解决方法:
- 检查 JAVA_HOME 环境变量是否已配置，并且指向正确的 JDK 安装目录。
- 检查 PATH 环境变量是否包含了 %JAVA_HOME%\bin (Windows) 或 $JAVA_HOME/bin (Linux/macOS)。

3. 权限问题：

在 Linux/macOS 系统上，如果解压后的 Tomcat 目录权限不正确，可能会导致启动脚本无法执行或日志文件无法写入。

解决方法:
- 确保 Tomcat 安装目录及其子目录具有执行权限。可以使用 chmod +x *.sh 命令给 bin 目录下的脚本添加执行权限。
- 确保 Tomcat 进程运行的用户具有写入 logs、temp、work 等目录的权限。

4. Tomcat 版本与 Java 版本不兼容：

如果使用的 Tomcat 版本与 Java 版本不兼容，可能会导致启动失败或运行时错误。

解决方法:
- 查阅 Tomcat 官方文档，确认你使用的 Tomcat 版本与 Java 版本的兼容性。
- 升级或降级 Java 版本，或者更换 Tomcat 版本，使其版本兼容。

5. 内存不足：

如果系统内存不足，Tomcat 启动可能会失败或运行缓慢。

解决方法:
- 释放系统内存，关闭不必要的程序。
- 增加 JVM 内存配置 (可以通过修改 bin/catalina.sh 或 bin/catalina.bat 文件中的 JAVA_OPTS 环境变量来设置 JVM 内存参数，例如 -Xms512m -Xmx1024m)。

通过以上步骤，你应该能够成功安装和启动 Tomcat 服务器。后续章节将介绍 Tomcat 的配置和 Web 应用的部署。

作者与出处

原作者：灏天文库

来源：灏天文库

原文： https://aiknowledge.cn/collection/182-tomcat-web%E6%9C%8D%E5%8A%A1%E5%99%A8%E9%85%8D%E7%BD%AE%E4%B8%8E%E7%AE%A1%E7%90%86

整理：灏天文库整理

由灏天文库平台收录，内容或由平台用户上传，仅供学习交流