<?xml version='1.0' encoding='ISO-8859-1' ?>
<!-- English Revision: 1628690:1673945 (outdated) -->
<!-- French translation by Vincent Deffontaines, Alain B. -->
<!-- reviewed 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
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="examples.xml.meta">
<parentdocument href="./">Serveurs virtuels</parentdocument>
<title>Exemples d'utilisations de VirtualHost</title>
<summary>
<p>Le but de ce document est d'essayer de r�pondre aux questions
Les sc�narios pr�sent�s ici se rencontrent quand plusieurs
serveurs Webs doivent tourner sur une seule et m�me machine au
</summary>
<section id="purename"><title>Fonctionnement de plusieurs serveurs
virtuels par nom sur une seule adresse IP.</title>
<p>Votre serveur poss�de plusieurs noms d'h�te qui correspondent �
une seule adresse IP, ce qui lui permet de r�pondre diff�remment si
<note><title>Note :</title><p>La configuration de serveurs virtuels
sous Apache ne provoque pas leur apparition magique dans la
configuration du DNS. Il <em>faut</em> que leurs noms soient
d�finis dans le DNS, et qu'ils y soient r�solus sur l'adresse IP
du serveur, faute de quoi personne ne pourra visiter votre site Web.
Il est possible d'ajouter des entr�es dans le fichier
<code>hosts</code> pour tests locaux, mais qui ne fonctionneront
que sur la machine poss�dant ces entr�es.</p>
</note>
<highlight language="config">
# Apache doit �couter sur le port 80
Listen 80
<VirtualHost *:80>
ServerName www.example.com
# Autres directives ici
</VirtualHost>
<VirtualHost *:80>
ServerName www.example.org
# Autres directives ici
</VirtualHost>
</highlight>
<p>Les ast�risques correspondent � toutes les adresses, si bien que
le serveur principal ne r�pondra jamais � aucune requ�te. Comme le
serveur virtuel
de configuration, il a la plus grande priorit� et peut �tre vu
comme serveur <cite>par d�faut</cite> ou <cite>primaire</cite> ;
ce qui signifie que toute requ�te re�ue ne correspondant � aucune
des directives <code>ServerName</code> sera servie par ce premier
<code>VirtualHost</code>.</p>
<p>La configuration ci-dessus correspond � ce que l'on souhaite pour
la plupart des serveurs virtuels � base de nom. Il faudra cependant
utiliser une configuration diff�rente si vous souhaitez servir un
contenu diff�rent en fonction de l'adresse IP ou du port.</p>
<note>
<title>Note :</title>
<p>Vous pouvez remplacer <code>*</code>
par une adresse IP du syst�me. Le serveur virtuel concern�
ne sera alors s�lectionn� que pour les requ�tes HTTP vers
cette adresse IP.</p>
<p>En g�n�ral, il est commode d'utiliser <code>*</code> sur
les syst�mes dont l'adresse IP n'est pas constante - par
exemple, pour des serveurs dont l'adresse IP est attribu�e
dynamiquement par le FAI, et o� le DNS est g�r� au moyen
d'un DNS dynamique quelconque. Comme <code>*</code> signifie
<cite>n'importe quelle adresse</cite>, cette configuration
fonctionne sans devoir �tre modifi�e quand l'adresse IP du
syst�me est modifi�e.</p>
</note>
</section>
<section id="twoips"><title>Serveurs virtuels par nom sur plus
d'une seule adresse IP.</title>
<note>
<title>Note :</title><p>Toutes les techniques pr�sent�es ici
peuvent �tre �tendues � un plus grand nombre d'adresses IP.</p>
</note>
<p>Le serveur a deux adresses IP. Sur l'une
(<code>172.20.30.40</code>), le serveur "principal"
(<code>172.20.30.50</code>), deux serveurs virtuels (ou plus)
r�pondront.</p>
<highlight language="config">
Listen 80
# Serveur "principal" sur 172.20.30.40
ServerName server.example.com
DocumentRoot /www/mainserver
<VirtualHost 172.20.30.50>
ServerName www.example.com
# D'autres directives ici ...
</VirtualHost>
<VirtualHost 172.20.30.50>
ServerName www.example.org
# D'autres directives ici ...
</VirtualHost>
</highlight>
<p>Toute requ�te arrivant sur une autre adresse que
<code>172.20.30.50</code> sera servie par le serveur principal.
Les requ�tes vers <code>172.20.30.50</code> avec un nom de serveur
inconnu, ou sans en-t�te <code>Host:</code>, seront servies par
</section>
<section id="intraextra"><title>Servir le m�me contenu sur des
adresses IP diff�rentes (telle qu'une adresse interne et une
externe).</title>
<p>La machine serveur dispose de deux adresses IP
(<code>192.168.1.1</code> et <code>172.20.30.40</code>). Cette
machine est plac�e � la fois sur le r�seau interne (l'Intranet)
et le r�seau externe (Internet). Sur Internet, le nom
(<code>172.20.30.40</code>), mais sur le r�seau interne, ce m�me
nom pointe vers l'adresse interne (<code>192.168.1.1</code>).</p>
<p>Le serveur peut �tre configur� pour r�pondre de la m�me mani�re
aux requ�tes internes et externes, au moyen d'une seule section
<code>VirtualHost</code>.</p>
<highlight language="config">
<VirtualHost 192.168.1.1 172.20.30.40>
ServerName server.example.com
ServerAlias server
</VirtualHost>
</highlight>
<p>Ainsi, les requ�tes en provenance de chacun des deux r�seaux
seront servies par le m�me <code>VirtualHost</code>.</p>
<note>
<title>Note :</title><p>Sur le r�seau interne, il est possible
d'utiliser le nom raccourci <code>server</code> au lieu du nom
<p>Notez �galement que dans l'exemple pr�c�dent, vous pouvez
remplacer la liste des adresses IP par des <code>*</code> afin
que le serveur r�ponde de la m�me mani�re sur toutes ses
adresses.</p>
</note>
</section>
<section id="port"><title>Servir diff�rents sites sur diff�rents
ports.</title>
<p>Vous disposez de plusieurs domaines pointant sur la m�me adresse
IP et vous voulez �galement servir de multiples ports. L'exemple
suivant montre que la s�lection en fonction du nom intervient apr�s
la s�lection de la meilleure correspondance du point de vue adresse
<highlight language="config">
Listen 80
Listen 8080
<VirtualHost 172.20.30.40:80>
ServerName www.example.com
</VirtualHost>
<VirtualHost 172.20.30.40:8080>
ServerName www.example.com
DocumentRoot /www/domain-8080
</VirtualHost>
<VirtualHost 172.20.30.40:80>
ServerName www.example.org
DocumentRoot /www/otherdomain-80
</VirtualHost>
<VirtualHost 172.20.30.40:8080>
ServerName www.example.org
DocumentRoot /www/otherdomain-8080
</VirtualHost>
</highlight>
</section>
<section id="ip"><title>H�bergement virtuel bas� sur IP</title>
<p>Le serveur dispose de deux adresses IP (<code>172.20.30.40</code>
et <code>172.20.30.50</code>) correspondant respectivement aux noms
<highlight language="config">
Listen 80
<VirtualHost 172.20.30.40>
ServerName www.example.com
</VirtualHost>
<VirtualHost 172.20.30.50>
ServerName www.example.org
</VirtualHost>
</highlight>
<p>Les requ�tes provenant d'adresses non sp�cifi�es dans l'une des
directives <code><VirtualHost></code> (comme pour
<code>localhost</code> par exemple) seront dirig�es vers le serveur
principal, s'il en existe un.</p>
</section>
<section id="ipport"><title>H�bergements virtuels mixtes bas�s sur
les ports et sur les IP</title>
<p>Le serveur dispose de deux adresses IP (<code>172.20.30.40</code>
et <code>172.20.30.50</code>) correspondant respectivement aux noms
Pour chacun d'eux, nous voulons un h�bergement sur les ports 80
et 8080.</p>
<highlight language="config">
Listen 172.20.30.40:80
Listen 172.20.30.40:8080
Listen 172.20.30.50:80
Listen 172.20.30.50:8080
<VirtualHost 172.20.30.40:80>
DocumentRoot /www/example1-80
ServerName www.example.com
</VirtualHost>
<VirtualHost 172.20.30.40:8080>
DocumentRoot /www/example1-8080
ServerName www.example.com
</VirtualHost>
<VirtualHost 172.20.30.50:80>
DocumentRoot /www/example2-80
ServerName www.example.org
</VirtualHost>
<VirtualHost 172.20.30.50:8080>
DocumentRoot /www/example2-8080
ServerName www.example.org
</VirtualHost>
</highlight>
</section>
<section id="mixed"><title>H�bergements virtuels mixtes bas� sur
les noms et sur IP</title>
<p>Toute adresse indiqu�e comme argument d'une section VirtualHost
et n'apparaissant dans aucun autre serveur virtuel, fait de cette
section un serveur virtuel s�lectionnable uniquement en fonction de
son adresse IP.</p>
<highlight language="config">
Listen 80
<VirtualHost 172.20.30.40>
ServerName www.example.com
</VirtualHost>
<VirtualHost 172.20.30.40>
ServerName www.example.org
</VirtualHost>
<VirtualHost 172.20.30.40>
ServerName www.example.net
</VirtualHost>
# IP-based
<VirtualHost 172.20.30.50>
ServerName www.example.edu
</VirtualHost>
<VirtualHost 172.20.30.60>
ServerName www.example.gov
</VirtualHost>
</highlight>
</section>
<section id="proxy"><title>Utilisation simultan�e de
<code>Virtual_host</code> et de mod_proxy</title>
<p>L'exemple suivant montre comment une machine peut mandater
un serveur virtuel fonctionnant sur le serveur d'une autre machine.
Dans cet exemple, un serveur virtuel de m�me nom est configur� sur
une machine � l'adresse <code>192.168.111.2</code>. La directive
<directive module="mod_proxy"
name="ProxyPreserveHost">ProxyPreserveHost On</directive> est
employ�e pour permette au nom de domaine d'�tre pr�serv� lors du
transfert, au cas o� plusieurs noms de domaines cohabitent sur
une m�me machine.</p>
<highlight language="config">
<VirtualHost *:*>
ProxyPreserveHost On
ProxyPass / http://192.168.111.2/
ProxyPassReverse / http://192.168.111.2/
ServerName hostname.example.com
</VirtualHost>
</highlight>
</section>
<section id="default"><title>Utilisation de serveurs virtuels
<code>_default_</code></title>
<section id="defaultallports"><title>Serveurs virtuels
<code>_default_</code> pour tous les ports</title>
<p>Exemple de capture de <em>toutes</em> les requ�tes �manant
d'adresses IP ou de ports non connus, <em>c'est-�-dire</em>, d'un
<highlight language="config">
<VirtualHost _default_:*>
</VirtualHost>
</highlight>
<p>L'utilisation d'un tel serveur virtuel avec un joker pour le
port emp�che de mani�re efficace qu'une requ�te n'atteigne le
serveur principal.</p>
<p>Un serveur virtuel par d�faut ne servira jamais une requ�te
serveur virtuel par nom. Si la requ�te contient un en-t�te
<code>Host:</code> inconnu, ou si celui-ci est absent, elle
sera toujours servie par le serveur virtuel primaire par nom
dans le fichier de configuration).</p>
<p>Vous pouvez utiliser une directive
<directive module="mod_alias">AliasMatch</directive> ou
<directive module="mod_rewrite">RewriteRule</directive> afin de
r��crire une requ�te pour une unique page d'information (ou pour
un script).</p>
</section>
<section id="defaultdifferentports"><title>Serveurs virtuels
<code>_default_</code> pour des ports diff�rents</title>
<p>La configuration est similaire � l'exemple pr�c�dent, mais
le serveur �coute sur plusieurs ports et un second serveur virtuel
<code>_default_</code> pour le port 80 est ajout�.</p>
<highlight language="config">
<VirtualHost _default_:80>
# ...
</VirtualHost>
<VirtualHost _default_:*>
# ...
</VirtualHost>
</highlight>
<p>Le serveur virtuel par d�faut d�fini pour le port 80 (il doit
imp�rativement �tre plac� avant un autre serveur virtuel par
d�faut traitant tous les ports gr�ce au joker *) capture toutes
les requ�tes envoy�es sur une adresse IP non sp�cifi�e. Le
serveur principal n'est jamais utilis� pour servir une requ�te.</p>
</section>
<section id="defaultoneport"><title>Serveurs virtuels
<code>_default_</code> pour un seul port</title>
<p>Nous voulons cr�er un serveur virtuel par d�faut seulement
pour le port 80.</p>
<highlight language="config">
<VirtualHost _default_:80>
...
</VirtualHost>
</highlight>
<p>Une requ�te vers une adresse non sp�cifi�e sur le port 80
sera servie par le serveur virtuel par d�faut, et toute autre
requ�te vers une adresse et un port non sp�cifi�s sera servie
par le serveur principal.</p>
<p>L'utilisation du caract�re g�n�rique <code>*</code> dans la
d�claration d'un serveur virtuel l'emporte sur
<code>_default_</code>.</p>
</section>
</section>
<section id="migrate"><title>Migration d'un serveur virtuel
par nom en un serveur virtuel par IP</title>
<p>Le serveur virtuel par nom avec le nom de domaine
par nom</a>) devrait obtenir sa propre adresse IP. Pendant la
phase de migration, il est possible d'�viter les probl�mes avec
les noms de serveurs et autres serveurs mandataires qui m�morisent
les vielles adresses IP pour les serveurs virtuels par nom.<br />
La solution est simple, car il suffit d'ajouter la nouvelle
adresse IP (<code>172.20.30.50</code>) dans la directive
<code>VirtualHost</code>.</p>
<highlight language="config">
Listen 80
ServerName www.example.com
<VirtualHost 172.20.30.40 172.20.30.50>
ServerName www.example.org
# ...
</VirtualHost>
<VirtualHost 172.20.30.40>
ServerName www.example.net
ServerAlias *.example.net
# ...
</VirtualHost>
</highlight>
<p>Le serveur virtuel peut maintenant �tre joint par la nouvelle
adresse (comme un serveur virtuel par IP) et par l'ancienne
adresse (comme un serveur virtuel par nom).</p>
</section>
<section id="serverpath"><title>Utilisation de la directive
<code>ServerPath</code></title>
<p>Dans le cas o� vous disposez de deux serveurs virtuels par nom,
le client doit transmettre un en-t�te <code>Host:</code> correct
n'envoient pas un tel en-t�te et Apache n'a aucun indice pour
conna�tre le serveur virtuel devant �tre joint (il sert la
requ�te � partir d'un serveur virtuel primaire). Dans un soucis
de pr�server la compatibilit� descendante, il suffit de cr�er
un serveur virtuel primaire charg� de retourner une page contenant
des liens dont les URLs auront un pr�fixe identifiant les serveurs
virtuels par nom.</p>
<highlight language="config">
<VirtualHost 172.20.30.40>
# serveur virtuel primaire
RewriteEngine On
# ...
</VirtualHost>
<VirtualHost 172.20.30.40>
ServerName www.sub1.domain.tld
ServerPath /sub1/
RewriteEngine On
# ...
</VirtualHost>
<VirtualHost 172.20.30.40>
ServerName www.sub2.domain.tld
ServerPath /sub2/
RewriteEngine On
# ...
</VirtualHost>
</highlight>
<p>� cause de la directive
<directive module="core">ServerPath</directive>, une requ�te sur
<em>toujours</em> servie par le serveur sub1-vhost.<br />
servie par le serveur sub1-vhost que si le client envoie un en-t�te
<code>Host:</code> correct. Si aucun en-t�te <code>Host:</code>
n'est transmis, le serveur primaire sera utilis�.</p>
<p>Notez qu'il y a une singularit� : une requ�te sur
par le serveur sub1-vhost si le client n'envoie pas d'en-t�te
<code>Host:</code>.</p>
<p>Les directives <directive module="mod_rewrite">RewriteRule</directive>
sont employ�es pour s'assurer que le client qui envoie un en-t�te
<code>Host:</code> correct puisse utiliser d'autres variantes d'URLs,
<em>c'est-�-dire</em> avec ou sans pr�fixe d'URL.</p>
</section>
</manualpage>