1 <?xml version='1.0' encoding='ISO-8859-1' ?>
2 <!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
3 <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
4 <!-- English Revision: 1132802:1330878 (outdated) -->
5 <!-- French translation by Vincent Deffontaines, Alain B., review by -->
6 <!-- updated by Lucien Gentis -->
9 Licensed to the Apache Software Foundation (ASF) under one or more
10 contributor license agreements. See the NOTICE file distributed with
11 this work for additional information regarding copyright ownership.
12 The ASF licenses this file to You under the Apache License, Version 2.0
13 (the "License"); you may not use this file except in compliance with
14 the License. You may obtain a copy of the License at
16 http://www.apache.org/licenses/LICENSE-2.0
18 Unless required by applicable law or agreed to in writing, software
19 distributed under the License is distributed on an "AS IS" BASIS,
20 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
21 See the License for the specific language governing permissions and
22 limitations under the License.
25 <manualpage metafile="examples.xml.meta">
26 <parentdocument href="./">Serveurs virtuels</parentdocument>
27 <title>Exemples d'utilisations de VirtualHost</title>
31 <p>Le but de ce document est d'essayer de répondre aux questions
32 les plus répandues sur la configuration des <a href="index.html">serveurs virtuels</a>.
33 Les scénarios présentés ici se rencontrent quand plusieurs
34 serveurs Webs doivent tourner sur une seule et même machine au
35 moyen de serveurs virtuels <a href="name-based.html">par nom</a>
36 ou <a href="ip-based.html">par IP</a>.</p>
40 <section id="purename"><title>Fonctionnement de plusieurs serveurs
41 virtuels par nom sur une seule adresse IP.</title>
43 <p>Votre serveur ne dispose que d'une seule adresse IP, et de
44 nombreux alias (CNAMES) pointent vers cette adresse dans le DNS.
45 Pour l'exemple, <code>www.example.com</code> et
46 <code>www.example.org</code> doivent tourner sur cette machine.</p>
48 <note><title>Note :</title><p>La configuration de serveurs virtuels
49 sous Apache ne provoque pas leur apparition magique dans la
50 configuration du DNS. Il <em>faut</em> que leurs noms soient
51 définis dans le DNS, et qu'ils y soient résolus sur l'adresse IP
52 du serveur, faute de quoi personne ne pourra visiter votre site Web.
53 Il est possible d'ajouter des entrées dans le fichier
54 <code>hosts</code> pour tests locaux, mais qui ne fonctionneront
55 que sur la machine possédant ces entrées.</p>
59 <title>Configuration du serveur</title>
61 # Apache doit écouter sur le port 80<br />
65 <VirtualHost *:80><br />
67 DocumentRoot /www/example.com<br />
68 ServerName www.example1.com<br />
70 # Autres directives ici<br />
73 </VirtualHost><br />
75 <VirtualHost *:80><br />
77 DocumentRoot /www/example.org<br />
78 ServerName www.example2.org<br />
80 # Autres directives ici<br />
86 <p>Les astérisques correspondent à toutes les adresses, si bien que
87 le serveur principal ne répondra jamais à aucune requête. Comme le
89 <code>ServerName www.example.com</code> se trouve en premier dans le fichier
90 de configuration, il a la plus grande priorité et peut être vu
91 comme serveur <cite>par défaut</cite> ou <cite>primaire</cite> ;
92 ce qui signifie que toute requête reçue ne correspondant à aucune
93 des directives <code>ServerName</code> sera servie par ce premier
94 <code>VirtualHost</code>.</p>
97 <title>Note :</title>
99 <p>Vous pouvez remplacer <code>*</code>
100 par l'adresse IP du système si vous ne souhaitez pas faire
101 opérer la sélection du serveur virtuel en fonction de la
102 paire adresse IP/port.</p>
104 <p>En général, il est commode d'utiliser <code>*</code> sur
105 les systèmes dont l'adresse IP n'est pas constante - par
106 exemple, pour des serveurs dont l'adresse IP est attribuée
107 dynamiquement par le FAI, et où le DNS est géré au moyen
108 d'un DNS dynamique quelconque. Comme <code>*</code> signifie
109 <cite>n'importe quelle adresse</cite>, cette configuration
110 fonctionne sans devoir être modifiée quand l'adresse IP du
111 système est modifiée.</p>
114 <p>La configuration ci-dessus est en pratique utilisée dans la
115 plupart des cas pour les serveurs virtuels par nom. En fait, le
116 seul cas où cette configuration ne fonctionne pas est lorsque
117 différents contenus doivent être servis en fonction de l'adresse IP
118 et du port contactés par le client.</p>
122 <section id="twoips"><title>Serveurs virtuels par nom sur plus
123 d'une seule adresse IP.</title>
126 <title>Note :</title><p>Toutes les techniques présentées ici
127 peuvent être étendues à un plus grand nombre d'adresses IP.</p>
130 <p>Le serveur a deux adresses IP. Sur l'une
131 (<code>172.20.30.40</code>), le serveur "principal"
132 <code>server.example.com</code> doit répondre, et sur l'autre
133 (<code>172.20.30.50</code>), deux serveurs virtuels (ou plus)
137 <title>Configuration du serveur</title>
141 # Serveur "principal" sur 172.20.30.40<br />
142 ServerName server.example.com<br />
143 DocumentRoot /www/mainserver<br />
145 <VirtualHost 172.20.30.50><br />
147 DocumentRoot /www/example.com<br />
148 ServerName www.example.com<br />
150 # D'autres directives ici ...<br />
153 </VirtualHost><br />
155 <VirtualHost 172.20.30.50><br />
157 DocumentRoot /www/example.org<br />
158 ServerName www.example.org<br />
160 # D'autres directives ici ...<br />
166 <p>Toute requête arrivant sur une autre adresse que
167 <code>172.20.30.50</code> sera servie par le serveur principal.
168 Les requêtes vers <code>172.20.30.50</code> avec un nom de serveur
169 inconnu, ou sans en-tête <code>Host:</code>, seront servies par
170 <code>www.example.com</code>.</p>
174 <section id="intraextra"><title>Servir le même contenu sur des
175 adresses IP différentes (telle qu'une adresse interne et une
178 <p>La machine serveur dispose de deux adresses IP
179 (<code>192.168.1.1</code> et <code>172.20.30.40</code>). Cette
180 machine est placée à la fois sur le réseau interne (l'Intranet)
181 et le réseau externe (Internet). Sur Internet, le nom
182 <code>server.example.com</code> pointe vers l'adresse externe
183 (<code>172.20.30.40</code>), mais sur le réseau interne, ce même
184 nom pointe vers l'adresse interne (<code>192.168.1.1</code>).</p>
186 <p>Le serveur peut être configuré pour répondre de la même manière
187 aux requêtes internes et externes, au moyen d'une seule section
188 <code>VirtualHost</code>.</p>
191 <title>Configuration du serveur</title>
194 <VirtualHost 192.168.1.1 172.20.30.40><br />
196 DocumentRoot /www/server1<br />
197 ServerName server.example.com<br />
198 ServerAlias server<br />
203 <p>Ainsi, les requêtes en provenance de chacun des deux réseaux
204 seront servies par le même <code>VirtualHost</code>.</p>
207 <title>Note :</title><p>Sur le réseau interne, il est possible
208 d'utiliser le nom raccourci <code>server</code> au lieu du nom
209 complet <code>server.example.com</code>.</p>
211 <p>Notez également que dans l'exemple précédent, vous pouvez
212 remplacer la liste des adresses IP par des <code>*</code> afin
213 que le serveur réponde de la même manière sur toutes ses
219 <section id="port"><title>Servir différents sites sur différents
222 <p>Vous disposez de plusieurs domaines pointant sur la même adresse
223 IP et vous voulez également servir de multiples ports. L'exemple
224 suivant montre que la sélection en fonction du nom intervient après
225 la sélection de la meilleure correspondance du point de vue adresse
229 <title>Configuration du serveur</title>
234 <VirtualHost 172.20.30.40:80><br />
236 ServerName www.example.com<br />
237 DocumentRoot /www/domain-80<br />
239 </VirtualHost><br />
241 <VirtualHost 172.20.30.40:8080><br />
243 ServerName www.example.com<br />
244 DocumentRoot /www/domain-8080<br />
246 </VirtualHost><br />
248 <VirtualHost 172.20.30.40:80><br />
250 ServerName www.example.org<br />
251 DocumentRoot /www/otherdomain-80<br />
253 </VirtualHost><br />
255 <VirtualHost 172.20.30.40:8080><br />
257 ServerName www.example.org<br />
258 DocumentRoot /www/otherdomain-8080<br />
265 <section id="ip"><title>Hébergement virtuel basé sur IP</title>
267 <p>Le serveur dispose de deux adresses IP (<code>172.20.30.40</code>
268 et <code>172.20.30.50</code>) correspondant respectivement aux noms
269 <code>www.example.com</code> et <code>www.example.org</code>.</p>
272 <title>Configuration du serveur</title>
276 <VirtualHost 172.20.30.40><br />
278 DocumentRoot /www/example.com<br />
279 ServerName www.example1.com<br />
281 </VirtualHost><br />
283 <VirtualHost 172.20.30.50><br />
285 DocumentRoot /www/example.org<br />
286 ServerName www.example2.org<br />
291 <p>Les requêtes provenant d'adresses non spécifiées dans l'une des
292 directives <code><VirtualHost></code> (comme pour
293 <code>localhost</code> par exemple) seront dirigées vers le serveur
294 principal, s'il en existe un.</p>
298 <section id="ipport"><title>Hébergements virtuels mixtes basés sur
299 les ports et sur les IP</title>
301 <p>Le serveur dispose de deux adresses IP (<code>172.20.30.40</code>
302 et <code>172.20.30.50</code>) correspondant respectivement aux noms
303 <code>www.example.com</code> et <code>www.example.org</code>.
304 Pour chacun d'eux, nous voulons un hébergement sur les ports 80
308 <title>Configuration du serveur</title>
310 Listen 172.20.30.40:80<br />
311 Listen 172.20.30.40:8080<br />
312 Listen 172.20.30.50:80<br />
313 Listen 172.20.30.50:8080<br />
315 <VirtualHost 172.20.30.40:80><br />
317 DocumentRoot /www/example.com-80<br />
318 ServerName www.example.com<br />
320 </VirtualHost><br />
322 <VirtualHost 172.20.30.40:8080><br />
324 DocumentRoot /www/example.com-8080<br />
325 ServerName www.example.com<br />
327 </VirtualHost><br />
329 <VirtualHost 172.20.30.50:80><br />
331 DocumentRoot /www/example.org-80<br />
332 ServerName www.example.org<br />
334 </VirtualHost><br />
336 <VirtualHost 172.20.30.50:8080><br />
338 DocumentRoot /www/example.org-8080<br />
339 ServerName www.example.org<br />
346 <section id="mixed"><title>Hébergements virtuels mixtes basé sur
347 les noms et sur IP</title>
349 <p>Toute adresse indiquée comme argument d'une section VirtualHost
350 et n'apparaissant dans aucun autre serveur virtuel, fait de cette
351 section un serveur virtuel sélectionnable uniquement en fonction de
355 <title>Configuration du serveur</title>
358 <VirtualHost 172.20.30.40><br />
360 DocumentRoot /www/example1<br />
361 ServerName www.example.com<br />
363 </VirtualHost><br />
365 <VirtualHost 172.20.30.40><br />
367 DocumentRoot /www/example2<br />
368 ServerName www.example.org<br />
370 </VirtualHost><br />
372 <VirtualHost 172.20.30.40><br />
374 DocumentRoot /www/example3<br />
375 ServerName www.example.net<br />
377 </VirtualHost><br />
380 <VirtualHost 172.20.30.50><br />
382 DocumentRoot /www/example4<br />
383 ServerName www.example.edu<br />
385 </VirtualHost><br />
387 <VirtualHost 172.20.30.60><br />
389 DocumentRoot /www/example5<br />
390 ServerName www.example.gov<br />
397 <section id="proxy"><title>Utilisation simultanée de
398 <code>Virtual_host</code> et de mod_proxy</title>
400 <p>L'exemple suivant montre comment une machine peut mandater
401 un serveur virtuel fonctionnant sur le serveur d'une autre machine.
402 Dans cet exemple, un serveur virtuel de même nom est configuré sur
403 une machine à l'adresse <code>192.168.111.2</code>. La directive
404 <directive module="mod_proxy">ProxyPreserveHost On</directive> est
405 employée pour permette au nom de domaine d'être préservé lors du
406 transfert, au cas où plusieurs noms de domaines cohabitent sur
407 une même machine.</p>
410 <VirtualHost *:*><br />
411 ProxyPreserveHost On<br />
412 ProxyPass / http://192.168.111.2<br />
413 ProxyPassReverse / http://192.168.111.2/<br />
414 ServerName hostname.example.com<br />
420 <section id="default"><title>Utilisation de serveurs virtuels
421 <code>_default_</code></title>
423 <section id="defaultallports"><title>Serveurs virtuels
424 <code>_default_</code> pour tous les ports</title>
426 <p>Exemple de capture de <em>toutes</em> les requêtes émanant
427 d'adresses IP ou de ports non connus, <em>c'est-à-dire</em>, d'un
428 couple adresse/port non traité par aucun autre serveur virtuel.</p>
431 <title>Configuration du serveur</title>
433 <VirtualHost _default_:*><br />
435 DocumentRoot /www/default<br />
440 <p>L'utilisation d'un tel serveur virtuel avec un joker pour le
441 port empêche de manière efficace qu'une requête n'atteigne le
442 serveur principal.</p>
444 <p>Un serveur virtuel par défaut ne servira jamais une requête
445 qui est envoyée vers un couple adresse/port utilisée par un
446 serveur virtuel par nom. Si la requête contient un en-tête
447 <code>Host:</code> inconnu, ou si celui-ci est absent, elle
448 sera toujours servie par le serveur virtuel primaire par nom
449 (celui correspondant à ce couple adresse/port trouvé en premier
450 dans le fichier de configuration).</p>
452 <p>Vous pouvez utiliser une directive
453 <directive module="mod_alias">AliasMatch</directive> ou
454 <directive module="mod_rewrite">RewriteRule</directive> afin de
455 réécrire une requête pour une unique page d'information (ou pour
459 <section id="defaultdifferentports"><title>Serveurs virtuels
460 <code>_default_</code> pour des ports différents</title>
462 <p>La configuration est similaire à l'exemple précédent, mais
463 le serveur écoute sur plusieurs ports et un second serveur virtuel
464 <code>_default_</code> pour le port 80 est ajouté.</p>
467 <title>Configuration du serveur</title>
469 <VirtualHost _default_:80><br />
471 DocumentRoot /www/default80<br />
474 </VirtualHost><br />
476 <VirtualHost _default_:*><br />
478 DocumentRoot /www/default<br />
484 <p>Le serveur virtuel par défaut défini pour le port 80 (il doit
485 impérativement être placé avant un autre serveur virtuel par
486 défaut traitant tous les ports grâce au joker *) capture toutes
487 les requêtes envoyées sur une adresse IP non spécifiée. Le
488 serveur principal n'est jamais utilisé pour servir une requête.</p>
491 <section id="defaultoneport"><title>Serveurs virtuels
492 <code>_default_</code> pour un seul port</title>
494 <p>Nous voulons créer un serveur virtuel par défaut seulement
498 <title>Configuration du serveur</title>
500 <VirtualHost _default_:80><br />
501 DocumentRoot /www/default<br />
506 <p>Une requête vers une adresse non spécifiée sur le port 80
507 sera servie par le serveur virtuel par défaut, et toute autre
508 requête vers une adresse et un port non spécifiés sera servie
509 par le serveur principal.</p>
511 <p>L'utilisation du caractère générique <code>*</code> dans la
512 déclaration d'un serveur virtuel l'emporte sur
513 <code>_default_</code>.</p>
518 <section id="migrate"><title>Migration d'un serveur virtuel
519 par nom en un serveur virtuel par IP</title>
521 <p>Le serveur virtuel par nom avec le nom de domaine
522 <code>www.example.org</code> (de notre <a href="#name">exemple
523 par nom</a>) devrait obtenir sa propre adresse IP. Pendant la
524 phase de migration, il est possible d'éviter les problèmes avec
525 les noms de serveurs et autres serveurs mandataires qui mémorisent
526 les vielles adresses IP pour les serveurs virtuels par nom.<br />
527 La solution est simple, car il suffit d'ajouter la nouvelle
528 adresse IP (<code>172.20.30.50</code>) dans la directive
529 <code>VirtualHost</code>.</p>
532 <title>Configuration du serveur</title>
535 ServerName www.example.com<br />
536 DocumentRoot /www/example.com<br />
538 <VirtualHost 172.20.30.40 172.20.30.50><br />
540 DocumentRoot /www/example.org<br />
541 ServerName www.example.org<br />
544 </VirtualHost><br />
546 <VirtualHost 172.20.30.40><br />
548 DocumentRoot /www/example.net<br />
549 ServerName www.example.net<br />
550 ServerAlias *.example.net<br />
556 <p>Le serveur virtuel peut maintenant être joint par la nouvelle
557 adresse (comme un serveur virtuel par IP) et par l'ancienne
558 adresse (comme un serveur virtuel par nom).</p>
562 <section id="serverpath"><title>Utilisation de la directive
563 <code>ServerPath</code></title>
565 <p>Dans le cas où vous disposez de deux serveurs virtuels par nom,
566 le client doit transmettre un en-tête <code>Host:</code> correct
567 pour déterminer le serveur concerné. Les vieux clients HTTP/1.0
568 n'envoient pas un tel en-tête et Apache n'a aucun indice pour
569 connaître le serveur virtuel devant être joint (il sert la
570 requête à partir d'un serveur virtuel primaire). Dans un soucis
571 de préserver la compatibilité descendante, il suffit de créer
572 un serveur virtuel primaire chargé de retourner une page contenant
573 des liens dont les URLs auront un préfixe identifiant les serveurs
574 virtuels par nom.</p>
577 <title>Configuration du serveur</title>
579 <VirtualHost 172.20.30.40><br />
581 # Serveur virtuel primaire<br />
582 DocumentRoot /www/subdomain<br />
583 RewriteEngine On<br />
584 RewriteRule . /www/subdomain/index.html<br />
587 </VirtualHost><br />
589 <VirtualHost 172.20.30.40><br />
590 DocumentRoot /www/subdomain/sub1<br />
592 ServerName www.sub1.domain.tld<br />
593 ServerPath /sub1/<br />
594 RewriteEngine On<br />
595 RewriteRule ^(/sub1/.*) /www/subdomain$1<br />
598 </VirtualHost><br />
600 <VirtualHost 172.20.30.40><br />
602 DocumentRoot /www/subdomain/sub2<br />
603 ServerName www.sub2.domain.tld<br />
604 ServerPath /sub2/<br />
605 RewriteEngine On<br />
606 RewriteRule ^(/sub2/.*) /www/subdomain$1<br />
612 <p>À cause de la directive
613 <directive module="core">ServerPath</directive>, une requête sur
614 une URL <code>http://www.sub1.domain.tld/sub1/</code> est
615 <em>toujours</em> servie par le serveur sub1-vhost.<br />
616 Une requête sur une URL <code>http://www.sub1.domain.tld/</code> n'est
617 servie par le serveur sub1-vhost que si le client envoie un en-tête
618 <code>Host:</code> correct. Si aucun en-tête <code>Host:</code>
619 n'est transmis, le serveur primaire sera utilisé.</p>
620 <p>Notez qu'il y a une singularité : une requête sur
621 <code>http://www.sub2.domain.tld/sub1/</code> est également servie
622 par le serveur sub1-vhost si le client n'envoie pas d'en-tête
623 <code>Host:</code>.</p>
624 <p>Les directives <directive module="mod_rewrite">RewriteRule</directive>
625 sont employées pour s'assurer que le client qui envoie un en-tête
626 <code>Host:</code> correct puisse utiliser d'autres variantes d'URLs,
627 <em>c'est-à-dire</em> avec ou sans préfixe d'URL.</p>