mirror of
https://github.com/apache/httpd.git
synced 2025-11-05 05:30:39 +03:00
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1180379 13f79535-47bb-0310-9956-ffa450edef68
224 lines
10 KiB
Plaintext
224 lines
10 KiB
Plaintext
<?xml version='1.0' encoding='ISO-8859-1' ?>
|
|
<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
|
|
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
|
|
<!-- English Revision: 1174747 -->
|
|
<!-- French translation by alain B, review by Vincent Deffontaines
|
|
updated by Lucien GENTIS -->
|
|
|
|
<!--
|
|
Licensed to the Apache Software Foundation (ASF) under one or more
|
|
contributor license agreements. See the NOTICE file distributed with
|
|
this work for additional information regarding copyright ownership.
|
|
The ASF licenses this file to You 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="name-based.xml.meta">
|
|
<parentdocument href="./">Serveurs virtuels</parentdocument>
|
|
<title>Support Apache des serveurs virtuels par nom</title>
|
|
|
|
<summary>
|
|
<p>Ce document décrit quand et comment utiliser des serveurs
|
|
virtuels par nom.</p>
|
|
</summary>
|
|
|
|
<seealso><a href="ip-based.html">Support Apache des serveurs virtuels par IP</a></seealso>
|
|
<seealso><a href="details.html">Détails sur le fonctionnement des serveurs virtuels</a></seealso>
|
|
<seealso><a href="mass.html">Configuration dynamique des hébergements virtuels de masse</a></seealso>
|
|
<seealso><a href="examples.html">Exemples d'utilisations de VirtualHost</a></seealso>
|
|
|
|
<section id="namevip"><title>Serveurs virtuels par nom vs. par IP</title>
|
|
|
|
<p>Les <a href="ip-based.html">serveurs virtuels</a> par IP utilisent l'adresse IP
|
|
de la connexion afin de déterminer quel serveur virtuel doit
|
|
répondre. Par conséquent, vous devez disposer d'adresses IP
|
|
différentes pour chaque serveur.</p>
|
|
|
|
<p>Avec un hébergement
|
|
virtuel par nom, le serveur s'appuie sur les informations
|
|
transmises par le client dans les en-têtes HTTP de ses requêtes.
|
|
La technique présentée ici vous permet de disposer de serveurs
|
|
virtuels différents partagés sur une même adresse IP.</p>
|
|
|
|
<p>L'hébergement virtuel par nom est habituellement plus simple,
|
|
car il vous suffit de configurer votre serveur DNS pour que
|
|
chaque domaine pointe sur l'adresse IP dont vous disposez, et de
|
|
configurer votre serveur Apache HTTP afin qu'il reconnaisse
|
|
ces domaines. Il réduit aussi la pénurie en adresses IP. Par
|
|
conséquent, vous devriez utiliser l'hébergement virtuel par
|
|
nom, sauf dans le cas où vous utiliseriez des équipements qui
|
|
nécessitent un hébergement basé sur IP. Les raisons historiques de
|
|
l'hébergement basé sur IP dans un but de support de certains clients ne
|
|
s'appliquent plus à un serveur web d'usage général.</p>
|
|
|
|
<p>La sélection du serveur virtuel en fonction du nom s'opère en
|
|
dehors de l'algorithme de sélection du serveur virtuel en fonction
|
|
de l'adresse IP, ce qui signifie que les recherches du point de vue
|
|
du nom du serveur ne s'effectuent que parmi le jeu de serveurs
|
|
virtuels pour lesquels la correspondance avec la paire adresse
|
|
IP/port est la plus exacte.</p>
|
|
|
|
</section>
|
|
|
|
<section id="alg"><title>Comment le serveur sélectionne-t-il le serveur
|
|
virtuel basé sur le nom approprié</title>
|
|
|
|
<p>Il est important de savoir que la première étape de la résolution
|
|
de serveur virtuel basée sur le nom est une résolution basée sur IP.
|
|
La résolution de serveur virtuel basée sur le nom ne fait que
|
|
choisir le serveur virtuel basé sur le nom le plus approprié, en se
|
|
limitant aux candidats qui conviennent le mieux du point de vue IP.
|
|
La résolution basée sur IP est sans objet si l'on
|
|
utilise un caractère générique (*) pour l'adresse IP dans
|
|
toutes les directives VirtualHost.</p>
|
|
|
|
<p>A l'arrivée d'une requête, le serveur va rechercher l'argument de
|
|
section <directive type="section"
|
|
module="core">VirtualHost</directive> présentant la meilleure
|
|
(la plus exacte) correspondance avec la paire adresse IP/port
|
|
utilisée dans la requête. Si plusieurs serveurs virtuels possèdent
|
|
cette même paire adresse IP/port, Apache va ensuite comparer les
|
|
valeurs des directives <directive module="core"
|
|
>ServerName</directive> et <directive
|
|
>module="core">ServerAlias</directive> avec le nom de serveur
|
|
présent dans la requête.</p>
|
|
|
|
<section id="defaultvhost"><title>Le serveur virtuel à base de nom
|
|
par défaut pour une paire adresse IP/port</title>
|
|
<p>Si aucune directive ServerName ou ServerAlias ne correspond dans
|
|
la liste de serveurs virtuels présentant la meilleure correspondance
|
|
du point de vue adresse IP/port, c'est <strong>le premier serveur
|
|
virtuel de cette liste</strong> qui sera utilisé.</p></section>
|
|
|
|
|
|
</section>
|
|
|
|
<section id="using"><title>Utilisation de serveurs virtuels par nom</title>
|
|
|
|
<related>
|
|
<modulelist>
|
|
<module>core</module>
|
|
</modulelist>
|
|
|
|
<directivelist>
|
|
<directive module="core">DocumentRoot</directive>
|
|
<directive module="core">ServerAlias</directive>
|
|
<directive module="core">ServerName</directive>
|
|
<directive module="core" type="section">VirtualHost</directive>
|
|
</directivelist>
|
|
</related>
|
|
|
|
|
|
<p>La première étape consiste à créer une section
|
|
<directive type="section" module="core">VirtualHost</directive>
|
|
pour chacun des serveurs à définir. Dans chaque section
|
|
<directive type="section" module="core">VirtualHost</directive>,
|
|
vous devez définir au minimum une directive
|
|
<directive module="core">ServerName</directive> pour désigner
|
|
le serveur concerné et une directive
|
|
<directive module="core">DocumentRoot</directive> pour préciser
|
|
l'emplacement sur le système de fichiers du contenu de ce serveur.</p>
|
|
|
|
<note><title>Le serveur principal disparaît</title>
|
|
<p>Toute requête qui ne correspond à aucune section <directive
|
|
type="section" module="core">VirtualHost</directive> existante
|
|
est traitée avec la configuration du serveur principal, sans
|
|
tenir compte du nom d'hôte ou de la directive ServerName.</p>
|
|
|
|
<p>Lorsque vous ajoutez un serveur virtuel basé sur le nom à un
|
|
serveur existant, et si les caractéristiques de ce serveur
|
|
virtuel correspondent à des combinaisons IP/port préexistantes,
|
|
les requêtes seront alors traitées par un serveur virtuel
|
|
explicite. Dans ce cas, il est en général judicieux de créer un
|
|
<a href="#defaultvhost">serveur virtuel par défaut</a>
|
|
comportant une directive <directive
|
|
module="core">ServerName</directive> correspondant au nom du
|
|
serveur principal. De nouveaux domaines sur les mêmes interface
|
|
et port, mais nécessitant des configurations distinctes,
|
|
pourront alors être ajoutés en tant que serveurs virtuels
|
|
spécifiques (et non par défaut).</p>
|
|
</note>
|
|
|
|
<p>Par exemple, supposez que vous hébergez le domaine
|
|
<code>www.example.com</code> et que vous souhaitez ajouter le
|
|
serveur virtuel <code>other.example.com</code> qui pointe sur
|
|
la même adresse IP. Il vous suffit d'ajouter la configuration
|
|
suivante à <code>httpd.conf</code> :</p>
|
|
|
|
<example>
|
|
<VirtualHost *:80><br />
|
|
<indent>
|
|
# Le premier serveur virtuel de la liste est aussi le
|
|
# serveur par défaut pour *:80
|
|
ServerName www.example.com<br />
|
|
ServerAlias example.com *.example.com<br />
|
|
DocumentRoot /www/domain<br />
|
|
</indent>
|
|
</VirtualHost><br />
|
|
<br />
|
|
<VirtualHost *:80><br />
|
|
<indent>ServerName other.example.com<br />
|
|
DocumentRoot /www/otherdomain<br />
|
|
</indent>
|
|
</VirtualHost><br />
|
|
</example>
|
|
|
|
<p>Autrement, vous pouvez spécifiez une adresse IP explicite
|
|
à la place de <code>*</code> dans la directive
|
|
<directive type="section" module="core" >VirtualHost</directive>.
|
|
Par exemple, cette méthode est utile si vous souhaitez faire
|
|
tourner quelques serveurs virtuels par nom sur une même adresse
|
|
IP, et d'autres, soit par IP, soit basés sur un autre jeu de
|
|
serveurs virtuels par nom sur une autre adresse IP.</p>
|
|
|
|
<p>Plusieurs serveurs sont accessibles par plus d'un nom. Il
|
|
suffit de placer la directive
|
|
<directive module="core">ServerAlias</directive> dans une section
|
|
<directive type="section" module="core">VirtualHost</directive>.
|
|
Par exemple, dans la première section
|
|
<directive type="section" module="core">VirtualHost</directive>
|
|
ci-dessus, la directive <directive module="core">ServerAlias</directive>
|
|
indique aux utilisateurs les autres noms permis pour accéder au
|
|
même site Web :</p>
|
|
|
|
<example>
|
|
ServerAlias example.com *.example.com
|
|
</example>
|
|
|
|
<p>ainsi, toutes les requêtes portant sur un domaine
|
|
<code>example.com</code> seront servies par le serveur virtuel
|
|
<code>www.example.com</code>. Les caractères joker <code>*</code>
|
|
et <code>?</code> peuvent être utilisés pour les correspondances.
|
|
Bien entendu, vous ne pouvez pas inventer des noms et les placer
|
|
dans une directive <directive module="core">ServerName</directive>
|
|
ou <code>ServerAlias</code>. Tout d'abord, votre serveur DNS
|
|
doit être correctement configuré pour lier ces noms à une
|
|
adresse IP associée avec votre serveur.</p>
|
|
|
|
<p>Finalement, vous pouvez affiner la configuration des serveurs
|
|
virtuels en plaçant d'autres directives à l'intérieur des sections
|
|
<directive type="section" module="core">VirtualHost</directive>.
|
|
La plupart des directives peut être placée dans ces sections en
|
|
y changeant seulement la configuration du serveur virtuel associé.
|
|
Pour déterminer si une directive particulière est permise,
|
|
consultez le <a
|
|
href="../mod/directive-dict.html#Context">contexte</a> de la
|
|
directive. Le jeu de directives configurées dans le contexte
|
|
du <em>serveur principal</em> (en dehors de toutes sections
|
|
<directive type="section" module="core">VirtualHost</directive>)
|
|
sera utilisé seulement s'il n'y a pas de configuration contraire
|
|
par un serveur virtuel.</p>
|
|
|
|
</section>
|
|
|
|
</manualpage>
|