granicus.if.org Git - apache/blob - docs/manual/vhosts/index.html.en

   1 <?xml version="1.0" encoding="ISO-8859-1"?>
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
   3 <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head>
   4 <meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
   5 <!--
   6         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   7               This file is generated from xml source: DO NOT EDIT
   8         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   9       -->
  10 <title>Apache Virtual Host documentation - Apache HTTP Server Version 2.5</title>
  11 <link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
  12 <link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
  13 <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" />
  14 <script src="../style/scripts/prettify.min.js" type="text/javascript">
  15 </script>
  16
  17 <link href="../images/favicon.ico" rel="shortcut icon" /></head>
  18 <body id="manual-page"><div id="page-header">
  19 <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>
  20 <p class="apache">Apache HTTP Server Version 2.5</p>
  21 <img alt="" src="../images/feather.png" /></div>
  22 <div class="up"><a href="../"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
  23 <div id="path">
  24 <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.5</a></div><div id="page-content"><div id="preamble"><h1>Apache Virtual Host documentation</h1>
  25 <div class="toplang">
  26 <p><span>Available Languages: </span><a href="../de/vhosts/" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> |
  27 <a href="../en/vhosts/" title="English">&nbsp;en&nbsp;</a> |
  28 <a href="../fr/vhosts/" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
  29 <a href="../ja/vhosts/" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
  30 <a href="../ko/vhosts/" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
  31 <a href="../tr/vhosts/" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a> |
  32 <a href="../zh-cn/vhosts/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese">&nbsp;zh-cn&nbsp;</a></p>
  33 </div>
  34
  35
  36     <p>The term <cite>Virtual Host</cite> refers to the practice of
  37     running more than one web site (such as
  38     <code>company1.example.com</code> and <code>company2.example.com</code>)
  39     on a single machine. Virtual hosts can be "<a href="ip-based.html">IP-based</a>", meaning that you have a
  40     different IP address for every web site, or "<a href="name-based.html">name-based</a>", meaning that you have
  41     multiple names running on each IP address. The fact that they
  42     are running on the same physical server is not apparent to the
  43     end user.</p>
  44
  45     <p>Apache was one of the first servers to support IP-based
  46     virtual hosts right out of the box. Versions 1.1 and later of
  47     Apache support both IP-based and name-based virtual hosts
  48     (vhosts). The latter variant of virtual hosts is sometimes also
  49     called <em>host-based</em> or <em>non-IP virtual hosts</em>.</p>
  50
  51     <p>Below is a list of documentation pages which explain all
  52     details of virtual host support in Apache HTTP Server:</p>
  53
  54 </div>
  55 <div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#support">Virtual Host Support</a></li>
  56 <li><img alt="" src="../images/down.gif" /> <a href="#directives">Configuration directives</a></li>
  57 </ul><h3>See also</h3><ul class="seealso"><li><code class="module"><a href="../mod/mod_vhost_alias.html">mod_vhost_alias</a></code></li><li><a href="name-based.html">Name-based virtual
  58 hosts</a></li><li><a href="ip-based.html">IP-based virtual hosts</a></li><li><a href="examples.html">Virtual host examples</a></li><li><a href="fd-limits.html">File descriptor limits</a></li><li><a href="mass.html">Mass virtual hosting</a></li><li><a href="details.html">Details of host matching</a></li></ul></div>
  59 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  60 <div class="section">
  61 <h2><a name="support" id="support">Virtual Host Support</a> <a title="Permanent link" href="#support" class="permalink">&para;</a></h2>
  62
  63     <ul>
  64       <li><a href="name-based.html">Name-based Virtual Hosts</a> (More
  65       than one web site per IP address)</li>
  66       <li><a href="ip-based.html">IP-based Virtual Hosts</a> (An IP
  67       address for each web site)</li>
  68       <li><a href="examples.html">Virtual Host examples for common
  69       setups</a></li>
  70       <li><a href="fd-limits.html">File Descriptor Limits</a> (or,
  71       <em>Too many log files</em>)</li>
  72       <li><a href="mass.html">Dynamically Configured Mass Virtual
  73       Hosting</a></li>
  74       <li><a href="details.html">In-Depth Discussion of Virtual Host
  75       Matching</a></li>
  76     </ul>
  77
  78 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  79 <div class="section">
  80 <h2><a name="directives" id="directives">Configuration directives</a> <a title="Permanent link" href="#directives" class="permalink">&para;</a></h2>
  81
  82     <ul>
  83       <li><code class="directive"><a href="../mod/core.html#virtualhost">&lt;VirtualHost&gt;</a></code></li>
  84       <li><code class="directive"><a href="../mod/core.html#servername">ServerName</a></code></li>
  85       <li><code class="directive"><a href="../mod/core.html#serveralias">ServerAlias</a></code></li>
  86       <li><code class="directive"><a href="../mod/core.html#serverpath">ServerPath</a></code></li>
  87     </ul>
  88
  89     <p>If you are trying to debug your virtual host configuration, you
  90     may find the <code>-S</code> command line switch
  91     useful.</p>
  92
  93     <div class="example"><h3>Unix example</h3><p><code>
  94
  95     apachectl -S
  96     </code></p></div>
  97
  98     <div class="example"><h3>Windows example</h3><p><code>
  99
 100     httpd.exe -S
 101     </code></p></div>
 102
 103
 104     <p>This command will dump out a description of how Apache parsed
 105     the configuration file. Careful examination of the IP addresses and
 106     server names may help uncover configuration mistakes. (See
 107     the docs for the <code class="program"><a href="../programs/httpd.html">httpd</a></code> program for
 108     other command line options)</p>
 109
 110 </div></div>
 111 <div class="bottomlang">
 112 <p><span>Available Languages: </span><a href="../de/vhosts/" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> |
 113 <a href="../en/vhosts/" title="English">&nbsp;en&nbsp;</a> |
 114 <a href="../fr/vhosts/" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
 115 <a href="../ja/vhosts/" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
 116 <a href="../ko/vhosts/" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
 117 <a href="../tr/vhosts/" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a> |
 118 <a href="../zh-cn/vhosts/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese">&nbsp;zh-cn&nbsp;</a></p>
 119 </div><div id="footer">
 120 <p class="apache">Copyright 2019 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>
 121 <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[//><!--
 122 if (typeof(prettyPrint) !== 'undefined') {
 123     prettyPrint();
 124 }
 125 //--><!]]></script>
 126 </body></html>