Tomcat

Tomcat

Tomcat 是 Apache 开源的 Java Web 应用服务器,用于部署、运行和管理 Servlet、JSP 及 Java Web 应用程序。

开发环境Java开发Web服务器
142 浏览19 下载

使用文档

1 篇文档 · 22 个章节

Tomcat 下载安装和使用教程

Apache Tomcat 是 Java Web 开发中最核心的 Servlet 容器之一,开源、轻量,部署一个 .war 包就能让 Web 应用跑起来。下面从版本选择、各平台安装,到启动验证和项目部署,完整走一遍。


一、安装前必读:版本与 JDK 的选择

Tomcat 本身是纯 Java 程序,必须先安装 JDK,而且 Tomcat 版本与 JDK 版本、Servlet API 命名空间直接挂钩,选错版本会导致项目无法运行。

Tomcat 版本 所需的 JDK 最低版本 Servlet 命名空间 适用场景
Tomcat 9.x JDK 8+ javax.servlet.* 维护老项目,或依赖 javax.* 的遗留系统
Tomcat 10.1.x JDK 11+ jakarta.servlet.* 新项目主流选择,稳定成熟
Tomcat 11.x JDK 11+ jakarta.servlet.* 最新规范,适合尝鲜或新项目起步

关键分水岭:Tomcat 10 及以后版本把 javax.servlet 全面替换为 jakarta.servlet。如果你的项目代码里还在 import javax.servlet.*,部署到 Tomcat 10/11 上会直接报 ClassNotFoundException 或 NoClassDefFoundError,需要先做代码迁移,或者退回 Tomcat 9。

安装 JDK 后,务必确认 JAVA_HOME 指向的是 JDK 目录(不是 JRE),并在命令行验证:

bash
java -version
javac -version

两个命令都能输出版本号,才算 JDK 环境就绪。

二、下载 Tomcat

Tomcat 官网地址:https://tomcat.apache.org/

进入官网后,左侧选择需要的版本(如 Tomcat 10、Tomcat 11),在 Binary Distributions 区域按平台下载:

  • Windows:下载 apache-tomcat-x.x.x-windows-x64.zip(绿色解压版,最推荐)或 .exe(Windows Service Installer,安装为系统服务)。
  • Linux / macOS:下载 apache-tomcat-x.x.x.tar.gz。

如果官网下载速度慢,也可以从国内镜像站(如阿里云、华为云镜像)获取对应版本的二进制包,文件结构完全一致。

三、Windows 安装(ZIP 绿色版,最常用)

Tomcat 在 Windows 上不需要传统意义上的“安装”,解压 + 配置环境变量即可使用。

1. 解压

将下载的 .zip 解压到路径不含中文和空格的目录,例如:

D:\tomcat\apache-tomcat-10.1.xx

解压后你会看到以下关键目录:

目录 用途
bin/ 启动/停止脚本(startup.bat、shutdown.bat)
conf/ 配置文件(server.xml、tomcat-users.xml 等)
webapps/ Web 应用部署目录,.war 包放这里
logs/ 运行日志(排错首先看这里)
lib/ Tomcat 依赖的 JAR 包

2. 配置环境变量(推荐,非强制)

虽然不配也能通过双击 startup.bat 启动,但配置后可以在任意命令行直接执行启停命令,也便于排查问题。

  • 新建系统变量 CATALINA_HOME,值为 Tomcat 解压目录,例如 D:\tomcat\apache-tomcat-10.1.xx。
  • 编辑系统变量 Path,新增一项 %CATALINA_HOME%\bin。

配置完成后,可以打开新的命令提示符验证:

cmd
echo %CATALINA_HOME%

3. 启动与验证

方式一(最直接) :进入 bin 目录,双击 startup.bat,会弹出一个命令行窗口并持续输出启动日志。这个窗口不要关闭,关掉窗口 Tomcat 就停了。

方式二(配置环境变量后) :在命令行中直接执行 startup。

启动成功的标志是在日志末尾附近看到类似 Server startup in xxx ms 的提示,然后在浏览器访问:

http://localhost:8080

如果看到 Tomcat 的默认欢迎页(一只猫的图标),说明安装和启动都成功了。

4. 停止

双击 bin/shutdown.bat,或命令行执行 shutdown。不要直接点击启动窗口的“×”关闭,那样可能导致进程残留,下次启动时报端口占用。

四、Linux 安装(tar.gz 解压版)

Linux 下的思路与 Windows 绿色版一致:先确认 JDK,再解压 Tomcat,最后通过脚本启停。

1. 确认或安装 JDK

bash
java -version

若未安装,以 Ubuntu/Debian 为例:

bash
sudo apt install openjdk-17-jdk

RHEL/CentOS 系可用 sudo yum install java-17-openjdk-devel。

2. 解压到目标目录

bash
tar -zxvf apache-tomcat-10.1.xx.tar.gz -C /opt

解压后得到 /opt/apache-tomcat-10.1.xx。为方便多版本管理,可以创建一个符号链接:

bash
ln -s /opt/apache-tomcat-10.1.xx /opt/tomcat

后续统一用 /opt/tomcat 指代。

3. 配置环境变量

编辑 ~/.bashrc 或 /etc/profile,加入:

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

执行 source ~/.bashrc(或 source /etc/profile)使配置生效。

4. 启动、停止与排错

bash
# 启动
$CATALINA_HOME/bin/startup.sh

# 停止
$CATALINA_HOME/bin/shutdown.sh

# 前台运行(排错时非常有用,日志直接输出到终端)
$CATALINA_HOME/bin/catalina.sh run

如果启动失败,第一优先级是查看日志:

bash
tail -f $CATALINA_HOME/logs/catalina.out

常见的失败原因包括:JAVA_HOME 未设置、bin/*.sh 没有执行权限(chmod +x *.sh)、端口被占用等。

5. 开放防火墙(如需远程访问)

bash
# Ubuntu (ufw)
sudo ufw allow 8080/tcp

# CentOS/RHEL (firewalld)
sudo firewall-cmd --permanent --add-port=8080/tcp
sudo firewall-cmd --reload

云服务器还需要在安全组中放行 8080 端口。

五、简单使用:部署你的第一个 Web 应用

方式一:直接放置 WAR 包(最常用)

将项目打包为 .war 文件(Maven 项目执行 mvn clean package 即可在 target/ 下生成),然后把 xxx.war 复制到 webapps/ 目录。

Tomcat 运行时会自动检测到新的 WAR 包,自动解压并部署。稍等几秒,访问:

http://localhost:8080/xxx/

其中 xxx 是 WAR 文件的名称(不含 .war)。Tomcat 同时会在 webapps/ 下生成一个同名的 xxx/ 文件夹,那就是解压后的应用目录。

方式二:通过 Manager 管理界面部署

Tomcat 自带一个 Web 管理控制台,可以在浏览器中完成部署、启停、卸载等操作。

启用 Manager 用户:默认情况下 Manager 是锁定的,需要编辑 conf/tomcat-users.xml,在 <tomcat-users> 标签内添加:

xml
<role rolename="manager-gui"/>
<user username="admin" password="你的密码" roles="manager-gui"/>

保存后重启 Tomcat,访问:

http://localhost:8080/manager/html

用刚配置的账号登录,即可在页面上传 WAR 包进行在线部署。

安全提醒:生产环境务必为 Manager 设置强密码,并尽量限制其访问来源(通过 context.xml 中的 RemoteAddrValve 限制 IP),避免暴露在公网。

六、必知配置:改端口与解决乱码

修改默认端口(8080 被占用时)

编辑 conf/server.xml,找到 HTTP Connector 所在行:

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

将 port="8080" 改为你想要的端口(如 8088、9090),保存后重启 Tomcat,访问地址相应变为 http://localhost:8088。

解决控制台日志乱码

Windows 下启动时控制台出现乱码,通常是编码不匹配。编辑 conf/logging.properties,找到:

java.util.logging.ConsoleHandler.encoding = UTF-8

将其改为:

java.util.logging.ConsoleHandler.encoding = GBK

保存后重启 Tomcat,乱码通常即可消除。

七、常见问题速查

① 双击 startup.bat 一闪而过

几乎总是 JAVA_HOME 没配好或指向了 JRE。在命令行执行 echo %JAVA_HOME% 检查,确保它指向 JDK 根目录(路径末尾不要带 bin)。

② 启动后访问 localhost:8080 打不开

先看启动窗口里有没有 Server startup in xxx ms。如果有,说明 Tomcat 已启动,问题大概率是端口冲突或防火墙拦截。用 netstat -ano | findstr 8080(Windows)或 ss -lntp | grep 8080(Linux)确认端口占用情况,改端口即可绕过。

③ 部署 WAR 后 404 或页面空白

优先查看 logs/catalina.out 或 localhost.xxxx-xx-xx.log。常见原因:JDK 版本不匹配(如用高版本 JDK 编译的项目部署到低版本 Tomcat)、web.xml 配置错误、缺少依赖 JAR。特别注意 Tomcat 10+ 的 jakarta.* 命名空间问题。

八、附:Docker 快速体验(可选)

如果只是想临时跑一个 Tomcat 验证 WAR 包,用 Docker 一条命令即可:

bash
docker run -d --name tomcat -p 8080:8080 tomcat:10.1-jdk17

启动后访问 http://localhost:8080。部署应用时,将 WAR 包通过 docker cp 复制进容器的 webapps 目录,或直接构建自定义镜像。

上手检查清单

  1. java -version 和 javac -version 均正常输出。
  2. Tomcat 解压路径无中文、无空格。
  3. 启动后日志出现 Server startup in xxx ms。
  4. 浏览器访问 http://localhost:8080 能看到默认欢迎页。
  5. 把任意 .war 放入 webapps/,访问 http://localhost:8080/应用名/ 能正常打开。

走完这五步,Tomcat 就已经就绪,可以开始部署和调试 Java Web 项目了。

客服
反馈