Tomcat 的 server.xml 文件詳解

時間 2019-11-20

標籤 tomcat server.xml server xml 文件詳解欄目 Tomcat 简体版

原文原文鏈接

文件內容解讀

  1 <?xml version="1.0" encoding="UTF-8"?>
  2 <!--
  3   Licensed to the Apache Software Foundation (ASF) under one or more
  4   contributor license agreements.  See the NOTICE file distributed with
  5   this work for additional information regarding copyright ownership.
  6   The ASF licenses this file to You under the Apache License, Version 2.0
  7   (the "License"); you may not use this file except in compliance with
  8   the License.  You may obtain a copy of the License at
  9 
 10       http://www.apache.org/licenses/LICENSE-2.0
 11 
 12   Unless required by applicable law or agreed to in writing, software
 13   distributed under the License is distributed on an "AS IS" BASIS,
 14   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 15   See the License for the specific language governing permissions and
 16   limitations under the License.
 17 -->
 18 <!-- Note:  A "Server" is not itself a "Container", so you may not
 19      define subcomponents such as "Valves" at this level.
 20      Documentation at /docs/config/server.html
 21  -->
 22 <Server port="8005" shutdown="SHUTDOWN">
 23   <Listener className="org.apache.catalina.startup.VersionLoggerListener" />
 24   <!-- Security listener. Documentation at /docs/config/listeners.html
 25   <Listener className="org.apache.catalina.security.SecurityListener" />
 26   -->
 27   <!--APR library loader. Documentation at /docs/apr.html -->
 28   <Listener className="org.apache.catalina.core.AprLifecycleListener" SSLEngine="on" />
 29   <!-- Prevent memory leaks due to use of particular java/javax APIs-->
 30   <Listener className="org.apache.catalina.core.JreMemoryLeakPreventionListener" />
 31   <Listener className="org.apache.catalina.mbeans.GlobalResourcesLifecycleListener" />
 32   <Listener className="org.apache.catalina.core.ThreadLocalLeakPreventionListener" />
 33 
 34   <!-- Global JNDI resources
 35        Documentation at /docs/jndi-resources-howto.html
 36   -->
 37   <GlobalNamingResources>
 38     <!-- Editable user database that can also be used by
 39          UserDatabaseRealm to authenticate users
 40     -->
 41     <Resource name="UserDatabase" auth="Container"
 42               type="org.apache.catalina.UserDatabase"
 43               description="User database that can be updated and saved"
 44               factory="org.apache.catalina.users.MemoryUserDatabaseFactory"
 45               pathname="conf/tomcat-users.xml" />
 46   </GlobalNamingResources>
 47 
 48   <!-- A "Service" is a collection of one or more "Connectors" that share
 49        a single "Container" Note:  A "Service" is not itself a "Container",
 50        so you may not define subcomponents such as "Valves" at this level.
 51        Documentation at /docs/config/service.html
 52    -->
 53   <!-- 表明一個服務，這個Service能夠有多個，後面的name是服務名 -->
 54   <Service name="Catalina">
 55 
 56     <!--The connectors can use a shared executor, you can define one or more named thread pools-->
 57     <!--
 58     <Executor name="tomcatThreadPool" namePrefix="catalina-exec-"
 59         maxThreads="150" minSpareThreads="4"/>
 60     -->
 61 
 62 
 63     <!-- A "Connector" represents an endpoint by which requests are received
 64          and responses are returned. Documentation at :
 65          Java HTTP Connector: /docs/config/http.html
 66          Java AJP  Connector: /docs/config/ajp.html
 67          APR (HTTP/AJP) Connector: /docs/apr.html
 68          Define a non-SSL/TLS HTTP/1.1 Connector on port 8080
 69     -->
 70     <!-- 
 71         表明一個鏈接器，後邊指定了這個鏈接器使用的協議和端口號，還有超時時間，平時修改Tomcat端口號就是修改這個端口號，
 72         固然，還有其餘鏈接器，下面就有一個使用AJP1.3協議的鏈接器，不過平時不使用
 73     -->
 74     <Connector port="8080" protocol="HTTP/1.1"
 75                connectionTimeout="20000"
 76                redirectPort="8443" />
 77     <!-- A "Connector" using the shared thread pool-->
 78     <!--
 79     <Connector executor="tomcatThreadPool"
 80                port="8080" protocol="HTTP/1.1"
 81                connectionTimeout="20000"
 82                redirectPort="8443" />
 83     -->
 84     <!-- Define a SSL/TLS HTTP/1.1 Connector on port 8443
 85          This connector uses the NIO implementation. The default
 86          SSLImplementation will depend on the presence of the APR/native
 87          library and the useOpenSSL attribute of the
 88          AprLifecycleListener.
 89          Either JSSE or OpenSSL style configuration may be used regardless of
 90          the SSLImplementation selected. JSSE style configuration is used below.
 91     -->
 92     <!--
 93     <Connector port="8443" protocol="org.apache.coyote.http11.Http11NioProtocol"
 94                maxThreads="150" SSLEnabled="true">
 95         <SSLHostConfig>
 96             <Certificate certificateKeystoreFile="conf/localhost-rsa.jks"
 97                          type="RSA" />
 98         </SSLHostConfig>
 99     </Connector>
100     -->
101     <!-- Define a SSL/TLS HTTP/1.1 Connector on port 8443 with HTTP/2
102          This connector uses the APR/native implementation which always uses
103          OpenSSL for TLS.
104          Either JSSE or OpenSSL style configuration may be used. OpenSSL style
105          configuration is used below.
106     -->
107     <!--
108     <Connector port="8443" protocol="org.apache.coyote.http11.Http11AprProtocol"
109                maxThreads="150" SSLEnabled="true" >
110         <UpgradeProtocol className="org.apache.coyote.http2.Http2Protocol" />
111         <SSLHostConfig>
112             <Certificate certificateKeyFile="conf/localhost-rsa-key.pem"
113                          certificateFile="conf/localhost-rsa-cert.pem"
114                          certificateChainFile="conf/localhost-rsa-chain.pem"
115                          type="RSA" />
116         </SSLHostConfig>
117     </Connector>
118     -->
119 
120     <!-- Define an AJP 1.3 Connector on port 8009 -->
121     <Connector port="8009" protocol="AJP/1.3" redirectPort="8443" />
122 
123 
124     <!-- An Engine represents the entry point (within Catalina) that processes
125          every request.  The Engine implementation for Tomcat stand alone
126          analyzes the HTTP headers included with the request, and passes them
127          on to the appropriate Host (virtual host).
128          Documentation at /docs/config/engine.html -->
129 
130     <!-- You should set jvmRoute to support load-balancing via AJP ie :
131     <Engine name="Catalina" defaultHost="localhost" jvmRoute="jvm1">
132     -->
133     <!-- 服務引擎 defaulltHost用來指定默認的主機-->
134     <Engine name="Catalina" defaultHost="localhost">
135 
136       <!--For clustering, please take a look at documentation at:
137           /docs/cluster-howto.html  (simple how to)
138           /docs/config/cluster.html (reference documentation) -->
139       <!--
140       <Cluster className="org.apache.catalina.ha.tcp.SimpleTcpCluster"/>
141       -->
142 
143       <!-- Use the LockOutRealm to prevent attempts to guess user passwords
144            via a brute-force attack -->
145       <!-- 安全策略 -->
146       <Realm className="org.apache.catalina.realm.LockOutRealm">
147         <!-- This Realm uses the UserDatabase configured in the global JNDI
148              resources under the key "UserDatabase".  Any edits
149              that are performed against this UserDatabase are immediately
150              available for use by the Realm.  -->
151         <Realm className="org.apache.catalina.realm.UserDatabaseRealm"
152                resourceName="UserDatabase"/>
153       </Realm>
154 
155       <!-- 主機：name表明主機名，appBase表明根目錄，unpackWARs表明是否自動解壓WAR包，autoDeploy表明自動發佈，就是啓動狀態下能直接部署項目 -->
156       <Host name="localhost"  appBase="webapps"
157             unpackWARs="true" autoDeploy="true">
158 
159         <!-- SingleSignOn valve, share authentication between web applications
160              Documentation at: /docs/config/valve.html -->
161         <!--
162         <Valve className="org.apache.catalina.authenticator.SingleSignOn" />
163         -->
164 
165         <!-- Access log processes all example.
166              Documentation at: /docs/config/valve.html
167              Note: The pattern used is equivalent to using pattern="common" -->
168         <Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs"
169                prefix="localhost_access_log" suffix=".txt"
170                pattern="%h %l %u %t &quot;%r&quot; %s %b" />
171 
172       </Host>
173     </Engine>
174   </Service>
175 </Server>

建立虛擬目錄

一、直接在server.xml文件的Host標籤內添加Context標籤用於指定虛擬目錄，path表示訪問路徑，docBase表示項目路徑，也就是虛擬目錄，下面指定了項目地址，就不會訪問webapps目錄下的項目了，這種方式有個缺點是修改後必須重啓服務器。html

直接訪問http://localhost:8080/mywebjava

<Context path="/myweb" docBase="D:\Programmer\myweb" />

二、虛擬目錄的修改還有另一種方式，就是把這個Context標籤放到Tomcat的\conf\Catalina\localhost目錄下，新建一個xxx.xml，裏面添加上xml文件的頭部和Context標籤，這樣也能指定虛擬目錄，而且不用重啓服務器。web

<?xml version="1.0" encoding="UTF-8"?>
<Context docBase="D:\Programmer\myweb" />

直接訪問http://localhost:8080/xxx/express

建立虛擬主機

一、複製一個Host標籤出來，而後修改name爲www.wangbo.com，appBase目錄也能夠修改成D:\Programmer\web（將web項目複製一份放到這個目錄下）apache

      <Host name="localhost"  appBase="webapps"
            unpackWARs="true" autoDeploy="true">

        <!-- SingleSignOn valve, share authentication between web applications
             Documentation at: /docs/config/valve.html -->
        <!--
        <Valve className="org.apache.catalina.authenticator.SingleSignOn" />
        -->

        <!-- Access log processes all example.
             Documentation at: /docs/config/valve.html
             Note: The pattern used is equivalent to using pattern="common" -->
        <Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs"
               prefix="localhost_access_log" suffix=".txt"
               pattern="%h %l %u %t &quot;%r&quot; %s %b" />

      </Host>
      <Host name="www.wangbo.com"  appBase="D:\Programmer\web"
            unpackWARs="true" autoDeploy="true">
      </Host>