NameVirtualHost indique au serveur Web Apache sur quelle adresse IP et, le cas échéant, sur quel port écouter les requêtes des clients contenant le nom de domaine dans l'en-tête HTTP.

Le premier argument peut être un nom de domaine complet, mais il est recommandé d'utiliser l'adresse IP. Le second argument est le port et il est facultatif. Par défaut, le port 80 est utilisé et configuré via la directive Listen (Sélection du périphérique réseau).

Il est possible d'utiliser le joker * pour l'adresse IP et le numéro du port pour recevoir des requêtes sur toutes les interfaces. Les adresses IPv6 doivent être placées entre crochets.

# NameVirtualHost IP-address[:Port]
NameVirtualHost 192.168.1.100:80
NameVirtualHost 192.168.1.100
NameVirtualHost *:80
NameVirtualHost *
NameVirtualHost [2002:c0a8:164::]:80
                

Les blocs <VirtualHost></VirtualHost> contiennent les informations qui s'appliquent à un domaine particulier. Lorsque Apache reçoit une requête d'un client pour un VirtualHost défini, il utilise les directives contenues dans cette section. Toute directive Apache autorisée dans le contexte VirtualHost est utilisable ici. La balise VirtualHost d'ouverture prend les arguments suivants dans une configuration d'hôte virtuel à base de nom :

Le joker * est également autorisé comme substitut de l'adresse IP. Cette syntaxe n'est valable que combinée à l'utilisation de jokers dans NameVirtualHost * . Lorsque vous utilisez des adresses IPv6, elles doivent être placées entre crochets.

<VirtualHost 192.168.1.100:80>
    ServerName www.example.com
    DocumentRoot /srv/www/htdocs/example.com
    ServerAdmin webmaster@example.com
    ErrorLog /var/log/apache2/www.example.com-error_log
    CustomLog /var/log/apache2/www.example.com-access_log common
</VirtualHost>

<VirtualHost 192.168.1.100:80>
    ServerName www.example.net
    DocumentRoot /srv/www/htdocs/example.net
    ServerAdmin webmaster@example.net
    ErrorLog /var/log/apache2/www.example.net-error_log
    CustomLog /var/log/apache2/www.example.net-access_log common
</VirtualHost>

<VirtualHost [2002:c0a8:164::]>
    # 2002:c0a8:164:: is the IPv6 equivalent to 192.168.1.100
    ServerName www.example.org
    DocumentRoot /srv/www/htdocs/example.org
    ServerAdmin webmaster@example.org
    ErrorLog /var/log/apache2/www.example.org-error_log
    CustomLog /var/log/apache2/www.example.org-access_log common
</VirtualHost>
                

Dans cet exemple, les domaines www.example.com et www.example.net sont hébergés sur la machine ayant l'adresse IP 192.168.1.100. Le premier VirtualHost est celui par défaut pour toutes les requêtes entrantes vers le serveur Web.

Les directives ErrorLog (décrites dans Section 46.3.2.3.4, « ErrorLog fichier | "|commande"  ») et CustomLog (voir http://httpd.apache.org/docs-2.0/mod/mod_log_config.html#customlog) n'ont pas besoin de contenir le nom de domaine. Vous pouvez utiliser ici le nom de votre choix.

Pour qu'Apache héberge plusieurs adresses IP, la machine physique doit accepter les requêtes pour plusieurs IP. C'est ce que l'on nomme l'hébergement multi-IP. De plus, la gestion d'alias IP doit être activée dans le kernel. C'est le paramètre par défaut dans SUSE Linux.

Lorsque le kernel a été configuré pour la gestion d'alias IP, les commandes ifconfig et route peuvent être utilisées pour définir des IP supplémentaires sur l'hôte. Ces commandes doivent être exécutées par un utilisateur root.

Pour l'exemple suivant, on suppose que l'hôte a déjà l'adresse IP 192.168.0.10 attribuée au périphérique réseau eth0. Entrez la commande ifconfig pour afficher l'adresse IP de l'hôte. Il est possible d'ajouter d'autres adresses IP avec les commandes suivantes :

ip addr add 192.168.0.20/24 dev eth0
ip addr add 192.168.0.30/24 dev eth0

Toutes ces adresses IP sont attribuées au même périphérique réseau physique (eth0).

Une fois que la gestion d'alias IP a été configuré sur le système (ou que l'hôte a été équipé de plusieurs cartes réseau), Apache peut être configuré. Un bloc VirtualHost séparé est nécessaire pour chaque serveur virtuel.

L'exemple suivant montre Apache exécuté sur une machine ayant l'adresse IP 192.168.1.10, hébergeant deux domaines sur les adresses IP supplémentaires 192.168.0.20 et 192.168.0.30. Cet exemple particulier ne fonctionne que sur un réseau privé. En effet, les adresses IP de 192.168.0.0 à 192.168.0.255 ne sont pas routées vers Internet.

<VirtualHost 192.168.0.20>
   ServerName www.example.com 
   DocumentRoot /srv/www/htdocs/example.com 
   ServerAdmin webmaster@example.com 
   ErrorLog /var/log/apache2/www.example.com-error_log 
   CustomLog /var/log/apache2/www.example.com-access_log common
</VirtualHost>

<VirtualHost 192.168.0.30> 
   ServerName www.example.net 
   DocumentRoot /srv/www/htdocs/example.net 
   ServerAdmin tux@example.net 
   ErrorLog /var/log/apache2/www.example.net-error_log 
   CustomLog /var/log/apache2/www.example.net-access_log common
</VirtualHost> 

Les directives VirtualHost ne sont ici spécifiées que pour les interfaces différentes de 192.168.0.10. Lorsqu'une directive Listen (décrite dans Sélection du périphérique réseau) est également configurée pour 192.168.0.10, un hôte virtuel à base d'adresse IP séparé doit être créé pour répondre aux requêtes HTTP vers cette interface. Sinon, les directives de la section Main Server de /etc/apache2/httpd.conf (voir Section 46.3.2.3, « Directives Apache dans /etc/apache2/httpd.conf: Serveur principal  ») sont appliquées.