macOS 安裝 Tomcat 完整指南：從下載到配置管理

前言

Tomcat 是 Java Web 開發最常用的 Servlet 容器。本文詳細記錄在 macOS 上通過官方二進制包安裝、權限配置、啟動驗證及管理用戶設置的完整流程，適用於開發環境快速搭建。

一、下載與解壓

1. 訪問官網 Tomcat 9/10 下載頁（根據 JDK 版本選擇）
2. 下載 tar.gz 格式（非 Windows 版）
3. 解壓至自定義目錄（示例）：

   mkdir -p /ProgramFile
   tar -zxvf apache-tomcat-9.0.x.tar.gz -C /ProgramFile
   mv /ProgramFile/apache-tomcat-9.0.x /ProgramFile/tomcat

二、執行權限授予

bin/ 目錄下的 .sh 腳本需執行權限：

sudo chmod 755 /ProgramFile/tomcat/bin/*.sh

輸入管理員密碼完成授權。

三、啟動與驗證

1. 進入 bin 目錄啟動

cd /ProgramFile/tomcat/bin
sudo ./startup.sh

2. 成功標誌

Using CATALINA_BASE: /ProgramFile/tomcat
Using CATALINA_HOME: /ProgramFile/tomcat
Using CATALINA_TMPDIR: /ProgramFile/tomcat/temp
Using JRE_HOME: /Library/Java/JavaVirtualMachines/jdk-11.jdk/Contents/Home
Using CLASSPATH: /ProgramFile/tomcat/bin/bootstrap.jar:/ProgramFile/tomcat/bin/tomcat-juli.jar
Tomcat started.

3. 瀏覽器訪問

打開 https://localhost:8080 出現 Tomcat 貓首頁即成功。

四、管理用戶配置（啟用 Manager App）

1. 編輯 /ProgramFile/tomcat/conf/tomcat-users.xml
2. 在 <tomcat-users> 內添加：

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

3. 重啟 Tomcat：sudo ./shutdown.sh && sudo ./startup.sh

現在可訪問 https://localhost:8080/manager/html 進行應用部署管理。

五、常用操作速查表

六、進階配置建議

• JVM 參數優化：編輯 bin/setenv.sh（不存在則新建）：

  export CATALINA_OPTS="-Xms512m -Xmx1024m -XX:MetaspaceSize=128m -XX:MaxMetaspaceSize=256m"

• 開發熱部署：在 conf/context.xml 的 <Context> 添加 reloadable="true"
• 編碼統一：server.xml 中 Connector 添加 URIEncoding="UTF-8"

七、常見問題排查

1. 端口衝突：lsof -i :8080 找到佔用進程 kill 或修改端口
2. 權限不足：確認 chmod -R 755 /ProgramFile/tomcat 並以擁有者身份運行
3. JDK 版本不匹配：Tomcat 10+ 需 JDK 11+，Tomcat 9 支援 JDK 8+

結語

macOS 上安裝 Tomcat 核心在於「解壓即用、權限授予、用戶配置」三步走。建議將 CATALINA_HOME 加入環境變量，並編寫簡單腳本管理多版本切換，提升開發效率。