NameVirtualHost dice al server Web Apache su quale indirizzo IP e, a scelta, quale porta ascoltare per le richieste da parte di client contenenti il nome di dominio nell'intestazione HTTP.

Il primo argomento può essere un nome di dominio completo, ma si consiglia di utilizzare l'indirizzo IP. Il secondo argomento è la porta ed è facoltativo. Come impostazione predefinita, viene utilizzata la porta 80 che è configurata tramite la direttivaAscolto (Selezione dispositivo di rete).

Il carattere jolly * può essere utilizzato sia per l'indirizzo IP, sia per il numero della porta per ricevere le richieste su tutte le interfacce. Gli indirizzi IPv6 devono essere racchiusi tra parentesi quadre.

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

Il blocco <VirtualHost></VirtualHost> contiene le informazioni da applicare a un particolare dominio. Quando Apache riceve una richiesta da un client per un VirtualHost definito, utilizza le direttive allegate a questa sezione. È possibile utilizzare qualsiasi direttiva Apache consentita nel contesto VirtualHost. Il tag di apertura VirtualHost, nella configurazione di un host virtuale basato sul nome, prende i seguenti argomenti:

Il carattere jolly * è ammesso anche come sostituto dell'indirizzo IP. Questa sintassi è valida solo in combinazione con l'utilizzo del carattere jolly in NameVirtualHost * . Quando si utilizzano gli indirizzi IPv6, l'indirizzo deve essere racchiuso tra parentesi quadre.

<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.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:: è l''indirizzo IPv6 equivalente a 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>
                

In questo esempio, i domini www.example.com e www.example.net sono ospitati sulla macchina con l'indirizzo IP 192.168.1.100. Il primoVirtualHost è predefinito per tutte le richieste in entrata al server Web.

Le direttive ErrorLog (descritta inSezione 46.3.2.3.4, «ErrorLog file | "|command" ») e CustomLog (vedere http://httpd.apache.org/docs-2.0/mod/mod_log_config.html#customlog) non devono contenere il nome di dominio. Qui utilizzare un nome a scelta.

Affinché Apache possa supportare l'hosting di più IP, la macchina fisica deve accettare richieste da più IP. Questo stato di fatto si chiama hosting multi-IP. Inoltre, l'IP aliasing deve essere attivato nel kernel. Questa è un'impostazione predefinita in SUSE Linux.

Una volta configurato il kernel per l'IP aliasing, pssono essere utilizzati i comandi ifconfig e route per configurare altri IP sull'host. Questi comandi devono essere eseguiti come utente root.

Nell'esempio seguente si presume che l'host abbia già l'IP 192.168.0.10 assegnato per il dispositivo di rete eth0. Digitare il comando ifconfig per visualizzare l'IP dell'host. Con i seguenti comandi possono essere aggiunti ulteriori indirizzi IP:

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

Tutti questi indirizzi IP sono assegnati allo stesso dispositivo di rete fisico (eth0).

Una volta configurato l'IP aliasing sul sistema (oppure l'host è stato dotato di più schede di rete), Apache può essere configurato. Per ogni server virtuale è necessario un blocco VirtualHost separato.

L'esempio seguente mostra Apache in esecuzione su una macchina con l'IP 192.168.1.10, che ospita due domini sugli IP aggiuntivi 192.168.0.20 e 192.168.0.30. Quest esempio specifico funziona solo su una rete privata, poiché gli IP che vanno da 192.168.0.0 a 192.168.0.255 non vengono instradati sulla rete Internet pubblica.

<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>
                

In questo esempio, le direttive VirtualHost sono specificate solo per le interfacce, anziché con 192.168.0.10. Quando una direttiva Listen (descritta in Selezione dispositivo di rete) viene configurata anche per l'indirizzo 192.168.0.10, deve essere creato un host vituale basato su IP per rispondere alle richieste HTTP effettuate a quella interfaccia oppure vengono applicate le direttive trovate nella sezione Main Server del file /etc/apache2/httpd.conf (vedere la Sezione 46.3.2.3, «Direttive di Apache in /etc/apache2/httpd.conf: Server principale »).