杰瑞科技汇

mac tomcat安装教程

使用 Homebrew(推荐,最简单)

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

mac tomcat安装教程-图1
(图片来源网络,侵删)

第 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

等待安装完成。

mac tomcat安装教程-图2
(图片来源网络,侵删)

第 3 步:验证安装

安装完成后,Homebrew 会告诉你如何启动 Tomcat 服务,你可以使用以下命令来启动、停止和查看状态:

  1. 启动 Tomcat

    brew services start tomcat

    这会启动 Tomcat 并设置它在开机时自动运行。

  2. 检查 Tomcat 状态

    mac tomcat安装教程-图3
    (图片来源网络,侵删)
    brew services list

    你应该能在列表中看到 tomcat 的状态是 started

  3. 打开浏览器验证 打开你的浏览器,访问以下地址:

    http://localhost:8080

    如果一切正常,你应该能看到 Tomcat 的欢迎页面,上面有一只猫和很多链接。

第 4 步:管理 Tomcat

  • 停止 Tomcat

    brew services stop tomcat
  • 重启 Tomcat

    brew services restart tomcat

手动安装(下载并配置)

如果你需要特定版本的 Tomcat,或者想更深入地了解其内部结构,可以选择手动安装。

第 1 步:下载 Tomcat

  1. 访问 Tomcat 官方下载页面:https://tomcat.apache.org/download-90.cgi
  2. 找到 "Core" 部分,下载 Binary Distributions 下的 ziptar.gz 包,对于 macOS,tar.gz 是更常见的选择。
  3. 下载完成后,你会得到一个类似 apache-tomcat-9.0.82.tar.gz 的文件。

第 2 步:解压并放置文件

  1. 打开“访达”(Finder),在你的用户主目录下(/Users/你的用户名/)创建一个名为 ToolsDevelopment 的文件夹,用于存放开发工具。
  2. 将下载的 apache-tomcat-9.0.82.tar.gz 文件复制到这个新文件夹中。
  3. 进入该文件夹,双击压缩包进行解压,你会得到一个名为 apache-tomcat-9.0.82 的文件夹。
  4. 为了方便后续操作,可以将这个文件夹重命名为一个更简短的名字,tomcat9

你的文件路径可能看起来像这样:/Users/你的用户名/Tools/tomcat9

第 3 步:配置环境变量(可选但推荐)

配置 CATALINA_HOME 环境变量可以让你在命令行的任何位置方便地启动和停止 Tomcat。

  1. 打开“终端”(Terminal)。

  2. 输入以下命令来打开你的 shell 配置文件(如果你使用的是 Zsh,这是 macOS Catalina 及以后系统的默认 Shell;如果使用 Bash,则用 ~/.bash_profile):

    open -e ~/.zshrc
  3. 在文件末尾添加以下内容。请务必将 /你的用户名/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.shshutdown.sh 等命令。
  4. 保存并关闭文件,在终端中运行以下命令让配置立即生效:

    source ~/.zshrc

    你可以输入 echo $CATALINA_HOME 来验证是否配置成功。

第 4 步:启动 Tomcat

  1. 打开终端。
  2. 进入 Tomcat 的 bin 目录:
    cd $CATALINA_HOME/bin
  3. startup.shshutdown.sh 赋予执行权限(如果之前没给过):
    chmod u+x *.sh
  4. 启动 Tomcat:
    ./startup.sh

    你应该会看到一串启动日志,最后显示 "Server startup in ... ms"。

第 5 步:验证安装

和方法一一样,打开浏览器访问 http://localhost:8080,看到 Tomcat 欢迎页面即表示安装成功。

第 6 步:停止 Tomcat

在终端中,进入 Tomcat 的 bin 目录,然后运行:

./shutdown.sh

后续重要配置

修改管理用户密码

默认情况下,Tomcat 没有设置管理员用户,你需要修改 tomcat-users.xml 文件来添加一个可以访问管理后台的用户。

  1. 用文本编辑器打开 Tomcat 安装目录下的 conf/tomcat-users.xml 文件。

    open $CATALINA_HOME/conf/tomcat-users.xml
  2. <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>
  3. 保存文件。

访问管理后台

重启 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 是最省心、最高效的选择,希望这份教程对你有帮助!

分享:
扫描分享到社交APP
上一篇
下一篇