Tomcat 新手入门指南

Tomcat 新手入门指南

Apache Tomcat 是一个开源的 Java Servlet 容器和 Web 服务器，广泛用于部署和运行 Java Web 应用程序。以下是 Tomcat 的入门指南，帮助你快速上手。

1. 安装 Tomcat

步骤 1: 下载 Tomcat

• 访问 Apache Tomcat 官网。
• 选择适合的版本（如 Tomcat 9.x）并下载压缩包（zip 或 tar.gz）。

步骤 2: 解压文件

• 将下载的压缩包解压到指定目录，如 /opt/tomcat 或 C:\tomcat。

步骤 3: 设置环境变量

• 在 Linux/macOS 上，编辑 ~/.bashrc 或 ~/.zshrc 文件，添加：

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

• 在 Windows 上，通过系统属性设置 CATALINA_HOME 环境变量。

步骤 4: 启动 Tomcat

• 在 Linux/macOS 上，运行：

  $CATALINA_HOME/bin/startup.sh
  

• 在 Windows 上，运行：

  %CATALINA_HOME%\bin\startup.bat
  

步骤 5: 验证安装

• 打开浏览器，访问 http://localhost:8080，看到 Tomcat 欢迎页面即表示安装成功。

2. 部署 Web 应用

步骤 1: 准备 WAR 文件

• 将 Java Web 应用打包为 WAR 文件，如 myapp.war。

步骤 2: 部署 WAR 文件

• 将 WAR 文件复制到 $CATALINA_HOME/webapps 目录。
• Tomcat 会自动解压并部署应用。

步骤 3: 访问应用

• 打开浏览器，访问 http://localhost:8080/myapp。

3. 配置 Tomcat

步骤 1: 修改端口

• 编辑 $CATALINA_HOME/conf/server.xml，找到 <Connector> 标签，修改 port 属性：

  <Connector port="8080" protocol="HTTP/1.1" ... />
  

步骤 2: 配置用户角色

• 编辑 $CATALINA_HOME/conf/tomcat-users.xml，添加管理员用户：

  <role rolename="manager-gui"/>
  <user username="admin" password="password" roles="manager-gui"/>
  

步骤 3: 重启 Tomcat

• 修改配置后，重启 Tomcat 使更改生效。

4. 管理 Tomcat

步骤 1: 使用管理界面

• 访问 http://localhost:8080/manager/html，使用配置的用户名和密码登录，管理应用。

步骤 2: 查看日志

• 日志文件位于 $CATALINA_HOME/logs 目录，如 catalina.out。

步骤 3: 停止 Tomcat

• 在 Linux/macOS 上，运行：

  $CATALINA_HOME/bin/shutdown.sh
  

• 在 Windows 上，运行：

  %CATALINA_HOME%\bin\shutdown.bat
  

5. 常见问题

问题 1: 端口冲突

• 确保 8080 端口未被占用，或修改 server.xml 中的端口号。

问题 2: 权限不足

• 在 Linux/macOS 上，确保 Tomcat 目录有适当的读写权限。

问题 3: 应用无法访问

• 检查 WAR 文件是否正确部署，或查看日志文件排查问题。

总结

通过以上步骤，你应该能够成功安装、配置和管理 Tomcat，并部署 Java Web 应用。随着经验的积累，你可以进一步探索 Tomcat 的高级功能。