保姆级tomcat安装与配置(Windows + MacOS)

本文介绍: To m cat 是 Apac he 软件基金会（Apac h e So ft war e Foun dat ion）的 Ja k ar ta 项目中的一个核心项目，由 Apac h e、Sun 和其他一些公司及个人共同开发而成。由于有了 Sun 的参与和支持，最新的 Se r v let 和 JSP 规范总是能在 To m cat 中得到体现。因为 Tom cat 技术先进、性能稳定，而且免费，因而深受 Jav a 爱好者的喜爱并得到了部分软件开发商的认可，成为目前比较流行的 We b 应用服务器。

本文结合尚硅谷视频教程进行整理补充而来，简单地讲述了 tomcat 的简单下载、安装、配置与常见信息页面的补充，希望读者能对 tomcat 有简单的初步了解。

Tom cat 是 Ap a ch e 软件基金会（Ap a che Soft w are Foun dat ion）的 Jak ar ta 项目中的一个核心项目，由 Apache、Sun 和其他一些公司及个人共同开发而成。由于有了 Sun 的参与和支持，最新的 Ser v let 和 JSP 规范总是能在 Tomcat 中得到体现。因为 Tomcat 技术先进、性能稳定，而且免费，因而深受 Java 爱好者的喜爱并得到了部分软件开发商的认可，成为目前比较流行的 Web 应用服务器。

2.Tomcat 下载

官方网站：http://tomcat.apache.org/

进入官方网站下载 tomcat：

安装版：需要安装（不推荐）
解压版: 直接解压缩使用（推荐）

tomcat 服务器软件需要使用 Java 环境，所以需要正确配置 JAVA_HOME，后面会提到。

3.Tomcat的版本

Tomcat 企业用的比较广泛的是 7.0 和 8.0 的，开发学习我们使用 8.0、9.0 皆可。由于tomcat6 以下都不用了，所以仅从 tomcat6 开始比较：

tomcat6：支持 servlet2.5、jsp2.1、el
tomca t7：支持 servlet3.0、jsp2.2、el2.2、websocket1.1
tomca t8：支持 servlet3.1、jsp2.3、el3.0、web socket1.1
tomca t9：支持 servlet4.0、jsp2.3、el3.0、web socket1.1

4.安装

解压下载好的 apache–tomca t-9.0.68（tomcat 安装目录、根目录）到非中文无空格目录中：

解压后有如下目录：

bin：该目录下存放的是二进制可执行文件
- 如果是安装版：目录下会有两个 exe 文件：tomcat9.exe、tomcat9w.exe，前者是在控制台下启动Tomcat，后者是弹出 GUI 窗口启动 Tomcat；
- 如果是解压版：会有 startup.bat 和 shutdown.bat 文件，start up.bat 用来启动 Tomcat，但需要先配置 JAVA_HOME 环境变量才能启动，s hut dawn.bat 用来停止 Tomcat；
conf：该目录下有四个最为重要的文件
- server.xml：配置整个服务器信息，如修改端口号（默认 HTTP 请求的端口号是：8080）
- tomcat-users.xml：存储 tomcat 用户的文件，这里保存的是 tomcat 的用户名及密码，以及用户的角色信息。可以按着该文件中的注释信息添加 tomcat 用户，然后就可以在 Tomcat 主页中进入 Tomcat Mana ger 页面了；
- web.xml：部署描述符文件，这个文件中注册了很多 MIME 类型，即文档类型。这些 MIME 类型是用于在客户端与服务器之间说明文档类型的，如用户请求一个 html 网页，那么服务器还会告诉客户端浏览器响应的文档是 text/html 类型的，这就是一个 MIME 类型，客户端浏览器通过这个 MIME 类型就知道如何处理它了，如在浏览器中显示这个 html 文件了。但如果服务器响应的是一个 exe 文件，那么浏览器就不可能显示它，而是应该弹出下载窗口才对。简单来说，MIME 就是用来说明文档的内容是什么类型的。
- context.xml：对所有应用的统一配置，通常我们不会去配置它。
lib：tomcat 的类库，里面是一堆 jar 文件。如果需要添加 Tomcat 依赖的 jar 文件，可以把它放到这个目录中，当然也可以把应用依赖的 jar 文件放到这个目录中，这个目录中的 jar 所有项目都可以共享，但这样你的应用放到其他 Tomcat 下时就不能再共享这个目录下的 ja r 包了，所以建议只把 Tomcat 需要的 ja r 包放到这个目录下。
logs：这个目录中都是日志文件，记录了 Tomcat 启动和关闭的信息，如果启动 Tomcat 时有错误，那么异常也会记录在日志文件中。
temp：存放 Tomcat 的临时文件，这个目录下的内容可以在停止 Tomcat 后删除。
webapps：存放 web 项目的目录，其中每个文件夹都是一个项目。如果这个目录下已经存在了目录，那么都是 tomcat 自带的项目。其中 ROOT 是一个特殊的项目，在地址栏中访问：http://127.0.0.1:8080，没有给出项目目录时，对应的就是 ROOT 项目。http://localhost:8080/examples，进入示例项目。其中 example s 就是项目名，即文件夹的名字。
work：通过 webapps 中的项目运行时生成的文件，最终运行的文件都在这里。可以把这个目录下的内容删除，再次运行时会生再次生成 work 目录。当客户端用户访问一个 JSP 文件时，Tomcat 会通过 JSP 生成 Java 文件，然后再编译 Java 文件生成 class 文件，生成的 java 和 class 文件都会存放到这个目录下。
LICENSE：许可证。
NOTICE：说明文件。

5.配置

5.1 Win do ws

配置 JAVA_HOME 环境变量：

在 Path 环境变量中加入 JAVA_HOMEbin 目录：

5.2 MacOS

输入命令编辑配置环境文件：（当然如果是 M1 用户也可以添加配置到.zshrc文件，这里就以 .bash_profile 为例）

vim ～/.bash_profile

出现以下窗口，键入 E 进行编辑操作：

进入 .bash_profile 文件后，点击 i 进行编辑模式，然后加入如下内容：

# 配置 tomcat
export CATALINA_HOME=/Users/liyao/apache-tomcat-10.0.27
export PATH=$PATH:$CATALINA_HOME/bin

CATALINA_HOME：写你自己的 tomcat 安装路径
PATH：将 tomcat 安装路径下的 bin 目录配置到系统环境变量（里面有 tomcat 启动与停止的命令）

确保无误后，按 esc键，然后输入 :wq + 回车，保存并退出即可。

接下来输入如下命令使刚才的配置生效：

source ~/.bash_profile

如果是 M1 用户，使用 source ~/.bash_profile 后只能是当时有效，当我们重启终端时便失效，此时又需要重新执行该命令，因为 M1 默认加载的是 .zshrc 文件。解决方案是在 .zshrc 文件中加入 source ~/.bash_profile 这样每次启动终端都会自动执行该命令以使得配置生效（当然，也可以直接将 tomcat 配置在 .zshrc 文件中一举两得）。

输入如下命令编辑 .zshrc 配置文件：
vim ～/.zshrc
将下面的命令添加到文件末尾：
source ~/.bash_profile
最后输入命令使配置立即生效：
source ~/.zshrc

接下来我们需要获取执行文件的权限，以便能够通过执行 *.sh 的方式启动和停止 tomcat。再次打开终端输入以下命令（cd + tomcat路径/bin，这一定要你自己文件路径名）：

cd '/Users/quokka/tomcat/apache-tomcat-9.0.68/bin'

输入以下命令获取执行 .sh 文件的权限：

chmod +x *.sh

6.启动

Win do ws：在命令行中运行 catalina run 或者 Tomcat 解压目录下双击 startup.bat 启动 Tomcat 服务器，双击 shutdown.bat 停止服务器。
Mac、Linux：在命令行中运行 startup.sh 启动 tomcat 服务器，运行 shutdown.sh 停止服务器。

如果启动服务器软件时出现了中文乱码，就在 tomcat安装路径conflogging.properties 文件中将字符编码全部改为 GBK 即可。

如果启动失败，查看如下的情况：

情况一：如果双击 start up.bat 后窗口一闪而过，请查看 JAVA_HOME 是否配置正确。

start up.bat 会调用 catalina.bat，而 catalina.bat 会调用 set classpath.bat，set classpath.bat 会使用 JAVA_HOME 环境变量，所以我们必须在启动 Tomcat 之前把 JAVA_HOME 配置正确。

情况二：如果启动失败，提示端口号被占用，则将默认的 8080 端口修改为其他未使用的值。在 tomcat安装路径confserver.xml 中找到第一个 Connector 标签，修改 port 属性即可。

web 服务器在启动时，实际上是监听了本机上的一个端口，当有客户端向该端口发送请求时，web 服务器就会处理请求。但是如果不是向其所监听的端口发送请求，web 服务器不会做任何响应。