Apache Tomcat 使用教程

Apache Tomcat 是一个开源的 Java Servlet 容器，用于运行 Java Servlet 和 JavaServer Pages (JSP) 应用。以下是 Tomcat 的安装、配置和基本使用方法。

1. 下载和安装 Tomcat

下载 Tomcat

  1. 前往 Apache Tomcat 官网，选择一个稳定版本下载。
  2. 下载适用于你操作系统的二进制发行版（如 .zip 或 .tar.gz 文件）。

安装 Tomcat

  1. 将下载的压缩文件解压到一个目录中，例如 C:\tomcat 或 /usr/local/tomcat。
  2. Tomcat 不需要额外的安装步骤，只需解压即可使用。

2. 配置环境变量

为了方便使用 Tomcat，可以将 Tomcat 的 bin 目录添加到系统的环境变量中。

在 Windows 上

  1. 右键单击“此电脑”，选择“属性”。
  2. 点击“高级系统设置”，然后点击“环境变量”。
  3. 在“系统变量”中，找到并选择 Path，点击“编辑”。
  4. 点击“新建”，然后添加 Tomcat 的 bin 目录路径（例如 C:\tomcat\bin）。
  5. 点击“确定”保存设置。

在 Linux 或 macOS 上

  1. 打开终端。
  2. 编辑 .bashrc 或 .bash_profile 文件： 
    1
    nano ~/.bashrc
  3. 添加以下行： 
    1
    2
    export CATALINA_HOME=/path/to/tomcat
    export PATH=$CATALINA_HOME/bin:$PATH
  4. 保存文件并使更改生效： 
    1
    source ~/.bashrc

3. 启动和停止 Tomcat

启动 Tomcat

  1. 打开命令提示符（Windows）或终端（Linux/macOS）。
  2. 导航到 Tomcat 的 bin 目录。
  3. 运行以下命令启动 Tomcat： 
    1
    2
    startup.bat  # Windows
    ./startup.sh # Linux/macOS

停止 Tomcat

  1. 打开命令提示符（Windows）或终端（Linux/macOS）。
  2. 导航到 Tomcat 的 bin 目录。
  3. 运行以下命令停止 Tomcat： 
    1
    2
    shutdown.bat  # Windows
    ./shutdown.sh # Linux/macOS

4. 部署 Web 应用

手动部署

  1. 将你的 .war 文件复制到 Tomcat 的 webapps 目录中。
  2. Tomcat 会自动解压和部署该 .war 文件。

使用 Tomcat 管理控制台

  1. 打开浏览器，访问 Tomcat 管理控制台：http://localhost:8080/manager/html
  2. 输入管理员用户名和密码（默认情况下，用户名和密码需要在 conf/tomcat-users.xml 文件中配置）。
  3. 在“WAR file to deploy”部分，选择你的 .war 文件并点击“Deploy”按钮。

5. 配置 Tomcat

配置 Tomcat 用户

编辑 conf/tomcat-users.xml 文件，添加用户角色和凭据：

1
2
3
4
5
<tomcat-users>
    <role rolename="manager-gui"/>
    <role rolename="admin-gui"/>
    <user username="admin" password="password" roles="manager-gui,admin-gui"/>
</tomcat-users>

配置 Tomcat 端口

编辑 conf/server.xml 文件，找到如下配置，并修改 port 属性以更改 Tomcat 的默认端口：

1
2
3
4
<Connector port="8080" protocol="HTTP/1.1"
           connectionTimeout="20000"
           redirectPort="8443" />

6. 访问部署的应用

  1. 启动 Tomcat 后，打开浏览器，访问 http://localhost:8080。
  2. 你将看到 Tomcat 的默认主页。
  3. 访问已部署的应用，例如 http://localhost:8080/your-app-name。

7. 日志和调试

Tomcat 的日志文件位于 logs 目录中，常见的日志文件包括：

  • catalina.out：Tomcat 的标准输出日志。
  • localhost_access_log.*.txt：访问日志。
  • localhost.*.log：localhost 虚拟主机的日志。