mirror of
https://github.com/apache/httpd.git
synced 2025-08-15 23:27:39 +00:00
905cdf9f0b
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@151408 13f79535-47bb-0310-9956-ffa450edef68
108 lines
4.1 KiB
XML
108 lines
4.1 KiB
XML
<?xml version='1.0' encoding='UTF-8' ?>
|
|
<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
|
|
<?xml-stylesheet type="text/xsl" href="../style/manual.en.xsl"?>
|
|
<!-- $LastChangedRevision$ -->
|
|
|
|
<!--
|
|
Copyright 2002-2005 The Apache Software Foundation or its licensors, as
|
|
applicable.
|
|
|
|
Licensed under the Apache License, Version 2.0 (the "License");
|
|
you may not use this file except in compliance with the License.
|
|
You may obtain a copy of the License at
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
Unless required by applicable law or agreed to in writing, software
|
|
distributed under the License is distributed on an "AS IS" BASIS,
|
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
See the License for the specific language governing permissions and
|
|
limitations under the License.
|
|
-->
|
|
|
|
<manualpage metafile="index.xml.meta">
|
|
<parentdocument href="../"/>
|
|
|
|
<title>Apache Virtual Host documentation</title>
|
|
|
|
<summary>
|
|
|
|
<p>The term <cite>Virtual Host</cite> refers to the practice of
|
|
running more than one web site (such as
|
|
<code>www.company1.com</code> and <code>www.company2.com</code>)
|
|
on a single machine. Virtual hosts can be "<a
|
|
href="ip-based.html">IP-based</a>", meaning that you have a
|
|
different IP address for every web site, or "<a
|
|
href="name-based.html">name-based</a>", meaning that you have
|
|
multiple names running on each IP address. The fact that they
|
|
are running on the same physical server is not apparent to the
|
|
end user.</p>
|
|
|
|
<p>Apache was one of the first servers to support IP-based
|
|
virtual hosts right out of the box. Versions 1.1 and later of
|
|
Apache support both IP-based and name-based virtual hosts
|
|
(vhosts). The latter variant of virtual hosts is sometimes also
|
|
called <em>host-based</em> or <em>non-IP virtual hosts</em>.</p>
|
|
|
|
<p>Below is a list of documentation pages which explain all
|
|
details of virtual host support in Apache version 1.3 and
|
|
later.</p>
|
|
|
|
</summary>
|
|
|
|
<seealso><module>mod_vhost_alias</module></seealso>
|
|
<seealso><a href="name-based.html">Name-based virtual
|
|
hosts</a></seealso>
|
|
<seealso><a href="ip-based.html">IP-based virtual hosts</a></seealso>
|
|
<seealso><a href="examples.html">Virtual host examples</a></seealso>
|
|
<seealso><a href="fd-limits.html">File descriptor limits</a></seealso>
|
|
<seealso><a href="mass.html">Mass virtual hosting</a></seealso>
|
|
<seealso><a href="details.html">Details of host matching</a></seealso>
|
|
|
|
<section id="support"><title>Virtual Host Support</title>
|
|
|
|
<ul>
|
|
<li><a href="name-based.html">Name-based Virtual Hosts</a> (More
|
|
than one web site per IP address)</li>
|
|
<li><a href="ip-based.html">IP-based Virtual Hosts</a> (An IP
|
|
address for each web site)</li>
|
|
<li><a href="examples.html">Virtual Host examples for common
|
|
setups</a></li>
|
|
<li><a href="fd-limits.html">File Descriptor Limits</a> (or,
|
|
<em>Too many log files</em>)</li>
|
|
<li><a href="mass.html">Dynamically Configured Mass Virtual
|
|
Hosting</a></li>
|
|
<li><a href="details.html">In-Depth Discussion of Virtual Host
|
|
Matching</a></li>
|
|
</ul>
|
|
|
|
</section>
|
|
|
|
<section id="directives"><title>Configuration directives</title>
|
|
|
|
<ul>
|
|
<li><directive type="section"
|
|
module="core">VirtualHost</directive></li>
|
|
<li><directive module="core">NameVirtualHost</directive></li>
|
|
<li><directive module="core">ServerName</directive></li>
|
|
<li><directive module="core">ServerAlias</directive></li>
|
|
<li><directive module="core">ServerPath</directive></li>
|
|
</ul>
|
|
|
|
<p>If you are trying to debug your virtual host configuration, you
|
|
may find the Apache <code>-S</code> command line switch
|
|
useful. That is, type the following command:</p>
|
|
|
|
<example>
|
|
/usr/local/apache2/bin/httpd -S
|
|
</example>
|
|
|
|
<p>This command will dump out a description of how Apache parsed
|
|
the configuration file. Careful examination of the IP addresses and
|
|
server names may help uncover configuration mistakes. (See
|
|
the docs for the <program>httpd</program> program for
|
|
other command line options)</p>
|
|
|
|
</section>
|
|
</manualpage>
|