Virtuelle Hosts auf Apache2 Webserver einrichten [prontosystems.org]

Diese Seite ist nicht editierbar. Sie können den Quelltext sehen, jedoch nicht verändern. Kontaktieren Sie den Administrator, wenn Sie glauben, dass hier ein Fehler vorliegt.
[[:tux|{{ :linux.png?40|}}]]
===== vhosts auf Apache2 Webserver einrichten (Debian) =====

Wenn Sie auf einem Server mehr als eine Webseite betreiben möchten, bietet die virtuelle Hostkonfiguration((http://httpd.apache.org/docs/2.1/de/vhosts/)) zwei Möglichkeiten an. Virtuelle Hosts können <fc #008000>»IP-basiert«</fc> sein, was bedeutet, dass jedes Webangebot eine andere IP besitzt, oder <fc #008000>»Namens-basiert«</fc>, was bedeutet, dass unter jeder IP-Adresse mehrere Namen laufen. Das folgende Tutorial beschränkt sich auf die Names-basierte Variante unter der Verwendung von Subdomains einer bestehenden Domain, es ist jedoch im Prinzip jeder FQDN((http://www.prontosystems.org/tux:apache_vhost)) anwendbar. Die Verwendung von namensbasierten virtuellen Hosts ist gewöhnlich einfacher. Sie müssen lediglich Ihren DNS-Server darauf einstellen, jeden Hostnamen auf die richtige IP-Adresse abzubilden, und dann den Apache HTTP Server so konfigurieren, dass er die verschiedenen Hostnamen erkennt. Man kann aber auch eine Testumgebung ohne vorhandenen DNS A-Record betrieben, dazu steht mehr beim Testen der Konfiguration. Namensbasierte virtuelle Hosts entschärfen auch den Bedarf an knappen IP-Adressen. Daher sollten Sie namensbasierte virtuelle Hosts verwenden, sofern kein besonderer Grund dafür existiert, IP-basierte virtuelle Hosts zu wählen. 

**Note:** Die Apache Konfiguration wie zB der Speicherort der Document Roots, LogFiles etc können möglicherweise von Ihrer abweichen, da ich mich nicht in dem Apache Standard Document Root <fc #008000>/var/www</fc> aufhalte. 

=== Apache Installation ===

Die Installation des Apache Webservers ist denkbar simpel. Wenn Sie noch keinen Apache Webserver auf Ihrem System haben, installieren Sie diesen:

<xterm>
vmdebian3:/usr/local# <fc #9acd32>aptitude install apache2</fc>
</xterm>

Das wars schon, überprüfen können Sie dies in dem Sie die Default Webseite Ihres neuen Servers aufrufen:

{{:tux:apacheworks.png|}}

So schaut dann Ihre neuer Internetauftritt aus! In der Standardinstallation befindet sich diese Standard <fc #008000>index.html</fc> im Standard Document Root <fc #008000>/var/www</fc>.

Die Verzeichnisstruktur von Apache gliedert sich auf einem Debian System wie folgt:

<xterm>
vmdebian3:/# <fc #9acd32>tree -d etc/apache2/</fc>
etc/apache2/
|-- conf.d          <fc #ffa500><- Beinhaltet zusätzliche Konfigurationsdateien</fc>
|-- mods-available  <fc #ffa500><- Speicherort der installierten Apache Module (-> Debian)</fc>
|-- mods-enabled    <fc #ffa500><- Symlink aus mods-enabled aktiviert das Modul (-> Debian)</fc>
|-- sites-available <fc #ffa500><- Speicherort der verfügbaren Virtual Hosts (-> Debian)</fc>
`-- sites-enabled   <fc #ffa500><- Symlink aus sites-enabled aktiviert die Virtual Hosts (-> Debian)</fc>
</xterm>

=== Virtual Host Direktive ===

<fc #800000>**Grundvoraussetzung**</fc> für das Funktionieren einer name-based vhost Konfiguration ist das Vorhandensein eines <fc #008000>DNS A-Records</fc> für jeden Vhost. Da alle Vhosts idR über die Selbe IP Adresse angesprochen werden, kann bei Verwendung einer IP Adresse nicht zwischen den Vhosts unterschieden werden. Wird dennoch eine IP Adresse verwendet, zeigt der Server idR den ersten Vhost in seiner Konfiguration an. Für die Übergabe der angesprochenen URL ist der HTTP-Header verantwortlich, der vom HTTP-Server ausgewertet und vom Browser übergeben wird. Wenn im Entwicklungsstadium einer Webseite noch kein A-Record vorhanden ist, kann man sich mit einem entsprechenden Eintrag in die lokale <fc #008000>/etc/hosts</fc>-Datei der Entwicklungsmaschine(n) behelfen. Dazu mehr im Abschnitt <fc #008000>»Testen der Konfiguration«</fc>
am Ende dieses Artikels.

<fc #800000>**Note:**</fc> Anstelle der IP-Adresse des Servers können sie in der <fc #008000><Virtualhost></fc> Anweisung auch mit einem <fc #008000>*-Zeichen</fc> (-> <Virtualhost *>) arbeiten. Das <fc #008000>*-Zeichen</fc> bei den Anweisungen <fc #008000>NameVirtualHost</fc> und <fc #008000><Virtualhost></fc> bewirkt, dass Apache diese Website auf allen IP-Adressen anbietet, die mit Listen-Anweisungen (z.B. in <fc #008000>/etc/apache2/ports.conf</fc>) benannt wurden. Wünschen Sie eine Differenzierung, können Sie statt des *-Zeichens auch eine oder mehrere IP-Adressen (ggf. mit TCP-Port) (z.B. <fc #008000>192.168.1.1:80</fc> 192.168.1.2:80) angeben.

Der Hauptbestandteil der virtuellen Hosts ist die <fc #008000>Virtual Host Direktive</fc>. Dazu wird für jeden verfügbaren (aber nicht aktiven) vhost eine Konfigurationsdatei in <fc #008000>/etc/apache2/sites-available</fc> abgelegt. Die Struktur einer vhost-Konfigurationsdatei gliedert sich in der Basis wie folgt:

<code xorg_conf|/etc/apache2/sites-available/SAMPLEFILE>
# NameVirtualHost * 

<VirtualHost 192.168.172.132>
  ServerName    # FQDN des vhost; zB www.mydomain.com
  ServerAlias   # FQDN eines Server Alias, welche auf den gleichen vhost zeigt; zB alias.mydomain.com (Optional)
  DocumentRoot  # Das Homeverzeichnis des vhosts; zB /home/www.mydomain.com
  ServerAdmin   # Wer ist für den Server verantwortlich?; zB admin@mydomain.com (Optional)
  CustomLog     # Logfile Pfad; zB /home/www.mydomain.com/logs/access.log combined
  ErrorLog      # Pfad zum Error Log; zB /home/www.mydomain.com/logs/error.log 
  LogLevel      # Definiert wie ausführlich geloggt wird; zB
</VirtualHost>

</code>

Nun können wir das mal an zwei Beispiel Vhosts durchspielen. Dazu werden im ersten Schritt die Document Root- und Log-Verzeichnisse für die beiden FQDNs erstellt:

<xterm>
vmdebian3:/etc/apache2# <fc #9acd32>mkdir -p <nowiki>/home/www.sample-1.com/logs</nowiki></fc>
vmdebian3:/etc/apache2# <fc #9acd32>mkdir -p <nowiki>/home/www.sample-2.com/logs</nowiki></fc>
</xterm>  

<fc #800000>**Note:**</fc> Sowohl der Pfad wie der Name für das Document Root Verzeichnis ist frei wählbar, es muss letztlich nur mit dem in der virtual Host Direktive übereinstimmen. Ich verwende aber idR wegen der Übersichtlichkeit den FQDN des Servers für den Verzeichnisnamen und lege die Document Root Verzeichnisse in <fc #008000>/home</fc>-Verzeichnis ab, was in meinen Installationen einen eigenen Mountpoint besitzt.

Im nächsten Schritt kopieren wir in jedes Document Root Verzeichnis eine eigene index.html, damit wird die Seite auch aufrufen können. Ich kopiere dafür zB die Default Apache <fc #008000>index.html</fc> von <fc #008000>/var/www</fc> und editiere diese zur einfacheren Unterscheidung noch mit eindeutige Angaben zum vhost:

<xterm>
vmdebian3:/etc/apache2# <fc #9acd32>cp /var/www/index.html <nowiki>/home/www.sample-1.com/</nowiki></fc>
vmdebian3:/etc/apache2# <fc #9acd32>cp /var/www/index.html <nowiki>/home/www.sample-2.com/</nowiki></fc>
</xterm>

Im Anschluss daran erstelle ich die beiden Host Direktiven in <fc #008000>/etc/apache2/sites-available</fc>. Der Name der Host Direktiven ist frei wählbar, ich verwende dafür idR wegen der Übersichtlichkeit den domainnamen:

<xterm>
vmdebian3:/etc/apache2# <fc #9acd32>touch /etc/apache2/sites-available/sample-1.com</fc>
vmdebian3:/etc/apache2# <fc #9acd32>touch /etc/apache2/sites-available/sample-2.com</fc>
</xterm>

<code xorg_conf|/etc/apache2/sites-available/sample-1.com>
# NameVirtualHost 192.168.172.132

<VirtualHost 192.168.172.132>
 ServerName www.sample-1.com
 ServerAlias
 DocumentRoot /home/www.sample-1.com/
 ServerAdmin Pronto
 CustomLog /home/www.sample-1.com/logs/access.log combined
 ErrorLog /home/www.sample-1.com/logs/error.log
 LogLevel warn
</VirtualHost>
</code>

<code xorg_conf|/etc/apache2/sites-available/sample-2.com>
# NameVirtualHost 192.168.172.132

<VirtualHost 192.168.172.132>
 ServerName www.sample-2.com
 ServerAlias
 DocumentRoot /home/www.sample-2.com/
 ServerAdmin Pronto
 CustomLog /home/www.sample-2.com/logs/access.log combined
 ErrorLog /home/www.sample-2.com/logs/error.log
 LogLevel warn
</VirtualHost>
</code>

Im Anschluss daran legen wir einen Symlink der Host Direktiven aus /etc/apache2/sites-available nach /etc/apache2/sites-enabled

<xterm>
vmdebian3:/etc/apache2# <fc #9acd32>ln -s /etc/apache2/sites-available/sample-1.com /etc/apache2/sites-enabled/sample-1.com</fc>
vmdebian3:/etc/apache2# <fc #9acd32>ln -s /etc/apache2/sites-available/sample-2.com /etc/apache2/sites-enabled/sample-2.com</fc>
vmdebian3:/etc/apache2# <fc #9acd32>ls -l /etc/apache2/sites-enabled/</fc>
insgesamt 0
lrwxrwxrwx 1 root root 26 25. Apr 13:33 000-default -> ../sites-available/default
lrwxrwxrwx 1 root root 41 25. Apr 17:15 sample-1.com -> /etc/apache2/sites-available/sample-1.com
lrwxrwxrwx 1 root root 41 25. Apr 17:16 sample-2.com -> /etc/apache2/sites-available/sample-2.com
</xterm>

Jetzt teilen wir dem Apache noch mit, dass er sich auf eine NameVirtualHost Direktive einstellen soll. Fügen Sie dazu in der <fc #008000>/etc/apache2/httpd.conf</fc> die Zeile <fc #008000>NameVirtualHost [IP Adresse des Servers]</fc> ein:

<xterm>
vmdebian3:/etc/apache2# <fc #9acd32>echo <nowiki>"NameVirtualHost 192.168.172.132" >> /etc/apache2/httpd.conf</nowiki></fc>
vmdebian3:/etc/apache2# <fc #9acd32>cat /etc/apache2/httpd.conf</fc> 
<fc #ffff00>NameVirtualHost 192.168.172.132</fc>
</xterm>

Zuletzt wird noch das IP/Hostname Binding in die >>/etc/hosts<< geschrieben:

<xterm>vmdebian3:/etc/apache2# <fc #9acd32>echo '192.168.172.132 <nowiki>www.sample-2.com www.sample-1.com' >></nowiki> /etc/hosts</fc></xterm>

Am Ende laden wird die Apachekonfiguration neu, um den HTTP-Server unsere Änderungen mitzuteilen:

<xterm>
vmdebian3:/etc/apache2# <fc #9acd32>/etc/init.d/apache2 reload</fc>
Reloading web server config: apache2.
</xterm>

=== Testen der Konfiguration ===

Da ich für diese Doku hier lokal auf meinen Test Systemen arbeite, kann ich nicht auf einen Internet DNS A-Record zurückgreifen und lege mir daher das Binding der FQDNs zur IP Adresse in meiner lokalen Hostsdatei an. Die Hostsdatei ist quasi der lokale DNS des Systems und es wird immer vor der eigentliche Anfrage an einen DNS Server geprüft, ob die lokale Hosts-Datei den Namen bereits auflösen kann. Die Hosts-Datei ist sowohl auf einem Linux-, wie auch auf einem Mac- und Windows-System verfügbar:

<xterm>
pronto-macpro:~ pronto$ <fc #9acd32>sudo -s</fc>
Password:
bash-3.2# <fc #9acd32><nowiki>echo "192.168.172.132 www.sample-1.com" >> /etc/hosts</nowiki></fc>
bash-3.2# <fc #9acd32><nowiki>echo "192.168.172.132 www.sample-2.com" >> /etc/hosts</nowiki></fc>
bash-3.2# <fc #9acd32>exit</fc>
</xterm>

<code xorg_conf|/etc/hosts>
##
# Host Database
#
# localhost is used to configure the loopback interface
# when the system is booting.  Do not change this entry.
##
127.0.0.1	localhost
255.255.255.255	broadcasthost
::1             localhost 
fe80::1%lo0	localhost

192.168.172.132 www.sample-1.com
192.168.172.132 www.sample-2.com
</code>

Beim Aufruf der eingestellten URLs sollten Sie nun auf den jeweiligen vhost gelangen:

{{:tux:sample1.png?400|}} {{:tux:sample2.png?400|}}\\ 

**Wuppt! Enjoy and have fun**
\\ 
 --- //pronto 2010/04/25 18:08//
{{keywords>apache vhost debian sites-available sites-enabled host direktive virtuell host apache2}}