jetty-如何配置虚拟主机

remington_young

　　jetty中文文档：www.jettycn.com



介绍

　　虚拟主机是注册在DNS中的IP地址的替代名。虚拟主机有两种形式：

• 多个名称可以解析到一个IP地址。
  
• 多宿主主机，即具有多个网络接口的机器，每个IP地址可以有不同的名称。
  

　　Jetty使用者在配置web应用程序时，经常要考虑到不同虚拟主机的情况。通常情况下，单个IP地址的机器有不同的DNS解析名称与它相关联，在其上部署的webapp必须能够通过所有的解析名称访问到。另一种可能性是从不同的虚拟主机访问不同的web应用程序。让我们来看看这些可能性。
　　你可以通过几种不同的方式设置虚拟主机，包括：

• 使用context目录中的context XML文件：setVirtualHosts
  。这是首选方法。
  
• 内嵌Jetty用法中的一个Java调用：内嵌Jetty
  。
  
• 
  jetty.xml
  中列出的明确部署的web应用（不通过deployer），或类似的机制。
  
• 使用WEB-INF/jetty-web.xml文件（已过时，但是可以和webapp deployer一起使用，如果你不使用context
  deployer）。
  

　　有关配置Jetty的各种方法的说明，请参阅如何配置Jetty
，其中包括了详细配置文档的链接。
　　接下来的示例使用首选方式设置虚拟主机，通过调用方法ContextHandler.setVirtualHost setVirtualHosts
。

配置虚拟主机

　　当配置web应用程序时，你可以设置一个IP地址和名称列表，只有通过列表中的地址才能访问到应用程序。假设我们有一台机器具有如下IP地址和DNS域名：

• 333.444.555.666
  
• 127.0.0.1
  
• www.blah.com
  
• www.blah.net
  
• www.blah.org
  

　　假设我们有一个web应用程序xxx.war，我们希望通过所有上述的名称和地址都能访问到这个应用。然后，我们将这样配置web应用：

<Configure class="org.eclipse.jetty.webapp.WebAppContext">
<Set name="contextPath">/xxx</Set>
<Set name="war"><SystemProperty name="jetty.home"/>/webapps/xxx.war</Set>
<Set name="virtualHosts">
<Array type="java.lang.String">
<Item>333.444.555.666</Item>
<Item>127.0.0.1</Item>
<Item>www.blah.com</Item>
<Item>www.blah.net</Item>
<Item>www.blah.org</Item>
</Array>
</Set>
</Configure>


　　假设我们已经配置了一个连接器，监听8080端口，那么web应用“xxx.war”将可以通过以下地址访问：

• http://333.444.555.666:8080/xxx
  
• http://127.0.0.1:8080/xxx
  
• http://www.blah.com:8080/xxx
  
• http://www.blah.net:8080/xxx
  
• http://www.blah.org:8080/xxx
  

为不同的虚拟主机配置不同的web应用

　　简单的为每个web应用提供不同的虚拟主机列表。例如：假设我们虚拟的主机有这些DNS域名和IP地址：

• 333.444.555.666
  
• 127.0.0.1
  
• www.blah.com
  
• www.blah.net
  
• www.blah.org
  
• 777.888.888.111
  
• www.other.com
  
• www.other.net
  
• www.other.org
  

　　假设我们有另外一个web应用“zzz.war”。我们希望xxx.war如上部署，zzz.war只部署在777.888.888.111、www.other.com、www.other.net和www.other.org中：

<!-- webapp xxx.war -->
<Configure class="org.eclipse.jetty.webapp.WebAppContext">
<Set name="contextPath">/xxx</Set>
<Set name="war"><SystemProperty name="jetty.home"/>/webapps/xxx.war</Set>
<Set name="virtualHosts">
<Array type="java.lang.String">
<Item>333.444.555.666</Item>
<Item>127.0.0.1</Item>
<Item>www.blah.com</Item>
<Item>www.blah.net</Item>
<Item>www.blah.org</Item>
</Array>
</Set>
</Configure>



<!-- webapp zzz.war -->
<Configure class="org.eclipse.jetty.webapp.WebAppContext">
<Set name="contextPath">/zzz</Set>
<Set name="war"><SystemProperty name="jetty.home"/>/webapps/zzz.war</Set>
<Set name="virtualHosts">
<Array type="java.lang.String">
<Item>777.888.888.111</Item>
<Item>www.other.com</Item>
<Item>www.other.net</Item>
<Item>www.other.org</Item>
</Array>
</Set>
</Configure>


　　web应用xxx.war在下列地址仍然可用：

• http://333.444.555.666:8080/xxx
  
• http://127.0.0.1:8080/xxx
  
• http://www.blah.com:8080/xxx
  
• http://www.blah.net:8080/xxx
  
• http://www.blah.org:8080/xxx
  

　　但现在web应用zzz.war在下列地址可用：

• http://777.888.888.111:8080/zzz
  
• http://www.other.com:8080/zzz
  
• http://www.other.net:8080/zzz
  
• http://www.other.org:8080/zzz
  

为不同的虚拟主机配置不同的web应用，但是具有相同的上下文（context path）

　　在上面的例子中，我们使得web应用zzz.war在一个特定虚拟主机集合中可用，并且上下文是/zzz。我们其他的web应用在不同的虚拟主机集合中，不同的上下文路径中可用。如果我们希望web应用在同一上下文路径，但是不同的虚拟主机集合中可用，会发生什么呢？
　　很简单，我们只需为每个web应用提供相同的上下文路径，保留之前定义的不相交的虚拟主机集合：

<Configure class="org.eclipse.jetty.webapp.WebAppContext">
<Set name="war"><SystemProperty name="jetty.home"/>/webapps/xxx.war</Set>
<Set name="contextPath">/</Set>
<Set name="virtualHosts">
<Array type="java.lang.String">
<Item>333.444.555.666</Item>
<Item>127.0.0.1</Item>
<Item>www.blah.com</Item>
<Item>www.blah.net</Item>
<Item>www.blah.org</Item>
</Array>
</Set>
</Configure>



<Configure class="org.eclipse.jetty.webapp.WebAppContext">
<Set name="war"><SystemProperty name="jetty.home"/>/webapps/zzz.war</Set>
<Set name="contextPath">/</Set>
<Set name="virtualHosts">
<Array type="java.lang.String">
<Item>777.888.888.111</Item>
<Item>www.other.com</Item>
<Item>www.other.net</Item>
<Item>www.other.org</Item>
</Array>
</Set>
</Configure>


　　现在，web应用xxx.war通过下面地址访问：

• http://333.444.555.666:8080/
  
• http://127.0.0.1:8080/
  
• http://www.blah.com:8080/
  
• http://www.blah.net:8080/
  
• http://www.blah.org:8080/
  

　　web应用zzz.war通过下面地址访问：

• http://777.888.888.111:8080/
  
• http://www.other.com:8080/
  
• http://www.other.net:8080/
  
• http://www.other.org:8080/
  

配置非ASCII字符的虚拟主机

　　国际域名
是含有非ASCII字符的名称。例如：http://www.bücher.com。DNS内部仍然是基于ASCII的，所以这些类型的名称需要编码处理后存储为ASCII格式，编码规则叫punycode
。现代浏览器将检测URL中的这些非ASCII字符，并自动使用Punycode码编码。例如，键入这个网址到浏览器：
　　http://www.åäö.com:8080/test/
　　被翻译成以下的URL：
　　http://www.xn--4cab6c.com:8080/test/
　　对于在jetty虚拟主机中使用国际域名的情况，你需要在你的context
xml文件中配置punycoded形式的名称（当然，你需要在DNS中提供punycoded形式的域名）。
　　下面是一个例子。意思是，我在8080端口运行了一个上下文为/test的web应用，我要配置的虚拟主机为www.åäö.com。我在context
xml文件中配置了域名的ASCII等效格式：

<Configure class="org.eclipse.jetty.webapp.WebAppContext">
<Set name="contextPath">/</Set>
<Set name="war"><SystemProperty name="jetty.home" default="."/>/webapps/test.war</Set>
<Set name="virtualHosts">
<Array type="String">
<Item>www.xn--4cab6c.com</Item>
</Array>
</Set>
</Configure>


　　在启动Jetty后，我将能够在我的浏览器中输入http://www.åäö.com:8080/test/形式的url来访问我的web应用。
　　请注意，如果我没有部署任何“/”上下文的web应用，访问http://www.åäö.com:8080的请求将由Jetty默认处理器处理，这会返回一个404页面并列出可用的上下文：

<H2>Error 404 - Not Found.</H2>
No context on this server matched or handled this request.<BR>
Contexts known to this server are:
<ul><li><a href="http://www.xn--4cab6c.com:8080/test">/test&nbsp;@&nbsp;www.xn--4cab6c.com:8080&nbsp;--->&nbsp;WebAppContext@82d210@82d210/test,file:/tmp/Jetty_0_0_0_0_8080_test.war__test_www.xn..4cab6c.com_1jadjg/webapp/,/home/janb/src/jetty-eclipse/jetty/trunk/jetty-distribution/target/distribution/webapps/test.war</a></li>
</ul>


　　你会发现该链接已经有了punycode编码的域名了。