解决 Tomcat 无法绑定 80 端口的问题，以及 Tomcat 配置虚拟目录、二级域名等

问题

今天安装完 Tomcat，安装时把 Tomcat 默认的 HTTP/1.1 Connector Port 从 8080 改为了 7080，启动 Tomcat，在浏览器中输入 Http://localhost:7080/ 也能看到 Tomcat 的欢迎页。后来想改成 80 端口，然后想测试绑定一个域名看看，于是进入 C:\Program Files\Apache Software Foundation\Tomcat 7.0\conf 的 server.xml，把配置改成下面的代码：

（注意：server.xml 中不能用中文注释，否则 Tomcat 启动会失败！）

<?xml version='1.0' encoding='utf-8'?>
<Server port="7005" shutdown="SHUTDOWN">
<Listener className="org.apache.catalina.core.AprLifecycleListener" SSLEngine="on" />
<Listener className="org.apache.catalina.core.JasperListener" />
<Listener className="org.apache.catalina.core.JreMemoryLeakPreventionListener" />
<Listener className="org.apache.catalina.mbeans.GlobalResourcesLifecycleListener" />
<Listener className="org.apache.catalina.core.ThreadLocalLeakPreventionListener" />
<GlobalNamingResources>
<Resource name="UserDatabase" auth="Container"
type="org.apache.catalina.UserDatabase"
description="User database that can be updated and saved"
factory="org.apache.catalina.users.MemoryUserDatabaseFactory"
pathname="conf/tomcat-users.xml" />
</GlobalNamingResources>
<Service name="Catalina">
<!-- 下面这里的 port 从 7080 改为 80 -->
<Connector port="80" protocol="HTTP/1.1"
connectionTimeout="20000"
redirectPort="8443" />
<Connector port="7009" protocol="AJP/1.3" redirectPort="8443" />
<!-- 下面这里的 defaultHost 从 localhost 改为 www.testMyTomcat.com -->
<Engine name="Catalina" defaultHost="www.testMyTomcat.com">
<Realm className="org.apache.catalina.realm.LockOutRealm">
<Realm className="org.apache.catalina.realm.UserDatabaseRealm"
resourceName="UserDatabase"/>
</Realm>
<Host name="www.testMyTomcat.com"  appBase="webapps"
unpackWARs="true" autoDeploy="true">
<Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs"
prefix="localhost_access_log." suffix=".txt"
pattern="%h %l %u %t "%r" %s %b" />

</Host>
</Engine>
</Service>
</Server>

注意：server.xml 中不能用中文注释，否则 Tomcat 启动会失败，Tomcat 里面的 log 文件夹中的日志会提示诸如下面的错误消息：

警告: Catalina.start using conf/server.xml:
com.sun.org.apache.xerces.internal.impl.io.MalformedByteSequenceException: 2 字节的 UTF-8 序列的字节 2 无效。
at com.sun.org.apache.xerces.internal.impl.io.UTF8Reader.invalidByte(Unknown Source)
at com.sun.org.apache.xerces.internal.impl.io.UTF8Reader.read(Unknown Source)
at com.sun.org.apache.xerces.internal.impl.XMLEntityScanner.load(Unknown Source)
at com.sun.org.apache.xerces.internal.impl.XMLEntityScanner.scanData(Unknown Source)
at com.sun.org.apache.xerces.internal.impl.XMLScanner.scanComment(Unknown Source)
at com.sun.org.apache.xerces.internal.impl.XMLDocumentFragmentScannerImpl.scanComment(Unknown Source)
at com.sun.org.apache.xerces.internal.impl.XMLDocumentFragmentScannerImpl$FragmentContentDriver.next(Unknown Source)
at com.sun.org.apache.xerces.internal.impl.XMLDocumentScannerImpl.next(Unknown Source)
at com.sun.org.apache.xerces.internal.impl.XMLDocumentFragmentScannerImpl.scanDocument(Unknown Source)
at com.sun.org.apache.xerces.internal.parsers.XML11Configuration.parse(Unknown Source)
at com.sun.org.apache.xerces.internal.parsers.XML11Configuration.parse(Unknown Source)
at com.sun.org.apache.xerces.internal.parsers.XMLParser.parse(Unknown Source)
at com.sun.org.apache.xerces.internal.parsers.AbstractSAXParser.parse(Unknown Source)
at com.sun.org.apache.xerces.internal.jaxp.SAXParserImpl$JAXPSAXParser.parse(Unknown Source)
at org.apache.tomcat.util.digester.Digester.parse(Digester.java:1537)
at org.apache.catalina.startup.Catalina.load(Catalina.java:617)
at org.apache.catalina.startup.Catalina.load(Catalina.java:665)
at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
at sun.reflect.NativeMethodAccessorImpl.invoke(Unknown Source)
at sun.reflect.DelegatingMethodAccessorImpl.invoke(Unknown Source)
at java.lang.reflect.Method.invoke(Unknown Source)
at org.apache.catalina.startup.Bootstrap.load(Bootstrap.java:281)
at org.apache.catalina.startup.Bootstrap.main(Bootstrap.java:455)

上面的代码，共修改了 2 个地方：


修改完后，重启 Tomcat，然后配置 C:\Windows\System32\Drivers\etc 的 Hosts 文件，增加一个映射：


在浏览器中输入 http://www.testMyTomcat.com 却无法显示，就像随意在浏览器中输入一个错误的地址后，显示的一样的错误页面。左思右想，却怎么也不知道到底是哪里错了。后来咨询同事，才想到可能是 80 端口被占用了，看看是不是被 IIS 给占用了。打开 IIS， 发现：



这就是当时做 Cookie 跨域名传递测试时配置的，原来如此，把 80 改为其它的后，再次打开浏览器，输入 http://www.testMyTomcat.com 后终于成功了，哈哈，心里一下子就开心了。

配置虚拟目录

配置完域名配置，那么如何配置虚拟目录呢？前面的配置不变，把 Host 节点替换成这样：

<Host name="www.testMyTomcat.com"  appBase="webapps"
unpackWARs="true" autoDeploy="true">
<Alias>testMyTomcat.com</Alias>
<Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs"
prefix="localhost_access_log." suffix=".txt"
pattern="%h %l %u %t "%r" %s %b" />
<Context docBase="E:\Deployment_Projects\Tomcat_WebApp\cas" path="sso"  reloadable="true"/>
</Host>

注意到了吗？只是在 </Host> 前面增加了一个

<Context docBase="E:\Deployment_Projects\Tomcat_WebApp\cas" path="sso"  reloadable="true"/>

其中 docBase 属性表示虚拟目录的地址，默认我的 tomcat 是安装在 C:\Program Files\Apache Software Foundation\Tomcat 7.0 的，我不想把 cas 项目也放在 C 盘，所以指定了一个绝对路径，path 属性表示 URL 访问时的路径。

修改完后重新启动 Tomcat，在浏览器中输入 http://www.testmytomcat.com/sso，结果成功！

配置二级域名

如果我想把 cas 项目（注：cas 是 java 里面著名的单点登录 SSO 项目）单独做一个二级域名，而不是以虚拟目录的形式提供给外部，那么该怎样配置呢？

1. 首先依旧配置 C:\Windows\System32\Drivers\etc 的 Hosts 文件，增加一个映射：


注：cas.testMyTomcat.com 是我随意起的，你也可以起名为 sso.testMyTomcat.com ，貌似这样大气一点，呵呵...

2. 修改 C:\Program Files\Apache Software Foundation\Tomcat 7.0\conf 的 server.xml，把配置改成下面的代码（PS：依旧只是把玩 Host 节点）：

<Host name="www.testMyTomcat.com"  appBase="webapps"
unpackWARs="true" autoDeploy="true">
<Alias>testMyTomcat.com</Alias>
<Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs"
prefix="localhost_access_log." suffix=".txt"
pattern="%h %l %u %t "%r" %s %b" />
</Host>

<Host name="cas.testMyTomcat.com"  appBase="E:\Deployment_Projects\Tomcat_WebApp"
unpackWARs="true" autoDeploy="true">
<Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs"
prefix="localhost_access_log." suffix=".txt"
pattern="%h %l %u %t "%r" %s %b" />
<Context docBase="E:\Deployment_Projects\Tomcat_WebApp\cas" path=""  reloadable="true"/>
</Host>

请注意第二个 Host 节点的 appBase 不能和第一个 Host 节点的 appBase 相同。

修改完后重新启动 Tomcat，在浏览器中输入 http://cas.testmytomcat.com/，结果成功！



完整配置如下：

<?xml version='1.0' encoding='utf-8'?>
<Server port="7005" shutdown="SHUTDOWN">
<Listener className="org.apache.catalina.core.AprLifecycleListener" SSLEngine="on" />
<Listener className="org.apache.catalina.core.JasperListener" />
<Listener className="org.apache.catalina.core.JreMemoryLeakPreventionListener" />
<Listener className="org.apache.catalina.mbeans.GlobalResourcesLifecycleListener" />
<Listener className="org.apache.catalina.core.ThreadLocalLeakPreventionListener" />
<GlobalNamingResources>
<Resource name="UserDatabase" auth="Container"
type="org.apache.catalina.UserDatabase"
description="User database that can be updated and saved"
factory="org.apache.catalina.users.MemoryUserDatabaseFactory"
pathname="conf/tomcat-users.xml" />
</GlobalNamingResources>
<Service name="Catalina">
<Connector port="80" protocol="HTTP/1.1"
connectionTimeout="20000"
redirectPort="8443" />
<Connector port="7009" protocol="AJP/1.3" redirectPort="8443" />
<Engine name="Catalina" defaultHost="www.testMyTomcat.com">
<Realm className="org.apache.catalina.realm.LockOutRealm">
<Realm className="org.apache.catalina.realm.UserDatabaseRealm"
resourceName="UserDatabase"/>
</Realm>

<Host name="www.testMyTomcat.com"  appBase="webapps"
unpackWARs="true" autoDeploy="true">
<Alias>testMyTomcat.com</Alias>
<Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs"
prefix="localhost_access_log." suffix=".txt"
pattern="%h %l %u %t "%r" %s %b" />
</Host>

<Host name="cas.testMyTomcat.com"  appBase="E:\Deployment_Projects\Tomcat_WebApp"
unpackWARs="true" autoDeploy="true">
<Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs"
prefix="localhost_access_log." suffix=".txt"
pattern="%h %l %u %t "%r" %s %b" />
<Context docBase="E:\Deployment_Projects\Tomcat_WebApp\cas" path=""  reloadable="true"/>
</Host>
</Engine>
</Service>
</Server>

多端口配置

如果我想把 cas 项目只是单独一个端口，那又该如何配置呢？

<Service name="Catalina">
<Connector port="80" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" />
<Connector port="7009" protocol="AJP/1.3" redirectPort="8443" />
<Engine name="Catalina" defaultHost="localhost">
<Realm className="org.apache.catalina.realm.LockOutRealm">
<Realm className="org.apache.catalina.realm.UserDatabaseRealm" resourceName="UserDatabase"/>
</Realm>

<Host name="localhost"  appBase="webapps"
unpackWARs="true" autoDeploy="true">
<Valve className="org.apache.catalina.valves.AccessLogValve"
directory="logs"
prefix="localhost_access_log." suffix=".txt"
pattern="%h %l %u %t "%r" %s %b" />
</Host>
</Engine>
</Service>

<Service name="Catalina2">
<Connector port="85" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="86" />
<Connector port="87" protocol="AJP/1.3" redirectPort="86" />
<Engine name="Catalina2" defaultHost="localhost">
<Realm className="org.apache.catalina.realm.LockOutRealm">
<Realm className="org.apache.catalina.realm.UserDatabaseRealm" resourceName="UserDatabase"/>
</Realm>

<Host name="localhost"  appBase="E:\Deployment_Projects\Tomcat_WebApp"
unpackWARs="true" autoDeploy="true">
<Valve className="org.apache.catalina.valves.AccessLogValve"
directory="logs"
prefix="localhost_access_log." suffix=".txt"
pattern="%h %l %u %t "%r" %s %b" />
<Context docBase="E:\Deployment_Projects\Tomcat_WebApp\cas" path=""  reloadable="true"/>
</Host>
</Engine>
</Service>

注：首先复制一个 Service 节点及子节点，修改相关的 name 属性和端口号。

打开浏览器，分别输入 Http://localhost/ 和 Http://localhost:85/， 测试通过！





谢谢浏览！