Tomcat 作為最流行的 Servlet 容器,正確配置能顯著提升開發效率與生產穩定性。本文整理自《Tomcat 權威指南》,涵蓋管理介面、應用部署、虛擬主機、連接器調優等核心場景。
CATALINA_BASE/webapps/admin.xmldocBase 為絕對路徑,或改寫 server.xml 定義 Contexttomcat-users.xml 添加角色與用戶:
<role name="admin"/>
<user name="admin" password="strong_password" roles="admin"/>
https://localhost:8080/admin,基於 Struts 框架、容器管理安全CATALINA_BASE/webapps/manager.xmlmanager 角色與用戶/manager/html/list (HTML) 或 /manager/list (文本) 進行部署/啟停/重載/移除file:/path/app.war)| 方式 | 操作 | 特點 |
|---|---|---|
| WAR 自動部署 | 拷貝 .war 到 webapps/ | 自動解壓、建立 Context、熱部署 |
| Context 片斷部署 | 寫 xxx.xml 放 webapps/ | 應用可置任意路徑、無需修改 server.xml、熱部署 |
Context 片斷範例:
<Context path="/demo" docBase="webapps/MyWebApp.war" debug="0" privileged="true">
<Realm className="org.apache.catalina.realm.UserDatabaseRealm" resourceName="UserDatabase"/>
</Context>
在 server.xml <Engine> 下添加多個 <Host>:
<Engine name="Standalone" defaultHost="localhost">
<Host name="www.example.com" appBase="webapps_example" unpackWARs="true" autoDeploy="true">
<Alias>example.com</Alias>
<Valve className="org.apache.catalina.valves.AccessLogValve" ... />
</Host>
<Host name="api.example.com" appBase="webapps_api" ...> ... </Host>
</Engine>
需配合 DNS/hosts 解析,單實例服務多域名。
<Connector port="8080" protocol="HTTP/1.1"
maxThreads="200" minSpareThreads="25"
acceptCount="100" connectionTimeout="20000"
compression="on" compressableMimeType="text/html,text/xml,text/plain,text/css,text/javascript"
enableLookups="false" />
<Connector port="8443" protocol="org.apache.coyote.http11.Http11NioProtocol"
SSLEnabled="true" scheme="https" secure="true"
keystoreFile="conf/keystore" keystorePass="changeit"
clientAuth="false" sslProtocol="TLS"/>
<Valve className="org.apache.catalina.valves.AccessLogValve"
directory="logs" prefix="access_log" suffix=".txt"
pattern="%h %l %u %t "%r" %s %b %D %q %{User-Agent}i" />
配置 <Cluster> + DeltaManager / BackupManager,配合 <Manager className="org.apache.catalina.session.PersistentManager"> 實現 Session 落盤/跨節點備份。
docs、examples、manager、admin 應用<init-param><param-name>listings</param-name><param-value>false</param-value></init-param>RemoteAddrValve-Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.port=9000
-Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false
配合 JConsole / VisualVM / Prometheus JMX Exporter 監控執行緒、堆內存、請求處理時間等指標。