? 博客簡介Tomcat是Java Web開發最常用的輕量級服務器日常開發分為本地部署Windows開發調試和遠程部署Linux云服務器線上上線兩種場景。很多新手會混淆兩種部署的配置差異、端口放行、項目上線流程。本文從零手把手教學分別講解Windows本地Tomcat部署、Linux云服務器遠程Tomcat部署包含環境配置、服務啟動、項目部署、端口配置、常見報錯解決全程實操可直接復刻適合入門學習和項目上線使用。 環境說明本地環境Windows 10/11 JDK1.8 Tomcat9.0通用穩定版遠程環境阿里云/騰訊云Linux服務器CentOS7/8 JDK1.8 Tomcat9.0部署項目普通Java Web項目war包部署通用所有SSM/SpringBoot舊版Web項目一、前置必備JDK環境安裝配置Tomcat運行依賴JDK環境必須提前配置本地和遠程服務器都需要安裝對應版本JDK推薦JDK1.8兼容性最強。1.1 Windows本地JDK配置安裝JDK1.8安裝路徑建議純英文無中文無空格如D:\Java\jdk1.8配置系統環境變量新增JAVA_HOME值為JDK安裝根目錄在Path變量中添加%JAVA_HOME%\binCMD輸入java -version輸出版本號即配置成功1.2 Linux遠程服務器JDK配置CentOS服務器可直接yum安裝簡單高效yum install java-1.8.0-openjdk-devel -y # 驗證版本 java -version二、Windows本地Tomcat部署開發調試專用本地部署核心用于項目本地調試、功能測試、開發預覽無需配置防火墻、公網IP操作簡單僅需本地環境配置。2.1 Tomcat下載與解壓官網下載Tomcat9.0壓縮包zip格式Apache Tomcat官網解壓到純英文路徑禁止中文、空格、特殊字符推薦D:\Java\apache-tomcat-9.0無需安裝解壓即能用2.2 配置Tomcat環境變量可選推薦配置新增系統變量CATALINA_HOMETomcat解壓根目錄Path追加%CATALINA_HOME%\bin2.3 啟動、關閉Tomcat服務進入Tomcatbin目錄啟動服務雙擊startup.bat黑窗口不閃退即為啟動成功關閉服務雙擊shutdown.bat訪問測試瀏覽器輸入http://localhost:8080出現Tomcat官方歡迎頁面說明本地部署成功。2.4 本地部署Java Web項目兩種方式方式1自動部署最簡單推薦新手將項目打包好的xxx.war文件直接復制到Tomcatwebapps目錄重啟Tomcat后服務器會自動解壓war包、加載項目。訪問地址http://localhost:8080/項目名方式2手動配置虛擬路徑自定義項目路徑修改conf/server.xml在Host標簽內添加配置Context path/myweb docBaseD:\Java\webproject reloadabletrue crossContexttrue/path瀏覽器訪問項目路徑docBase本地項目真實存放路徑reloadabletrue修改代碼自動熱部署無需重啟服務2.5 本地部署常見問題啟動窗口閃退JDK環境未配置、端口8080被占用、路徑含中文端口占用解決修改conf/server.xml中8080端口為8081/8082三、Linux遠程服務器Tomcat部署項目上線專用遠程部署是將項目部署到云服務器公網環境實現外網訪問供用戶線上瀏覽使用相比本地部署多了服務器端口放行、防火墻配置、遠程文件上傳、開機自啟等核心配置。3.1 上傳并解壓Tomcat安裝包本地下載Tomcat9.0 tar.gz壓縮包通過Xshell、FinalShell、rz命令上傳到服務器推薦上傳目錄/usr/local/解壓命令# 解壓tomcat tar -zxvf apache-tomcat-9.0.tar.gz -C /usr/local/ # 重命名方便后續操作 mv /usr/local/apache-tomcat-9.0 /usr/local/tomcat93.2 服務器核心配置重中之重遠程部署最大的坑啟動成功但外網無法訪問本質是防火墻和安全組未放行端口。3.2.1 防火墻放行8080端口# CentOS7 放行端口 firewall-cmd --permanent --add-port8080/tcp # 重啟防火墻生效 firewall-cmd --reload # 查看已放行端口 firewall-cmd --list-ports3.2.2 云服務器安全組配置阿里云/騰訊云后臺進入服務器安全組配置手動添加規則協議TCP端口8080授權對象0.0.0.0/0允許所有外網訪問3.3 啟動、停止、重啟Tomcat# 啟動 /usr/local/tomcat9/bin/startup.sh # 停止 /usr/local/tomcat9/bin/shutdown.sh # 查看運行日志排查報錯 tail -f /usr/local/tomcat9/logs/catalina.out訪問測試瀏覽器輸入http://服務器公網IP:8080出現Tomcat首頁即遠程部署成功。3.4 遠程部署Java Web項目方式1war包直接部署主流上線方式本地將項目打成war包通過rz/ftp工具上傳到服務器Tomcatwebapps目錄重啟Tomcat服務自動解壓部署項目外網訪問http://公網IP:8080/項目名方式2Tomcat后臺可視化部署適合頻繁更新項目無需重啟服務。配置管理員賬號修改conf/tomcat-users.xml末尾添加role rolenamemanager-gui/ user usernameadmin password123456 rolesmanager-gui/重啟Tomcat訪問http://公網IP:8080/manager/html輸入賬號密碼上傳war包一鍵部署3.5 配置Tomcat開機自啟服務器必備防止服務器重啟后Tomcat服務失效配置開機自啟# 創建服務文件 vim /etc/systemd/system/tomcat.service寫入以下內容[Unit] DescriptionTomcat9 Server Afternetwork.target [Service] Typeforking EnvironmentJAVA_HOME/usr/lib/jvm/java-1.8.0-openjdk ExecStart/usr/local/tomcat9/bin/startup.sh ExecStop/usr/local/tomcat9/bin/shutdown.sh PrivateTmptrue [Install] WantedBymulti-user.target生效配置systemctl daemon-reload systemctl enable tomcat systemctl start tomcat四、本地部署 VS 遠程部署 核心區別對比對比維度本地Tomcat部署遠程Tomcat部署使用場景開發調試、代碼測試、本地預覽項目上線、外網訪問、正式運營訪問方式localhost/127.0.0.1僅本機訪問公網IP/域名全網可訪問端口配置無需放行防火墻僅本地端口不沖突即可必須放行服務器防火墻云平臺安全組端口項目更新熱部署、重啟本地服務即可上傳war包、后臺部署、重啟遠程服務額外配置無復雜配置開機自啟、權限配置、日志監控、安全配置 Tomcat本地部署+遠程服務器部署超詳細教程
? 博客簡介Tomcat是Java Web開發最常用的輕量級服務器日常開發分為本地部署Windows開發調試和遠程部署Linux云服務器線上上線兩種場景。很多新手會混淆兩種部署的配置差異、端口放行、項目上線流程。本文從零手把手教學分別講解Windows本地Tomcat部署、Linux云服務器遠程Tomcat部署包含環境配置、服務啟動、項目部署、端口配置、常見報錯解決全程實操可直接復刻適合入門學習和項目上線使用。 環境說明本地環境Windows 10/11 JDK1.8 Tomcat9.0通用穩定版遠程環境阿里云/騰訊云Linux服務器CentOS7/8 JDK1.8 Tomcat9.0部署項目普通Java Web項目war包部署通用所有SSM/SpringBoot舊版Web項目一、前置必備JDK環境安裝配置Tomcat運行依賴JDK環境必須提前配置本地和遠程服務器都需要安裝對應版本JDK推薦JDK1.8兼容性最強。1.1 Windows本地JDK配置安裝JDK1.8安裝路徑建議純英文無中文無空格如D:\Java\jdk1.8配置系統環境變量新增JAVA_HOME值為JDK安裝根目錄在Path變量中添加%JAVA_HOME%\binCMD輸入java -version輸出版本號即配置成功1.2 Linux遠程服務器JDK配置CentOS服務器可直接yum安裝簡單高效yum install java-1.8.0-openjdk-devel -y # 驗證版本 java -version二、Windows本地Tomcat部署開發調試專用本地部署核心用于項目本地調試、功能測試、開發預覽無需配置防火墻、公網IP操作簡單僅需本地環境配置。2.1 Tomcat下載與解壓官網下載Tomcat9.0壓縮包zip格式Apache Tomcat官網解壓到純英文路徑禁止中文、空格、特殊字符推薦D:\Java\apache-tomcat-9.0無需安裝解壓即能用2.2 配置Tomcat環境變量可選推薦配置新增系統變量CATALINA_HOMETomcat解壓根目錄Path追加%CATALINA_HOME%\bin2.3 啟動、關閉Tomcat服務進入Tomcatbin目錄啟動服務雙擊startup.bat黑窗口不閃退即為啟動成功關閉服務雙擊shutdown.bat訪問測試瀏覽器輸入http://localhost:8080出現Tomcat官方歡迎頁面說明本地部署成功。2.4 本地部署Java Web項目兩種方式方式1自動部署最簡單推薦新手將項目打包好的xxx.war文件直接復制到Tomcatwebapps目錄重啟Tomcat后服務器會自動解壓war包、加載項目。訪問地址http://localhost:8080/項目名方式2手動配置虛擬路徑自定義項目路徑修改conf/server.xml在Host標簽內添加配置Context path/myweb docBaseD:\Java\webproject reloadabletrue crossContexttrue/path瀏覽器訪問項目路徑docBase本地項目真實存放路徑reloadabletrue修改代碼自動熱部署無需重啟服務2.5 本地部署常見問題啟動窗口閃退JDK環境未配置、端口8080被占用、路徑含中文端口占用解決修改conf/server.xml中8080端口為8081/8082三、Linux遠程服務器Tomcat部署項目上線專用遠程部署是將項目部署到云服務器公網環境實現外網訪問供用戶線上瀏覽使用相比本地部署多了服務器端口放行、防火墻配置、遠程文件上傳、開機自啟等核心配置。3.1 上傳并解壓Tomcat安裝包本地下載Tomcat9.0 tar.gz壓縮包通過Xshell、FinalShell、rz命令上傳到服務器推薦上傳目錄/usr/local/解壓命令# 解壓tomcat tar -zxvf apache-tomcat-9.0.tar.gz -C /usr/local/ # 重命名方便后續操作 mv /usr/local/apache-tomcat-9.0 /usr/local/tomcat93.2 服務器核心配置重中之重遠程部署最大的坑啟動成功但外網無法訪問本質是防火墻和安全組未放行端口。3.2.1 防火墻放行8080端口# CentOS7 放行端口 firewall-cmd --permanent --add-port8080/tcp # 重啟防火墻生效 firewall-cmd --reload # 查看已放行端口 firewall-cmd --list-ports3.2.2 云服務器安全組配置阿里云/騰訊云后臺進入服務器安全組配置手動添加規則協議TCP端口8080授權對象0.0.0.0/0允許所有外網訪問3.3 啟動、停止、重啟Tomcat# 啟動 /usr/local/tomcat9/bin/startup.sh # 停止 /usr/local/tomcat9/bin/shutdown.sh # 查看運行日志排查報錯 tail -f /usr/local/tomcat9/logs/catalina.out訪問測試瀏覽器輸入http://服務器公網IP:8080出現Tomcat首頁即遠程部署成功。3.4 遠程部署Java Web項目方式1war包直接部署主流上線方式本地將項目打成war包通過rz/ftp工具上傳到服務器Tomcatwebapps目錄重啟Tomcat服務自動解壓部署項目外網訪問http://公網IP:8080/項目名方式2Tomcat后臺可視化部署適合頻繁更新項目無需重啟服務。配置管理員賬號修改conf/tomcat-users.xml末尾添加role rolenamemanager-gui/ user usernameadmin password123456 rolesmanager-gui/重啟Tomcat訪問http://公網IP:8080/manager/html輸入賬號密碼上傳war包一鍵部署3.5 配置Tomcat開機自啟服務器必備防止服務器重啟后Tomcat服務失效配置開機自啟# 創建服務文件 vim /etc/systemd/system/tomcat.service寫入以下內容[Unit] DescriptionTomcat9 Server Afternetwork.target [Service] Typeforking EnvironmentJAVA_HOME/usr/lib/jvm/java-1.8.0-openjdk ExecStart/usr/local/tomcat9/bin/startup.sh ExecStop/usr/local/tomcat9/bin/shutdown.sh PrivateTmptrue [Install] WantedBymulti-user.target生效配置systemctl daemon-reload systemctl enable tomcat systemctl start tomcat四、本地部署 VS 遠程部署 核心區別對比對比維度本地Tomcat部署遠程Tomcat部署使用場景開發調試、代碼測試、本地預覽項目上線、外網訪問、正式運營訪問方式localhost/127.0.0.1僅本機訪問公網IP/域名全網可訪問端口配置無需放行防火墻僅本地端口不沖突即可必須放行服務器防火墻云平臺安全組端口項目更新熱部署、重啟本地服務即可上傳war包、后臺部署、重啟遠程服務額外配置無復雜配置開機自啟、權限配置、日志監控、安全配置