部署流程概覽
- Windows 開發環境 → 打包 WAR。
- 上傳 Tomcat 與 WAR 至 Linux 伺服器。
- 配置 JDK 環境變數。
- 啟動 Tomcat 驗證。
詳細步驟
1. 打包 WAR (Eclipse/IDEA)
- Eclipse:專案右鍵 → Export → WAR file → 選擇目的地 → Finish。
- IDEA:
Build → Build Artifacts → Rebuild → out/artifacts/xxx.war。
- Maven/Gradle:
mvn clean package / gradle war 生成 target/*.war。
2. 上傳檔案
# 方式 A:WinSCP (GUI SFTP) 拖拽上傳
# 方式 B:scp 命令列
scp apache-tomcat-9.0.x.tar.gz user@linux:/opt/
scp myapp.war user@linux:/opt/apache-tomcat-9.0.x/webapps/
3. Linux 端解壓與配置
cd /opt
tar -zxvf apache-tomcat-9.0.x.tar.gz
ln -s apache-tomcat-9.0.x tomcat # 方便版本切換
# 確認 JDK 已安裝 (rpm/yum/解壓均可)
java -version
# 若未安裝:yum install java-1.8.0-openjdk-devel
4. 設定環境變數 (/etc/profile 或 ~/.bash_profile)
export JAVA_HOME=/usr/lib/jvm/java-1.8.0-openjdk
export CATALINA_HOME=/opt/tomcat
export PATH=$JAVA_HOME/bin:$CATALINA_HOME/bin:$PATH
source /etc/profile
5. 賦予執行權限並啟動
chmod +x $CATALINA_HOME/bin/*.sh
$CATALINA_HOME/bin/startup.sh
6. 常見錯誤與解決
| 錯誤 | 原因 | 解決 |
Permission denied | 腳本無執行權限 | chmod 755 *.sh (建議 755 而非 777) |
This file is needed to run this program | 未設定 JAVA_HOME 或路徑錯誤 | 檢查 echo $JAVA_HOME、which java |
| 啟動後無法訪問 8080 | 防火牆阻擋 / Tomcat bind 0.0.0.0 失敗 | firewall-cmd --add-port=8080/tcp --permanent、檢查 server.xml Connector address |
| 中文亂碼 | URI 編碼/資料庫連線字元集 | URIEncoding="UTF-8"、JDBC URL 加 characterEncoding=utf8 |
7. 驗證部署成功
tail -f $CATALINA_HOME/logs/catalina.out
# 關鍵字:Server startup in xxx ms
curl https://localhost:8080/myapp/
# 或瀏覽器訪問 https://ServerIP:8080/myapp/
生產環境建議
- 使用
systemd 管理 Tomcat 服務 (自動啟動、看門狗、日誌整合)。
- 配置 Nginx 反向代理 (Port 80/443 → 8080),啟用靜態資源快取、Gzip、SSL 終結。
- JVM 參數調優:
-Xms -Xmx -Xmn -XX:MetaspaceSize -XX:+UseG1GC 等依壓測調整。
- 日誌切割:
logrotate 或 cronolog 避免 catalina.out 無限增長。
- 安全:關閉管理介面、修改預設埠、啟用 SecurityManager、定期掃描 CVE。