examples.html.en revision 07dc96d063d49299da433f84b5c5681da9bbdf68
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head><!--
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess This file is generated from xml source: DO NOT EDIT
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
5a58787efeb02a1c3f06569d019ad81fd2efa06end<link href="/style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
5a58787efeb02a1c3f06569d019ad81fd2efa06end<link href="/style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
d29d9ab4614ff992b0e8de6e2b88d52b6f1f153erbowen<link href="/style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="/style/css/prettify.css" />
d29d9ab4614ff992b0e8de6e2b88d52b6f1f153erbowen<script src="/style/scripts/prettify.js" type="text/javascript">
5a58787efeb02a1c3f06569d019ad81fd2efa06end<link href="/images/favicon.ico" rel="shortcut icon" /></head>
af33a4994ae2ff15bc67d19ff1a7feb906745bf8rbowen<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="/glossary.html">Glossary</a> | <a href="/sitemap.html">Sitemap</a></p>
5a58787efeb02a1c3f06569d019ad81fd2efa06end<div class="up"><a href="./"><img title="<-" alt="<-" src="/images/left.gif" /></a></div>
3f08db06526d6901aa08c110b5bc7dde6bc39905nd<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.5</a> > <a href="./">Virtual Hosts</a></div><div id="page-content"><div id="preamble"><h1>VirtualHost Examples</h1>
ad74a0524a06bfe11b7de9e3b4ce7233ab3bd3f7nd<p><span>Available Languages: </span><a href="/en/vhosts/examples.html" title="English"> en </a> |
d05d0eb4ae6d2a5e513fc3bf2555ce33da416634nd<a href="/fr/vhosts/examples.html" hreflang="fr" rel="alternate" title="Fran�ais"> fr </a> |
7f5b59ccc63c0c0e3e678a168f09ee6a2f51f9d0nd<a href="/ja/vhosts/examples.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
4b3a8afbfcea8b265d179a122bf40dfedd1ce280takashi<a href="/ko/vhosts/examples.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
f086b4b402fa9a2fefc7dda85de2a3cc1cd0a654rjung<a href="/tr/vhosts/examples.html" hreflang="tr" rel="alternate" title="T�rk�e"> tr </a></p>
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess <p>This document attempts to answer the commonly-asked questions about
c573a8f047f4fbd3611d06ed1613e6f4679ef599rbowen setting up <a href="index.html">virtual hosts</a>. These scenarios are those involving multiple
f8dee27891059abb09ff5ca3fc5434f5719d22a0rbowen web sites running on a single server, via <a href="name-based.html">name-based</a> or <a href="ip-based.html">IP-based</a> virtual hosts.
5a58787efeb02a1c3f06569d019ad81fd2efa06end<div id="quickview"><ul id="toc"><li><img alt="" src="/images/down.gif" /> <a href="#purename">Running several name-based web
5a58787efeb02a1c3f06569d019ad81fd2efa06end<li><img alt="" src="/images/down.gif" /> <a href="#twoips">Name-based hosts on more than one
5a58787efeb02a1c3f06569d019ad81fd2efa06end<li><img alt="" src="/images/down.gif" /> <a href="#intraextra">Serving the same content on
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess different IP addresses (such as an internal and external
5a58787efeb02a1c3f06569d019ad81fd2efa06end<li><img alt="" src="/images/down.gif" /> <a href="#port">Running different sites on different
5a58787efeb02a1c3f06569d019ad81fd2efa06end<li><img alt="" src="/images/down.gif" /> <a href="#ip">IP-based virtual hosting</a></li>
5a58787efeb02a1c3f06569d019ad81fd2efa06end<li><img alt="" src="/images/down.gif" /> <a href="#ipport">Mixed port-based and ip-based virtual
5a58787efeb02a1c3f06569d019ad81fd2efa06end<li><img alt="" src="/images/down.gif" /> <a href="#mixed">Mixed name-based and IP-based
f8dee27891059abb09ff5ca3fc5434f5719d22a0rbowen<li><img alt="" src="/images/down.gif" /> <a href="#proxy">Using <code>Virtual_host</code> and
5a58787efeb02a1c3f06569d019ad81fd2efa06end<li><img alt="" src="/images/down.gif" /> <a href="#default">Using <code>_default_</code>
5a58787efeb02a1c3f06569d019ad81fd2efa06end<li><img alt="" src="/images/down.gif" /> <a href="#migrate">Migrating a name-based vhost to an
5a58787efeb02a1c3f06569d019ad81fd2efa06end<li><img alt="" src="/images/down.gif" /> <a href="#serverpath">Using the <code>ServerPath</code>
30471a4650391f57975f60bbb6e4a90be7b284bfhumbedooh</ul><ul class="seealso"><li><a href="#comments_section">Comments</a></li></ul></div>
5a58787efeb02a1c3f06569d019ad81fd2efa06end<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
5a58787efeb02a1c3f06569d019ad81fd2efa06end<h2><a name="purename" id="purename">Running several name-based web
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess <p>Your server has a single IP address, and multiple aliases (CNAMES)
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess point to this machine in DNS. You want to run a web server for
261c62b53a9c707c64c7824eed68b5463bd23e62nd <code>www.example.com</code> and <code>www.example.org</code> on this
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess machine.</p>
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess host configurations on your Apache server does not magically
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess cause DNS entries to be created for those host names. You
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess <em>must</em> have the names in DNS, resolving to your IP
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess address, or nobody else will be able to see your web site. You
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess can put entries in your <code>hosts</code> file for local
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess testing, but that will work only from the machine with those
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen# Ensure that Apache listens on port 80
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen<VirtualHost *:80>
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen # Other directives here
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen</VirtualHost>
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen<VirtualHost *:80>
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen # Other directives here
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen</VirtualHost>
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess <p>The asterisks match all addresses, so the main server serves no
6f7c18e70781deff3d1129774221de81b43c828end requests. Due to the fact that the virtual host with
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess in the configuration file, it has the highest priority and can be seen
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess as the <cite>default</cite> or <cite>primary</cite> server. That means
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess that if a request is received that does not match one of the specified
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess <code>ServerName</code> directives, it will be served by this first
6e14faf37935e36804b8bad802bc9dd58f3cf65dsf <p>You can, if you wish, replace <code>*</code> with the actual
6e14faf37935e36804b8bad802bc9dd58f3cf65dsf IP address of the system, when you don't care to discriminate based
6e14faf37935e36804b8bad802bc9dd58f3cf65dsf on the IP address or port.</p>
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess <p>However, it is additionally useful to use <code>*</code>
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess on systems where the IP address is not predictable - for
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess example if you have a dynamic IP address with your ISP, and
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess you are using some variety of dynamic DNS solution. Since
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess <code>*</code> matches any IP address, this configuration
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess would work without changes whenever your IP address
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess changes.</p>
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess <p>The above configuration is what you will want to use in almost
fd98d2e18dca5790daa7e49b4384937e6ba7666cerikabele all name-based virtual hosting situations. The only thing that this
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess configuration will not work for, in fact, is when you are serving
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess different content based on differing IP addresses or ports.</p>
5ae30adbe59946de742ab0cd6be3b7457471a698takashi </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
5a58787efeb02a1c3f06569d019ad81fd2efa06end<h2><a name="twoips" id="twoips">Name-based hosts on more than one
5ae30adbe59946de742ab0cd6be3b7457471a698takashi <p>Any of the techniques discussed here can be extended to any
5ae30adbe59946de742ab0cd6be3b7457471a698takashi number of IP addresses.</p>
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess <p>The server has two IP addresses. On one (<code>172.20.30.40</code>), we
d565edaec710102f7e7d06252aaf1de67b7ddd25rbowen will serve the "main" server, <code>server.example.com</code> and on the
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess other (<code>172.20.30.50</code>), we will serve two or more virtual hosts.</p>
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen# This is the "main" server running on 172.20.30.40
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen<VirtualHost 172.20.30.50>
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen # Other directives here ...
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen</VirtualHost>
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen<VirtualHost 172.20.30.50>
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen # Other directives here ...
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen</VirtualHost>
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess <p>Any request to an address other than <code>172.20.30.50</code> will be
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess served from the main server. A request to <code>172.20.30.50</code> with an
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess unknown hostname, or no <code>Host:</code> header, will be served from
5ae30adbe59946de742ab0cd6be3b7457471a698takashi </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
5a58787efeb02a1c3f06569d019ad81fd2efa06end<h2><a name="intraextra" id="intraextra">Serving the same content on
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess different IP addresses (such as an internal and external
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess <p>The server machine has two IP addresses (<code>192.168.1.1</code>
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess and <code>172.20.30.40</code>). The machine is sitting between an
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess internal (intranet) network and an external (internet) network. Outside
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess of the network, the name <code>server.example.com</code> resolves to
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess the external address (<code>172.20.30.40</code>), but inside the
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess network, that same name resolves to the internal address
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess <p>The server can be made to respond to internal and external requests
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess with the same content, with just one <code>VirtualHost</code>
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess section.</p>
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen<VirtualHost 192.168.1.1 172.20.30.40>
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen ServerAlias server
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen</VirtualHost>
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess <p>Now requests from both networks will be served from the same
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess network, one can just use the name <code>server</code> rather
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess than the fully qualified host name
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess <p>Note also that, in the above example, you can replace the list
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess of IP addresses with <code>*</code>, which will cause the server to
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess respond the same on all addresses.</p>
5ae30adbe59946de742ab0cd6be3b7457471a698takashi </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
5a58787efeb02a1c3f06569d019ad81fd2efa06end<h2><a name="port" id="port">Running different sites on different
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess <p>You have multiple domains going to the same IP and also want to
6e14faf37935e36804b8bad802bc9dd58f3cf65dsf serve multiple ports. The example below illustrates that the name-matching
6e14faf37935e36804b8bad802bc9dd58f3cf65dsf takes place after the best matching IP address and port combination
6e14faf37935e36804b8bad802bc9dd58f3cf65dsf is determined.</p>
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen<VirtualHost 172.20.30.40:80>
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen</VirtualHost>
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen<VirtualHost 172.20.30.40:8080>
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen</VirtualHost>
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen<VirtualHost 172.20.30.40:80>
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen</VirtualHost>
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen<VirtualHost 172.20.30.40:8080>
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen</VirtualHost>
5ae30adbe59946de742ab0cd6be3b7457471a698takashi </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
5a58787efeb02a1c3f06569d019ad81fd2efa06end<h2><a name="ip" id="ip">IP-based virtual hosting</a></h2>
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess <p>The server has two IP addresses (<code>172.20.30.40</code> and
261c62b53a9c707c64c7824eed68b5463bd23e62nd <code>www.example.com</code> and <code>www.example.org</code>
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess respectively.</p>
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen<VirtualHost 172.20.30.40>
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen</VirtualHost>
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen<VirtualHost 172.20.30.50>
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen</VirtualHost>
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess <p>Requests for any address not specified in one of the
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess <code>localhost</code>, for example) will go to the main server, if
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess there is one.</p>
5ae30adbe59946de742ab0cd6be3b7457471a698takashi </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
5a58787efeb02a1c3f06569d019ad81fd2efa06end<h2><a name="ipport" id="ipport">Mixed port-based and ip-based virtual
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess <p>The server machine has two IP addresses (<code>172.20.30.40</code> and
261c62b53a9c707c64c7824eed68b5463bd23e62nd <code>www.example.com</code> and <code>www.example.org</code>
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess respectively. In each case, we want to run hosts on ports 80 and
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowenListen 172.20.30.40:80
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowenListen 172.20.30.40:8080
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowenListen 172.20.30.50:80
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowenListen 172.20.30.50:8080
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen<VirtualHost 172.20.30.40:80>
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen</VirtualHost>
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen<VirtualHost 172.20.30.40:8080>
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen</VirtualHost>
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen<VirtualHost 172.20.30.50:80>
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen</VirtualHost>
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen<VirtualHost 172.20.30.50:8080>
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen</VirtualHost>
5ae30adbe59946de742ab0cd6be3b7457471a698takashi </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
5a58787efeb02a1c3f06569d019ad81fd2efa06end<h2><a name="mixed" id="mixed">Mixed name-based and IP-based
6e14faf37935e36804b8bad802bc9dd58f3cf65dsf <p>Any address mentioned in the argument to a virtualhost that never
6e14faf37935e36804b8bad802bc9dd58f3cf65dsf appears in another virtual host is a strictly IP-based virtual host.</p>
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen<VirtualHost 172.20.30.40>
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen</VirtualHost>
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen<VirtualHost 172.20.30.40>
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen</VirtualHost>
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen<VirtualHost 172.20.30.40>
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen</VirtualHost>
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen<VirtualHost 172.20.30.50>
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen</VirtualHost>
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen<VirtualHost 172.20.30.60>
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen</VirtualHost>
5ae30adbe59946de742ab0cd6be3b7457471a698takashi </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
f8dee27891059abb09ff5ca3fc5434f5719d22a0rbowen<h2><a name="proxy" id="proxy">Using <code>Virtual_host</code> and
f8dee27891059abb09ff5ca3fc5434f5719d22a0rbowen <p>The following example allows a front-end machine to proxy a
f8dee27891059abb09ff5ca3fc5434f5719d22a0rbowen virtual host through to a server running on another machine. In the
f8dee27891059abb09ff5ca3fc5434f5719d22a0rbowen example, a virtual host of the same name is configured on a machine
f8dee27891059abb09ff5ca3fc5434f5719d22a0rbowen at <code>192.168.111.2</code>. The <code class="directive"><a href="/mod/mod_proxy.html#proxypreservehost on">ProxyPreserveHost On</a></code> directive is
f8dee27891059abb09ff5ca3fc5434f5719d22a0rbowen used so that the desired hostname is passed through, in case we are
f8dee27891059abb09ff5ca3fc5434f5719d22a0rbowen proxying multiple hostnames to a single machine.</p>
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen<VirtualHost *:*>
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen ProxyPreserveHost On
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen ProxyPassReverse / http://192.168.111.2/
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen</VirtualHost>
f8dee27891059abb09ff5ca3fc5434f5719d22a0rbowen </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
5a58787efeb02a1c3f06569d019ad81fd2efa06end<h2><a name="default" id="default">Using <code>_default_</code>
5ae30adbe59946de742ab0cd6be3b7457471a698takashi <h3><a name="defaultallports" id="defaultallports"><code>_default_</code> vhosts
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess <p>Catching <em>every</em> request to any unspecified IP address and
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess port, <em>i.e.</em>, an address/port combination that is not used for
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess any other virtual host.</p>
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen<VirtualHost _default_:*>
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen</VirtualHost>
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess <p>Using such a default vhost with a wildcard port effectively prevents
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess any request going to the main server.</p>
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess <p>A default vhost never serves a request that was sent to an
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess address/port that is used for name-based vhosts. If the request
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess contained an unknown or no <code>Host:</code> header it is always
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess served from the primary name-based vhost (the vhost for that
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess address/port appearing first in the configuration file).</p>
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess <p>You can use <code class="directive"><a href="/mod/mod_alias.html#aliasmatch">AliasMatch</a></code> or
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess <code class="directive"><a href="/mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> to rewrite any
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess request to a single information page (or script).</p>
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess <h3><a name="defaultdifferentports" id="defaultdifferentports"><code>_default_</code> vhosts
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess <p>Same as setup 1, but the server listens on several ports and we want
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess to use a second <code>_default_</code> vhost for port 80.</p>
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen<VirtualHost _default_:80>
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen</VirtualHost>
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen<VirtualHost _default_:*>
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen</VirtualHost>
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess <p>The default vhost for port 80 (which <em>must</em> appear before any
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess default vhost with a wildcard port) catches all requests that were sent
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess to an unspecified IP address. The main server is never used to serve a
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess request.</p>
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess <h3><a name="defaultoneport" id="defaultoneport"><code>_default_</code> vhosts
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess <p>We want to have a default vhost for port 80, but no other default
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess vhosts.</p>
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen<VirtualHost _default_:80>
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen</VirtualHost>
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess <p>A request to an unspecified address on port 80 is served from the
d5b8072762cf428c4c703ed7054ae948d41c910bnd default vhost. Any other request to an unspecified address and port is
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess served from the main server.</p>
3c29010ad1a706e8d5931b250f1bc751e0dde676rbowen <p>Any use of <code>*</code> in a virtual host declaration will have
5ae30adbe59946de742ab0cd6be3b7457471a698takashi </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
5a58787efeb02a1c3f06569d019ad81fd2efa06end<h2><a name="migrate" id="migrate">Migrating a name-based vhost to an
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess <p>The name-based vhost with the hostname
261c62b53a9c707c64c7824eed68b5463bd23e62nd <code>www.example.org</code> (from our <a href="#name">name-based</a> example, setup 2) should get its own IP
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess address. To avoid problems with name servers or proxies who cached the
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess old IP address for the name-based vhost we want to provide both
a795ca2487c774aa6fe75c765a2bf17f969f7af7nd variants during a migration phase.</p>
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess The solution is easy, because we can simply add the new IP address
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess (<code>172.20.30.50</code>) to the <code>VirtualHost</code>
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess directive.</p>
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen<VirtualHost 172.20.30.40 172.20.30.50>
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen</VirtualHost>
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen<VirtualHost 172.20.30.40>
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen</VirtualHost>
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess <p>The vhost can now be accessed through the new address (as an
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess IP-based vhost) and through the old address (as a name-based
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess vhost).</p>
5ae30adbe59946de742ab0cd6be3b7457471a698takashi </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
5a58787efeb02a1c3f06569d019ad81fd2efa06end<h2><a name="serverpath" id="serverpath">Using the <code>ServerPath</code>
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess <p>We have a server with two name-based vhosts. In order to match the
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess correct virtual host a client must send the correct <code>Host:</code>
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess header. Old HTTP/1.0 clients do not send such a header and Apache has
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess no clue what vhost the client tried to reach (and serves the request
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess from the primary vhost). To provide as much backward compatibility as
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess possible we create a primary vhost which returns a single page
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess containing links with an URL prefix to the name-based virtual
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess hosts.</p>
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen<VirtualHost 172.20.30.40>
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen # primary vhost
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen RewriteEngine On
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen</VirtualHost>
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen<VirtualHost 172.20.30.40>
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen ServerPath /sub1/
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen RewriteEngine On
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen</VirtualHost>
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen<VirtualHost 172.20.30.40>
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen ServerPath /sub2/
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen RewriteEngine On
c3c006c28c5b03892ccaef6e4d2cbb15a13a2072rbowen</VirtualHost>
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess <p>Due to the <code class="directive"><a href="/mod/core.html#serverpath">ServerPath</a></code>
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess directive a request to the URL
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess <code>http://www.sub1.domain.tld/sub1/</code> is <em>always</em> served
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess from the sub1-vhost.<br /> A request to the URL
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess served from the sub1-vhost if the client sent a correct
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess <code>Host:</code> header. If no <code>Host:</code> header is sent the
a795ca2487c774aa6fe75c765a2bf17f969f7af7nd client gets the information page from the primary host.</p>
a795ca2487c774aa6fe75c765a2bf17f969f7af7nd <p>Please note that there is one oddity: A request to
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess <code>http://www.sub2.domain.tld/sub1/</code> is also served from the
a795ca2487c774aa6fe75c765a2bf17f969f7af7nd sub1-vhost if the client sent no <code>Host:</code> header.</p>
a795ca2487c774aa6fe75c765a2bf17f969f7af7nd <p>The <code class="directive"><a href="/mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> directives
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess are used to make sure that a client which sent a correct
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess <code>Host:</code> header can use both URL variants, <em>i.e.</em>,
fefb8b844b6286bfc41bb2e0c4cc003b8e7d4ff2kess with or without URL prefix.</p>
ad74a0524a06bfe11b7de9e3b4ce7233ab3bd3f7nd<p><span>Available Languages: </span><a href="/en/vhosts/examples.html" title="English"> en </a> |
d05d0eb4ae6d2a5e513fc3bf2555ce33da416634nd<a href="/fr/vhosts/examples.html" hreflang="fr" rel="alternate" title="Fran�ais"> fr </a> |
7f5b59ccc63c0c0e3e678a168f09ee6a2f51f9d0nd<a href="/ja/vhosts/examples.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
4b3a8afbfcea8b265d179a122bf40dfedd1ce280takashi<a href="/ko/vhosts/examples.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
f086b4b402fa9a2fefc7dda85de2a3cc1cd0a654rjung<a href="/tr/vhosts/examples.html" hreflang="tr" rel="alternate" title="T�rk�e"> tr </a></p>
727872d18412fc021f03969b8641810d8896820bhumbedooh</div><div class="top"><a href="#page-header"><img src="/images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div>
727872d18412fc021f03969b8641810d8896820bhumbedoohvar comments_shortname = 'httpd';
cc7e1025de9ac63bd4db6fe7f71c158b2cf09fe4humbedoohvar comments_identifier = 'http://httpd.apache.org/docs/trunk/vhosts/examples.html';
0d0ba3a410038e179b695446bb149cce6264e0abnd(function(w, d) {
cc7e1025de9ac63bd4db6fe7f71c158b2cf09fe4humbedooh if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
727872d18412fc021f03969b8641810d8896820bhumbedooh d.write('<div id="comments_thread"><\/div>');
0d0ba3a410038e179b695446bb149cce6264e0abnd var s = d.createElement('script');
ac082aefa89416cbdc9a1836eaf3bed9698201c8humbedooh s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
0d0ba3a410038e179b695446bb149cce6264e0abnd (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
727872d18412fc021f03969b8641810d8896820bhumbedooh d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
0d0ba3a410038e179b695446bb149cce6264e0abnd})(window, document);
07dc96d063d49299da433f84b5c5681da9bbdf68rbowen<p class="apache">Copyright 2014 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
af33a4994ae2ff15bc67d19ff1a7feb906745bf8rbowen<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="/glossary.html">Glossary</a> | <a href="/sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
0d0ba3a410038e179b695446bb149cce6264e0abndif (typeof(prettyPrint) !== 'undefined') {
7fec19672a491661b2fe4b29f685bc7f4efa64d4nd prettyPrint();