Tomcat ZIP 版安裝與配置完整指南（新手入門）

前言

Apache Tomcat 是廣泛使用的 Java Servlet 容器。本文針對 Windows 環境，詳細說明如何使用 ZIP 解壓版完成 JDK 與 Tomcat 的安裝、環境變數設定、服務註冊以及啟動/關閉操作，幫助初學者快速建立可用的開發環境。

一、配置 JDK 環境

1. 下載與解壓 JDK

從 Oracle 官網下載對應作業系統的 JDK 安裝包（建議使用 LTS 版本如 JDK 8、11、17 或 21）。下載後解壓至自訂目錄，例如 C:\jdk1.8.0_301。確認 bin 目錄存在於該路徑下，此路徑即為後續設定的 JAVA_HOME。

2. 設定系統環境變數

1. 右鍵點擊「此電腦」→「屬性」→「進階系統設定」→「環境變數」。
2. 在「系統變數」區域點擊「新建」：
   • 變數名：JAVA_HOME
   • 變數值：JDK 解壓目錄（如 C:\jdk1.8.0_301）
3. 新增 CLASSPATH 變數：
   • 變數名：CLASSPATH
   • 變數值：.;%JAVA_HOME%\lib\tools.jar;%JAVA_HOME%\lib\dt.jar
4. 在「使用者變數」區域編輯或新增 Path：
   • 變數名：Path
   • 變數值：%Path%;%JAVA_HOME%\bin

完成後，開啟命令提示字元輸入 java -version 驗證是否生效。

二、配置 Tomcat

1. 下載與解壓 Tomcat

從 Tomcat 官網下載 ZIP 格式的二進制發布包（如 apache-tomcat-9.0.73.zip），解壓至任意目錄，例如 D:\apache-tomcat-9.0.73。

2. 修改啟動腳本

編輯 bin\startup.bat，在第一行前加入以下兩行（路徑請根據實際情況調整）：

SET JAVA_HOME=C:\jdk1.8.0_301
SET CATALINA_HOME=D:\apache-tomcat-9.0.73

同樣修改 bin\shutdown.bat 以便正常關閉服務。

3. 測試啟動與關閉

• 雙擊 startup.bat 啟動 Tomcat，預設端口 8080，瀏覽器訪問 https://localhost:8080 應出現 Tomcat 首頁。
• 雙擊 shutdown.bat 關閉服務。

三、將 Tomcat 註冊為 Windows 服務

1. 修改 service.bat

編輯 bin\service.bat，在開頭加入：

set CATALINA_HOME=%cd%

若機器從未安裝 Tomcat，或服務管理器中無同名服務，可直接進行下一步。否則需自訂服務名稱以避免衝突：

set SERVICE_NAME=Tomcat9
set PR_DISPLAYNAME=Apache Tomcat 9
set PR_DESCRIPTION=Apache Tomcat 9 Servlet Container

2. 安裝服務

以管理員身份開啟 CMD，切換至 Tomcat bin 目錄，執行：

service.bat install

出現 The service 'Tomcat9' has been installed 即表示成功。移除服務可執行 service.bat remove。

3. 設定自動啟動

執行 services.msc，找到剛安裝的服務，右鍵「屬性」→「啟動類型」改為「自動」，確定。重啟電腦後 Tomcat 將自動在後台運行。

四、命令列控制服務

注意： 服務名可用 SERVICE_NAME 或 PR_DISPLAYNAME；若名稱含空格或中文，需用半形雙引號括起，如 net start "Apache Tomcat 9"。

五、常見問題排查

• 端口衝突： 修改 conf/server.xml 中 Connector port="8080" 為其他可用端口。
• 中文亂碼： 在 Connector 元素加入 URIEncoding="UTF-8"。
• 服務啟動失敗： 查看 logs\commons-daemon.*.log 或 logs\catalina.*.log 定位錯誤。

至此，Tomcat ZIP 版安裝配置完成。祝您開發順利！