macOS 安裝 Tomcat 完整教學：從 JDK 確認到啟動驗證

macOS 安裝 Tomcat 完整教學：從 JDK 確認到啟動驗證

1. 確認 JDK 版本

java -version

輸出範例：java version "1.7.0_80"。Tomcat 版本需與 JDK 版本相容，請至官網查閱版本對應表。

2. 下載 Tomcat

• 官網：https://tomcat.apache.org/
• 選擇對應 JDK 版本的 Tomcat（如 JDK 1.7 对应 Tomcat 7/8）
• 下載 macOS 版本：.tar.gz 或 .zip 均可

3. 解壓與部署

# 解壓
tar -xzf apache-tomcat-x.x.xx.tar.gz
# 重命名（便於操作）
mv apache-tomcat-x.x.xx tomcat
# 移動到系統目錄（需管理員權限）
sudo mv tomcat /Library/

4. 配置管理用戶

編輯 /Library/tomcat/conf/tomcat-users.xml，在 <tomcat-users> 內新增：

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

密碼請自行修改為強密碼。

5. 啟動 Tomcat

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

重要：啟動後不要關閉終端機視窗，否則進程會隨終端退出而終止。生產環境建議配置為系統服務（LaunchDaemon）或使用 nohup 後台運行。

6. 驗證安裝

瀏覽器訪問 https://localhost:8080/，出現 Tomcat 預設首頁（貓圖標）即表示安裝成功。

若啟動失敗，查看 /Library/tomcat/logs/catalina.out 或 localhost.xxx.log 排查錯誤。

7. 常用操作

8. 進階配置建議

• JVM 參數調優：編輯 bin/setenv.sh（不存在則新建），設定 CATALINA_OPTS="-Xms512m -Xmx1024m -XX:MetaspaceSize=128m -XX:MaxMetaspaceSize=256m"
• 編碼設定：在 server.xml Connector 加入 URIEncoding="UTF-8"
• 自動部署：將 WAR 包放入 webapps/ 目錄，Tomcat 會自動熱部署

至此，macOS 上的 Tomcat 安裝配置完成，可開始部署 Java Web 應用。