Tomcat 7.0/8.0/9.0/10.1 Windows 安裝與環境變數配置完整指南

前置需求：JDK 安裝 (關鍵)

Tomcat 為 Java Servlet 容器，**必須先安裝 JDK** (非 JRE)，且版本對應：

JDK 安裝與環境變數 (Windows)

1. 下載 JDK (Oracle JDK / OpenJDK / Eclipse Temurin / Amazon Corretto)。
   推薦：Eclipse Temurin (免費、長期支援、無授權疑慮)。
2. 執行安裝程式，記住安裝路徑 (如 `C:\Program Files\Eclipse Adoptium\jdk-17.0.8.7-hotspot`)。
3. 設定系統環境變數 (Win+S 搜尋「編輯系統環境變數」→ 環境變數)：
   • 新增系統變數： `JAVA_HOME` = `` (無 bin 目錄)
   • 編輯系統變數 Path： 新增 `%JAVA_HOME%\bin`
   • (可選) `CLASSPATH` = `.;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar` (現代 JDK 通常不需)
4. 驗證：新開 CMD → `java -version`、`javac -version`、`echo %JAVA_HOME%` 皆正確顯示。

Tomcat 安裝與配置

方式一：免安裝版 (zip/tar.gz) — 推薦生產環境

1. 下載 Core (zip) 版本：Tomcat 9 / Tomcat 10。
2. 解壓至無中文、無空格路徑，如 `D:\Tomcat9` 或 `C:\Tomcat9`。
3. 設定環境變數 (系統變數)：
   • `CATALINA_HOME` = `D:\Tomcat9`
   • `CATALINA_BASE` = `D:\Tomcat9` (單實例通常同 CATALINA_HOME)
   • Path 追加 `%CATALINA_HOME%\bin`
4. 配置管理員帳號 (啟用 Manager GUI)： 編輯 `D:\Tomcat9\conf\tomcat-users.xml`，在 `` 內加入：

   <role rolename="manager-gui"/>
   <role rolename="admin-gui"/>
   <user username="admin" password="StrongP@ssw0rd!" roles="manager-gui,admin-gui"/>

5. 啟動測試：
   • CMD 執行 `startup.bat` (前景) 或 `catalina.bat start` (背景)。
   • 瀏覽 `https://localhost:8080` 出現 Tomcat 貓頁面 → 成功。
   • 點擊 Manager App，輸入上方帳密進入管理介面。

方式二：Windows Service Installer (exe) — 適合開發/自動啟動

1. 下載 `apache-tomcat-9.0.x.exe` (32/64-bit Windows Service Installer)。
2. 執行安裝，選擇 **Full Installation**，服務名稱預設 `Tomcat9`。
3. JRE 選擇：指向已安裝的 JDK 內 `jre` 目錄 (如 `C:\Program Files\Eclipse Adoptium\jdk-17\jre`)。
4. 安裝完成後，服務自動建立。`services.msc` 中設為 **自動** 啟動。
5. 管理介面：開始功能表 → Apache Tomcat 9 → Configure Tomcat (圖形化調整 JVM 參數、連接埠、日誌等)。

核心配置檔說明

生產環境關鍵 JVM 參數 (setenv.bat)

@echo off
set CATALINA_OPTS=-server ^
  -Xms2g -Xmx2g ^
  -XX:MetaspaceSize=256m -XX:MaxMetaspaceSize=512m ^
  -XX:+UseG1GC -XX:MaxGCPauseMillis=200 ^
  -Dfile.encoding=UTF-8 -Dsun.jnu.encoding=UTF-8 ^
  -Duser.timezone=Asia/Taipei ^
  -XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=%CATALINA_BASE%\logs\heapdump.hprof

Linux/Mac 用 `setenv.sh` (加執行權限)。

常見問題排查

總結

Tomcat 部署核心三步：**正確 JDK → 解壓/安裝 Tomcat → 設定 JAVA_HOME/CATALINA_HOME + 管理員帳號**。生產環境務必調整 JVM 參數、啟用 G1GC、配置連線池與監控。Windows 建議使用 **免安裝版 + 手動建立服務 (procrun)** 或 **exe 安裝版**，Linux/容器化部署請參考官方 Docker Image。