2026最新Tomcat安装和配置保姆级教程(附安装包+图文步骤)

简介: Apache Tomcat是开源轻量级Java Web服务器与Servlet容器,支持Servlet、JSP、WebSocket等规范。解压即用,部署.war包即可运行Web应用,广泛用于开发与测试。推荐使用Tomcat 10.1.x或11.x(需JDK 11+),注意jakarta.*命名空间迁移。

Apache Tomcat(简称Tomcat)是由Apache软件基金会开发的一款开源Java Servlet容器和Web服务器。它的核心功能是运行Java Web应用程序.


具体来说,Tomcat实现了Java Servlet、JavaServer Pages(JSP)、Jakarta Expression Language和WebSocket等Java企业级技术规范。你写好的Java Web项目,打包成.war文件部署到Tomcat上,别人就能通过浏览器访问了。Tomcat也是目前最流行的Java Web应用服务器之一。


同领域的Java Web服务器还有多个,来看看各自的定位:


服务器 定位 特点
Tomcat Servlet容器/Web服务器 轻量、开源、最流行、支持JSP/Servlet
Jetty Servlet容器 更轻量、嵌入式使用多、启动快
Undertow Web服务器 高性能、非阻塞I/O、Spring Boot默认之一
WildFly(JBoss) Java EE应用服务器 全功能企业级、支持EJB等完整Java EE


Tomcat目前最新的主流版本有两个系列:

  • 一个是Jakarta EE 10路线的Tomcat 11.x(最新版11.0.x),使用新的jakarta.*命名空间;
  • 另一个是在Java EE 8规范下的Tomcat 10.1.x,使用jakarta.*命名空间。


对于新项目,推荐直接使用Tomcat 10.1.x或Tomcat 11.x。但要注意的是,Tomcat 10.x及以后版本使用jakarta.servlet代替了javax.servlet,如果你有些老项目还在用javax.*的包,需要先迁移才能部署。如果项目要求兼容javax.*,可以选择Tomcat 9.x。


在安装Tomcat之前,需要确保电脑上已经安装了JDK(Java Development Kit),因为Tomcat是纯Java开发的,必须依赖JDK或JRE才能运行。建议使用JDK 17或JDK 21这些长期支持(LTS)版本。

Tomcat下载

Tomcat官网安装包下载地址:Apache Tomcat安装包(官网最新版,长期维护,放心使用)


官网提供了几种类型的安装包:

  • zip压缩包(Windows通用):Windows用户下载此格式,解压后配置环境变量即可使用
  • Windows Service Installer(.exe):Windows专属,安装后以Windows服务形式运行,适合生产环境


普通开发者下载.zip版本就够了,解压即用,方便灵活。

Tomcat安装和配置

在开始安装Tomcat之前,务必确认JDK已经安装完毕。可以在命令行输入 java -version 和 javac -version 验证。如果没有安装JDK或版本过旧,先下载安装JDK 17或JDK 21。还需要设置JAVA_HOME环境变量,指向JDK的安装目录(比如C:\Program Files\Java\jdk-17)。


Tomcat不需要常规的"安装"步骤,它是绿色解压即可使用的。将下载的.zip文件解压到你想安装的目录,建议解压到D盘或其他非系统盘,比如 D:\Tomcat。解压后的目录结构如下:

  • bin/ — 存放启动和关闭脚本(startup.bat、shutdown.bat等);
  • conf/ — 配置文件目录(server.xml、web.xml、context.xml等);
  • lib/ — Tomcat依赖的jar包;
  • logs/ — 运行日志;
  • webapps/ — Web应用部署目录,把.war包放这里就行;
  • work/ — JSP编译后的临时文件;


解压完成后,还需要配置两个关键的环境变量(Windows系统):

  • CATALINA_HOME:变量值是Tomcat的解压目录,比如D:\Tomcat\apache-tomcat-10.1.xx
  • PATH变量追加:在PATH变量的末尾添加 ;%CATALINA_HOME%\bin,这样就能在命令行里直接使用startup和shutdown命令


设置环境变量的方法是:

1)右键点击"此电脑"或"计算机",选择"属性":



2)然后点击"高级系统设置":



3)在系统属性窗口中,点击"环境变量"按钮:



4)在"系统变量"区域点击"新建",变量名填CATALINA_HOME,变量值填你的Tomcat目录:



然后在系统变量中找到Path,双击打开,点击"新建",填入 %CATALINA_HOME%\bin。配置完成后点击"确定"保存。


Tomcat基础使用

1)启动和关闭Tomcat

启动Tomcat有两种方式:

  • 一种是直接进入Tomcat的bin目录,双击startup.bat(Windows)或运行./startup.sh(Linux/macOS),会弹出一个命令行窗口显示Tomcat的启动日志;
  • 另一种是在配置好CATALINA_HOME和PATH后,直接在命令提示符里输入 startup 启动。


Tomcat默认使用8080端口。启动成功后,打开浏览器访问 http://localhost:8080,如果看到Tomcat的默认欢迎页面,就说明安装成功了。



关闭Tomcat,双击shutdown.bat或者在命令行输入 shutdown。注意不要在启动Tomcat的命令行窗口直接点"叉"关闭,那样可能会导致Tomcat进程没有完全退出。

2)部署Web应用

部署Java Web项目到Tomcat很简单:把你的Web项目打成.war包(比如myapp.war),直接复制到Tomcat的webapps目录下。Tomcat会自动检测到.war文件并自动解压部署。


稍等几秒钟,访问 http://localhost:8080/myapp/ 就能看到你的Web应用了。你也会在webapps目录下看到一个同名的myapp文件夹,那是Tomcat自动解压出来的。

3)管理控制台

Tomcat自带一个Web管理控制台,可以通过浏览器管理应用部署。访问 http://localhost:8080/manager/html,会弹出登录窗口。


默认情况下,管理控制台是需要用户名和密码才能访问的。需要先配置conf/tomcat-users.xml文件,在 <tomcat-users> 标签之间添加以下内容:

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

保存后重启Tomcat,就能用admin/admin登录管理控制台了。在管理控制台里,你可以在线部署、停止、启动和卸载Web应用。

4)修改端口

如果你的8080端口已经被其他程序占用,可以在conf/server.xml里修改Tomcat的端口。用文本编辑器打开conf/server.xml,找到下面这行:

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

把port的值改成你想要的端口(比如8088或9090),保存文件后重启Tomcat,新端口就会生效。如果你改成了8088,那就需要通过 http://localhost:8088 来访问Tomcat了。

常见问题

双击startup.bat后命令行窗口一闪而过,然后什么都没有发生。这种情况通常是环境变量配置有问题,最常见的是JAVA_HOME没有正确设置。检查一下JAVA_HOME是否指向了JDK的安装目录(注意不是JRE目录),并且路径中不要包含bin子目录。如果JAVA_HOME正确,再检查CATALINA_HOME是否指向了Tomcat的解压目录。可以在命令行里输入 echo %JAVA_HOME% 和 echo %CATALINA_HOME% 来验证环境变量是否生效。


启动Tomcat后,访问localhost:8080显示"无法访问此网站"。先确认一下启动窗口里是否出现了"Server startup in xxx ms"的提示,如果有的话说明Tomcat已经启动成功了。可能是端口冲突,8080端口被其他程序占用了。修改conf/server.xml里的端口为8088或其他端口再试。也可能是防火墙阻挡了,可以暂时关闭防火墙试试排查问题。


部署.war包后访问报错404,或者页面显示空白。先去Tomcat的logs目录下查看catalina.out或localhost.xxx.log日志文件,里面会记录详细的错误信息。常见的原因包括:项目的JDK版本与Tomcat不兼容(比如用高版本JDK编译的项目部署到低版本Tomcat上)、web.xml配置错误、缺少依赖包等。确认一下你的项目编译用的JDK版本和Tomcat支持的最低版本是否匹配。Tomcat 10.1.x需要JDK 11以上。

总结

Apache Tomcat是Java Web开发中最常用的Servlet容器和Web服务器,开源免费、轻量易用。


本文从Tomcat下载到安装配置、环境变量设置以及应用部署都做了详细讲解。Tomcat的安装其实就是解压和配置环境变量的过程,启动后在浏览器访问localhost:8080就能确认安装成功。把写好的.war包丢到webapps目录里,项目就自动上线了。Tomcat下载安装完成后,如果项目对javax.servlet有依赖记得确认版本兼容性。

相关文章
|
26天前
|
Java Linux Apache
【2026最新】Maven下载安装配置保姆级图文教程(附安装包+图文步骤)
Apache Maven是免费开源的Java项目管理与构建工具,基于POM模型,统一管理依赖、编译、测试、打包与部署。支持Windows/macOS/Linux,最新版3.9.15。规范性强、上手快,广泛用于企业级Java项目。(239字)
|
应用服务中间件 网络安全 nginx
nginx启动成功,但外部不能访问的问题
nginx启动成功,但外部不能访问的问题
5709 0
nginx启动成功,但外部不能访问的问题
|
21天前
|
机器学习/深度学习 IDE 数据挖掘
2026最新Jupyter Notebook安装使用保姆级教程(附安装包+图文步骤)
Jupyter Notebook是基于网页的交互式编程工具,支持Python、R等数十种语言。以单元格为单位执行代码,即时显示结果,融合代码、文字与图表,适合数据分析、教学及报告编写。推荐通过Anaconda一键安装。
|
26天前
|
IDE Java 开发工具
【2026最新】Eclipse下载安装使用保姆级教程(附安装包+图文步骤)
Eclipse是免费开源的跨平台IDE,原生支持Java开发,通过插件可扩展至C/C++、Python、Web前端等。其轻量插件架构、丰富生态及二十多年企业级应用积累,使其成为Java开发的重要工具之一。(239字)
|
23天前
|
开发框架 安全 Java
Java 长期支持版 JDK17 下载安装+详细配置步骤
JDK 17 是 Oracle 官方推出的长期支持(LTS)版本,具备高性能、高安全性、强兼容性与丰富新特性(如密封类、模式匹配等),广泛用于后端开发、微服务、大数据及教学实训,是企业级 Java 开发的主流稳定选择。(239字)
1032 0
|
21天前
|
IDE 数据可视化 开发工具
2026最新Thonny(Python IDE)使用全攻略教程(附安装包+图文步骤)
Thonny是爱沙尼亚塔尔图大学开发的Python初学者专用IDE,界面极简、内置Python解释器,无需配置即可开写;其可视化调试功能可直观查看变量变化,大幅降低学习门槛。支持Win/macOS/Linux,最新版为5.x。
|
17天前
|
关系型数据库 MySQL 数据库
MySQL下载安装教程 | Windows安装MySQL 8.0详解(2026最新)
MySQL是Oracle维护的开源关系型数据库,支持SQL操作,广泛用于Web应用、企业系统及数据分析。提供免费社区版和商业版,安装简便,兼容LAMP/LEMP架构,适合学习与生产环境。(239字)
1236 11
|
4月前
|
Java 应用服务中间件 Shell
Apache Tomcat 历史版本下载地址 官网地址
本指南详解Tomcat (以7.0.67为例)的完整部署流程:从官网下载历史版本、解压安装,到启动/停止服务(startup.sh/shutdown.sh),再到配置开机自启(systemctl)。涵盖目录结构说明及端口验证方法,适合Linux服务器快速部署。
836 135
|
23天前
|
人工智能 Java API
多端CRM客户关系管理系统源码下载(PHP/Java/Python)完整开源版
本文深度解析PHP、Java、Python三大技术栈的开源CRM方案,涵盖多端协同架构、RBAC权限控制、客户公海回收、RESTful API设计及AI智能化演进,助成长型企业以低成本实现私有化、可定制、高扩展的CRM自主建设。
|
21天前
|
人工智能 安全 测试技术
阿里云JVS Claw是什么?JVS Claw能力、部署方式与部署流程参考
阿里云推出的AI智能体平台JVS Claw,基于OpenClaw框架打造,定位为"执行型智能体",解决了传统AI助手"只会说不会做"的痛点。JVS Claw支持云端与本地双部署模式,云端环境安全隔离、7×24小时在线,本地模式数据可控。产品提供体验版(7天免费)、匠心版(39元/月起)、大师版三档方案,适用于办公提效、代码开发、团队协作等场景。用户可通过自然语言指令驱动Clawbot执行邮件处理、代码生成、自动化测试等复杂任务,并支持自定义Skill扩展能力。39元/月起的定价大幅降低了AI Agent的使用门槛。