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),并在命令行验证:
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。
配置完成后,可以打开新的命令提示符验证:
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
java -version
若未安装,以 Ubuntu/Debian 为例:
sudo apt install openjdk-17-jdk
RHEL/CentOS 系可用 sudo yum install java-17-openjdk-devel。
2. 解压到目标目录
tar -zxvf apache-tomcat-10.1.xx.tar.gz -C /opt
解压后得到 /opt/apache-tomcat-10.1.xx。为方便多版本管理,可以创建一个符号链接:
ln -s /opt/apache-tomcat-10.1.xx /opt/tomcat
后续统一用 /opt/tomcat 指代。
3. 配置环境变量
编辑 ~/.bashrc 或 /etc/profile,加入:
export CATALINA_HOME=/opt/tomcat
export PATH=$PATH:$CATALINA_HOME/bin
执行 source ~/.bashrc(或 source /etc/profile)使配置生效。
4. 启动、停止与排错
# 启动
$CATALINA_HOME/bin/startup.sh
# 停止
$CATALINA_HOME/bin/shutdown.sh
# 前台运行(排错时非常有用,日志直接输出到终端)
$CATALINA_HOME/bin/catalina.sh run
如果启动失败,第一优先级是查看日志:
tail -f $CATALINA_HOME/logs/catalina.out
常见的失败原因包括:JAVA_HOME 未设置、bin/*.sh 没有执行权限(chmod +x *.sh)、端口被占用等。
5. 开放防火墙(如需远程访问)
# 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> 标签内添加:
<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 所在行:
<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 一条命令即可:
docker run -d --name tomcat -p 8080:8080 tomcat:10.1-jdk17
启动后访问 http://localhost:8080。部署应用时,将 WAR 包通过 docker cp 复制进容器的 webapps 目录,或直接构建自定义镜像。
上手检查清单
java -version和javac -version均正常输出。- Tomcat 解压路径无中文、无空格。
- 启动后日志出现
Server startup in xxx ms。 - 浏览器访问
http://localhost:8080能看到默认欢迎页。 - 把任意
.war放入webapps/,访问http://localhost:8080/应用名/能正常打开。
走完这五步,Tomcat 就已经就绪,可以开始部署和调试 Java Web 项目了。

