使用 Homebrew(推荐,最简单)
Homebrew 是 macOS 上的包管理器,可以让你轻松地安装和管理各种开发工具,包括 Tomcat,这是最推荐的方法,因为它简单、快捷,并且方便后续的更新和卸载。

第 1 步:安装 Homebrew
如果你的 Mac 上还没有安装 Homebrew,请先打开终端(Terminal,你可以在 应用程序 -> 实用工具 里找到它,或者使用 Spotlight 搜索 Terminal),然后运行以下命令:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
根据提示输入你的 Mac 密码,然后等待安装完成。
第 2 步:使用 Homebrew 安装 Tomcat
Homebrew 提供的 Tomcat 包已经处理好了大部分配置,在终端中运行:
brew install tomcat
等待安装完成。

第 3 步:验证安装
安装完成后,Homebrew 会告诉你如何启动 Tomcat 服务,你可以使用以下命令来启动、停止和查看状态:
-
启动 Tomcat
brew services start tomcat
这会启动 Tomcat 并设置它在开机时自动运行。
-
检查 Tomcat 状态
(图片来源网络,侵删)brew services list
你应该能在列表中看到
tomcat的状态是started。 -
打开浏览器验证 打开你的浏览器,访问以下地址:
http://localhost:8080如果一切正常,你应该能看到 Tomcat 的欢迎页面,上面有一只猫和很多链接。
第 4 步:管理 Tomcat
-
停止 Tomcat
brew services stop tomcat
-
重启 Tomcat
brew services restart tomcat
手动安装(下载并配置)
如果你需要特定版本的 Tomcat,或者想更深入地了解其内部结构,可以选择手动安装。
第 1 步:下载 Tomcat
- 访问 Tomcat 官方下载页面:https://tomcat.apache.org/download-90.cgi
- 找到 "Core" 部分,下载 Binary Distributions 下的
zip或tar.gz包,对于 macOS,tar.gz是更常见的选择。 - 下载完成后,你会得到一个类似
apache-tomcat-9.0.82.tar.gz的文件。
第 2 步:解压并放置文件
- 打开“访达”(Finder),在你的用户主目录下(
/Users/你的用户名/)创建一个名为Tools或Development的文件夹,用于存放开发工具。 - 将下载的
apache-tomcat-9.0.82.tar.gz文件复制到这个新文件夹中。 - 进入该文件夹,双击压缩包进行解压,你会得到一个名为
apache-tomcat-9.0.82的文件夹。 - 为了方便后续操作,可以将这个文件夹重命名为一个更简短的名字,
tomcat9。
你的文件路径可能看起来像这样:/Users/你的用户名/Tools/tomcat9
第 3 步:配置环境变量(可选但推荐)
配置 CATALINA_HOME 环境变量可以让你在命令行的任何位置方便地启动和停止 Tomcat。
-
打开“终端”(Terminal)。
-
输入以下命令来打开你的 shell 配置文件(如果你使用的是 Zsh,这是 macOS Catalina 及以后系统的默认 Shell;如果使用 Bash,则用
~/.bash_profile):open -e ~/.zshrc
-
在文件末尾添加以下内容。请务必将
/你的用户名/Tools/tomcat9替换成你自己的实际路径:# Set CATALINA_HOME for Tomcat export CATALINA_HOME="/你的用户名/Tools/tomcat9" export PATH="$CATALINA_HOME/bin:$PATH"
CATALINA_HOME:告诉系统 Tomcat 的安装目录在哪里。PATH="$CATALINA_HOME/bin:$PATH":将 Tomcat 的bin目录添加到系统的环境变量中,这样你就可以直接使用startup.sh和shutdown.sh等命令。
-
保存并关闭文件,在终端中运行以下命令让配置立即生效:
source ~/.zshrc
你可以输入
echo $CATALINA_HOME来验证是否配置成功。
第 4 步:启动 Tomcat
- 打开终端。
- 进入 Tomcat 的
bin目录:cd $CATALINA_HOME/bin
- 给
startup.sh和shutdown.sh赋予执行权限(如果之前没给过):chmod u+x *.sh
- 启动 Tomcat:
./startup.sh
你应该会看到一串启动日志,最后显示 "Server startup in ... ms"。
第 5 步:验证安装
和方法一一样,打开浏览器访问 http://localhost:8080,看到 Tomcat 欢迎页面即表示安装成功。
第 6 步:停止 Tomcat
在终端中,进入 Tomcat 的 bin 目录,然后运行:
./shutdown.sh
后续重要配置
修改管理用户密码
默认情况下,Tomcat 没有设置管理员用户,你需要修改 tomcat-users.xml 文件来添加一个可以访问管理后台的用户。
-
用文本编辑器打开 Tomcat 安装目录下的
conf/tomcat-users.xml文件。open $CATALINA_HOME/conf/tomcat-users.xml
-
在
<tomcat-users>和</tomcat-users>标签之间添加以下内容。强烈建议使用更强的密码:<tomcat-users xmlns="http://tomcat.apache.org/xml" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://tomcat.apache.org/xml tomcat-users.xsd" version="1.0"> <!-- 添加一个拥有所有权限的管理员角色和用户 --> <role rolename="manager-gui"/> <role rolename="admin-gui"/> <user username="admin" password="your_strong_password" roles="manager-gui,admin-gui"/> </tomcat-users> -
保存文件。
访问管理后台
重启 Tomcat 后,你就可以通过以下地址访问管理界面了:
- 应用管理器:
http://localhost:8080/manager/html- 用户名/密码:
admin/your_strong_password
- 用户名/密码:
- 服务器状态:
http://localhost:8080/manager/status - 虚拟主机管理:
http://localhost:8080/host-manager/html
如何卸载 Tomcat
如果是通过 Homebrew 安装的:
非常简单,一行命令搞定:
brew uninstall tomcat
如果是手动安装的:
只需要删除整个 Tomcat 文件夹即可:
# 确保已经停止 Tomcat # 然后删除整个目录 rm -rf $CATALINA_HOME
如果你之前配置了环境变量,记得手动编辑 ~/.zshrc 或 ~/.bash_profile 文件,删除添加的那两行。
| 特性 | Homebrew 安装 | 手动安装 |
|---|---|---|
| 优点 | 简单快捷,自动管理依赖,方便更新和卸载 | 完全控制版本和安装路径,适合高级用户 |
| 缺点 | 版本可能不是最新的(但通常很新) | 步骤繁琐,需要手动配置环境变量 |
| 推荐人群 | 绝大多数用户,特别是初学者 | 需要特定版本或深度定制配置的开发者 |
对于大多数 macOS 使用 Homebrew 是最省心、最高效的选择,希望这份教程对你有帮助!
