Apache Tomcat 10

• 簡介
• 設定管理員應用程式存取
• 介面說明
• 訊息
• 主機管理員
• 主機名稱
• 新增虛擬主機
• 保留設定
• 伺服器資訊

Tomcat 主機管理員應用程式可讓您在 Tomcat 中建立、刪除和管理虛擬主機。本操作指南最適合搭配下列文件

• 虛擬主機操作指南，取得更多關於虛擬主機的資訊。
• 主機容器，取得更多關於虛擬主機基礎 XML 設定和屬性說明的資訊。
• 主機管理員應用程式 -- 文字介面，取得完整命令說明。

Tomcat 主機管理員應用程式是 Tomcat 安裝的一部分，預設使用下列內容：/host-manager。您可以使用下列方式使用主機管理員

• 使用圖形使用者介面，可於下列位置存取：{server}:{port}/host-manager/html。
• 使用一組適用於指令碼的最小 HTTP 要求。您可以在下列位置存取此模式：{server}:{port}/host-manager/text。

兩種方式都可讓您新增、移除、啟動和停止虛擬主機。變更可透過使用 persist 命令保留。本文重點在於 HTML 介面。如需圖形介面的更多資訊，請參閱 主機管理員應用程式 -- 文字介面。

以下說明使用 $CATALINA_HOME 來指 Tomcat 基本目錄。這是您安裝 Tomcat 的目錄，例如 C:\tomcat9 或 /usr/share/tomcat9。

Host Manager 應用程式需要具有下列其中一個角色的使用者

• admin-gui - 對圖形化網路介面使用此角色。
• admin-script - 對指令碼網路介面使用此角色。

若要啟用對 Host Manager 應用程式 HTML 介面的存取，請授與 Tomcat 使用者適當的角色，或使用正確的角色建立新的使用者。例如，開啟 ${CATALINA_BASE}/conf/tomcat-users.xml 並輸入下列內容

<user username="test" password="chang3m3N#w" roles="admin-gui"/>

不需要進一步的設定。當您現在存取 {server}:{port}/host-manager/html 時，您可以使用建立的憑證登入。

如果您使用的是不同的領域，您需要使用該領域的標準使用者管理工具，將必要的角色新增到適當的使用者。

介面分為六個區段

• 訊息 - 顯示成功和失敗訊息。
• Host Manager - 提供基本的 Host Manager 作業，例如清單和說明。
• 主機名稱 - 提供虛擬主機名稱清單，並讓您操作它們。
• 新增虛擬主機 - 讓您新增新的虛擬主機。
• 保留組態 - 讓您保留目前的虛擬主機。
• 伺服器資訊 - 有關 Tomcat 伺服器的資訊。

顯示您執行的最後一個 Host Manager 指令成功或失敗的資訊

• 成功：顯示 確定，後面可能會接著成功訊息。
• 失敗：顯示 失敗，後面接著錯誤訊息。

請注意，Tomcat 伺服器的控制台可能會顯示有關每個指令的更多資訊。

Host Manager 區段讓您

• 列出虛擬主機 - 更新目前組態的虛擬主機清單。
• HTML Host Manager 說明 - 文件連結。
• Host Manager 說明 - 文件連結。
• 伺服器狀態 - Manager 應用程式的連結。請注意，您的使用者必須擁有足夠的權限才能存取應用程式。

主機名稱區段包含目前組態的虛擬主機名稱清單。它讓您

• 檢視主機名稱
• 檢視主機名稱別名
• 執行基本指令，也就是 啟動、停止 和 移除。

新增虛擬主機區段讓您使用圖形化介面新增虛擬主機。有關每個屬性的說明，請參閱 Host Manager App -- 文字介面 文件。請注意，透過此介面新增的任何組態都是非持久的。

「持續設定」區段讓您能將目前的設定持續儲存在 server.xml 檔案中。

此功能預設為停用。若要啟用此選項，您必須先設定 StoreConfigLifecycleListener 監聽器。為此，請將以下監聽器新增至您的 server.xml

<Listener className="org.apache.catalina.storeconfig.StoreConfigLifecycleListener"/>

設定監聽器後，請按一下全部，讓您的設定持續存在。

提供目前執行的 Tomcat 執行個體、JVM 和底層作業系統的基本資訊。