Skip to main content

NGINX Virtual Host: Mehrere Domains auf einem Server hosten

Dieser Artikel ist eine Übersetzung des englischen Originals.


Die Einrichtung einer NGINX Virtual Host-Konfiguration ermöglicht es Ihnen, mehrere Domains auf einem einzigen Server zu hosten, Ihre Serverressourcen optimal zu nutzen und die Verwaltung zu vereinfachen. Diese umfassende Anleitung erklärt alles, was Sie über NGINX Virtual Hosts (Server-Blöcke) wissen müssen – von der grundlegenden Konfiguration bis hin zu fortgeschrittenen Wildcard-Subdomains.

Was ist ein NGINX Virtual Host?

Ein NGINX Virtual Host, technisch als „Server-Block” bezeichnet, ist eine Konfiguration, die es NGINX ermöglicht, abhängig vom angeforderten Domainnamen unterschiedliche Inhalte bereitzustellen. Während Apache sie „Virtual Hosts” nennt, verwendet NGINX den Begriff „Server-Blöcke” – beide verfolgen jedoch dasselbe Ziel: das Hosten mehrerer Websites auf einem Server.

Wenn eine Anfrage auf Ihrem Server eintrifft, prüft NGINX den Host-Header und gleicht ihn mit den server_name-Direktiven in Ihrer Konfiguration ab. Basierend auf dieser Übereinstimmung stellt NGINX Inhalte aus dem entsprechenden root directory bereit und wendet die zugehörige Konfiguration an.

Warum Virtual Hosts verwenden?

Virtual Hosting bietet mehrere Vorteile:

  • Kosteneffizienz: Betreiben Sie mehrere Websites auf einem einzigen Server
  • Ressourcenoptimierung: Teilen Sie Serverressourcen über mehrere Domains hinweg
  • Vereinfachte Verwaltung: Zentralisieren Sie alle Ihre Webanwendungen
  • IP-Einsparung: Keine separaten IP-Adressen pro Domain erforderlich

Voraussetzungen

Bevor Sie NGINX Virtual Hosts konfigurieren, stellen Sie sicher, dass Sie über Folgendes verfügen:

  • Einen Server mit Rocky Linux, AlmaLinux, RHEL oder einer anderen Enterprise-Linux-Distribution
  • Root- oder sudo-Zugriff
  • Ihre Domainnamen, die auf die IP-Adresse Ihres Servers zeigen

NGINX auf Enterprise Linux installieren

Wenn NGINX nicht installiert ist, installieren Sie es mit dnf:

dnf install nginx

Aktivieren und starten Sie NGINX:

systemctl enable --now nginx

Überprüfen Sie die Installation:

nginx -v

Firewall-Ports öffnen

Erlauben Sie HTTP- und HTTPS-Datenverkehr durch die Firewall:

firewall-cmd --permanent --add-service=http --add-service=https
firewall-cmd --reload

Hinweis: Diese Befehle öffnen die TCP-Ports 80 und 443 für HTTP/1.1- und HTTP/2-Datenverkehr. Wenn Sie HTTP/3 (QUIC) aktivieren möchten, müssen Sie zusätzlich den UDP-Port 443 öffnen. Weitere Informationen zur detaillierten Firewall-Konfiguration einschließlich der http3-Dienstdefinition finden Sie in unserer NGINX HTTP/3-Anleitung.

Die NGINX-Konfigurationsstruktur verstehen

Für die Verwaltung mehrerer Virtual Hosts empfiehlt sich das Muster mit sites-available und sites-enabled:

  • /etc/nginx/nginx.conf – Hauptkonfigurationsdatei
  • /etc/nginx/conf.d/ – Globale Konfigurationsausschnitte
  • /etc/nginx/sites-available/ – Alle Virtual Host-Konfigurationen (inaktiv)
  • /etc/nginx/sites-enabled/ – Symlinks zu aktiven Konfigurationen

Erstellen Sie diese Verzeichnisse, falls sie nicht vorhanden sind:

mkdir -p /etc/nginx/sites-available /etc/nginx/sites-enabled

Fügen Sie die folgende Zeile zu Ihrer nginx.conf innerhalb des http-Blocks hinzu (vor der schließenden Klammer):

include /etc/nginx/sites-enabled/*.conf;

Dieses Muster ermöglicht es Ihnen, Websites einfach zu aktivieren oder zu deaktivieren, indem Sie Symlinks erstellen oder entfernen, ohne Konfigurationsdateien zu löschen.

Grundlegende NGINX Virtual Host-Konfiguration

Erstellen wir Ihren ersten Virtual Host. Jeder Virtual Host benötigt:

  1. Einen dedizierten Systembenutzer für die Website
  2. Eine Server-Block-Konfiguration
  3. Ein Dokumentstammverzeichnis mit entsprechenden Berechtigungen

SCHRITT 1: Den Website-Benutzer erstellen

Jede Website sollte aus Sicherheitsgründen unter einem eigenen dedizierten Benutzerkonto laufen. Verwenden Sie niemals nginx, www-data oder root als Website-Eigentümer. Eine ausführliche Erklärung der richtigen Berechtigungen finden Sie in unserer Anleitung zu NGINX und PHP-FPM-Berechtigungen.

Erstellen Sie einen dedizierten Benutzer für die Website:

useradd example
passwd example

Fügen Sie den NGINX-Benutzer zur Gruppe des Website-Benutzers hinzu, damit er Dateien lesen kann:

usermod -aG example nginx

SCHRITT 2: Das Dokumentstammverzeichnis erstellen

Erstellen Sie eine Verzeichnisstruktur für Ihre Website:

mkdir -p /var/www/example.com/html

Legen Sie den korrekten Eigentümer fest (der Website-Benutzer besitzt die Dateien):

chown -R example:example /var/www/example.com

Legen Sie sichere Berechtigungen fest:

chmod -R u=rwX,g=rX,o= /var/www/example.com

Das bedeutet: Der Eigentümer kann lesen/schreiben, die Gruppe (nginx) kann lesen, andere haben keinen Zugriff.

Erstellen Sie eine Testseite:

sudo -u example bash -c 'echo "<html><body><h1>Welcome to example.com</h1></body></html>" > /var/www/example.com/html/index.html'

SCHRITT 3: SELinux-Kontext konfigurieren

Auf SELinux-fähigen Systemen (Standard bei Enterprise Linux) legen Sie den korrekten Sicherheitskontext fest:

semanage fcontext -a -t httpd_sys_content_t "/var/www(/.*)?"
restorecon -Rv /var/www

Ohne diesen Schritt gibt NGINX einen 403 Forbidden-Fehler zurück, da SELinux den Zugriff des Webservers auf Dateien mit falschen Kontexten verhindert.

Schritt 4: Server-Block-Konfiguration erstellen

Erstellen Sie die Konfigurationsdatei in sites-available:

vi /etc/nginx/sites-available/example.com.conf

Fügen Sie die folgende Konfiguration hinzu:

server {
    listen 80;
    listen [::]:80;
    server_name example.com www.example.com;

    root /var/www/example.com/html;
    index index.html;

    access_log /var/log/nginx/example.com.access.log;
    error_log /var/log/nginx/example.com.error.log;

    location / {
        try_files $uri $uri/ =404;
    }
}

Schritt 5: Website aktivieren

Erstellen Sie einen symbolischen Link, um die Website zu aktivieren:

ln -s /etc/nginx/sites-available/example.com.conf /etc/nginx/sites-enabled/

Schritt 6: NGINX testen und neu laden

Testen Sie Ihre Konfiguration immer, bevor Sie Änderungen anwenden:

nginx -t

Sie sollten Folgendes sehen:

nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

Wenden Sie die Konfiguration an:

systemctl reload nginx

Mehrere Domains hosten

Um zusätzliche Domains zu hosten, wiederholen Sie den Vorgang für jede Website mit ihrem eigenen Benutzer:

Erstellen Sie den Benutzer und das Verzeichnis:

useradd example_org
usermod -aG example_org nginx
mkdir -p /var/www/example.org/html
chown -R example_org:example_org /var/www/example.org
chmod -R u=rwX,g=rX,o= /var/www/example.org
restorecon -Rv /var/www/example.org

Erstellen Sie die Server-Block-Konfiguration unter /etc/nginx/sites-available/example.org.conf:

server {
    listen 80;
    listen [::]:80;
    server_name example.org www.example.org;

    root /var/www/example.org/html;
    index index.html;

    access_log /var/log/nginx/example.org.access.log;
    error_log /var/log/nginx/example.org.error.log;

    location / {
        try_files $uri $uri/ =404;
    }
}

Aktivieren Sie die Website und laden Sie neu:

ln -s /etc/nginx/sites-available/example.org.conf /etc/nginx/sites-enabled/
nginx -t && systemctl reload nginx

Die server_name-Direktive verstehen

Die Direktive server_name bestimmt, welcher Server-Block eine Anfrage verarbeitet. NGINX unterstützt mehrere Übereinstimmungsmuster, wie in der offiziellen NGINX-Dokumentation beschrieben:

Genaue Namen

Die gebräuchlichste und schnellste Übereinstimmungsmethode:

server_name example.com www.example.com;

Sie können mehrere Namen durch Leerzeichen getrennt angeben.

Wildcard-Namen

Übereinstimmung mit jeder Subdomain durch einen führenden Stern:

server_name *.example.com;

Dies stimmt mit www.example.com, api.example.com, blog.example.com und jeder anderen Subdomain überein.

Für nachfolgende Wildcards:

server_name example.*;

Dies stimmt mit example.com, example.org, example.net usw. überein.

Reguläre Ausdrücke

Für komplexe Übereinstimmungsmuster verwenden Sie Regex (Präfix ~):

server_name ~^(?<subdomain>.+).example.com$;

Dies erfasst die Subdomain in einer Variable, die Sie an anderer Stelle in der Konfiguration verwenden können.

Priorität der Server-Namen-Übereinstimmung

Wenn mehrere Server-Blöcke mit einer Anfrage übereinstimmen könnten, befolgt NGINX diese Prioritätsreihenfolge:

  1. Genaue Namensübereinstimmung – Am schnellsten, höchste Priorität
  2. Längste Wildcard, die mit einem Stern beginnt – z. B. *.example.com
  3. Längste Wildcard, die mit einem Stern endet – z. B. mail.*
  4. Erster übereinstimmender regulärer Ausdruck – In Konfigurationsreihenfolge
  5. Der Standard-Server – Fallback, wenn keine Übereinstimmung gefunden wird

Dieser Übereinstimmungsalgorithmus ähnelt der Funktionsweise von NGINX location-Blöcken mit ihrem eigenen Prioritätssystem. Das Verständnis beider Systeme ist entscheidend für ein vorhersehbares NGINX-Verhalten.

Die default_server-Direktive

Der Parameter default_server legt fest, welcher Server-Block Anfragen verarbeitet, die mit keinem server_name übereinstimmen:

server {
    listen 80 default_server;
    listen [::]:80 default_server;
    server_name _;

    return 444;
}

In diesem Beispiel erhalten nicht übereinstimmende Anfragen keine Antwort (Verbindung geschlossen). Der Unterstrich (_) ist eine Konvention, die „Catch-all” kennzeichnet – es ist keine spezielle NGINX-Syntax, sondern einfach ein ungültiger Domainname, der nie mit echten Anfragen übereinstimmt.

Warum default_server verwenden?

Ohne einen expliziten Standard-Server verwendet NGINX den ersten Server-Block in der Konfigurationsreihenfolge. Dies kann zu unerwartetem Verhalten führen. Häufige Anwendungsfälle für den Standard-Server sind:

  • : Geben Sie 444 zurück, um Verbindungen zu schließen
  • Weiterleitung zu einer Hauptseite: Leiten Sie den gesamten Datenverkehr an Ihre Primärdomain weiter
  • Anzeige einer Standardseite: Zeigen Sie eine generische Landingpage an

Speichern Sie dies als /etc/nginx/sites-available/default.conf und aktivieren Sie es:

server {
    listen 80 default_server;
    listen [::]:80 default_server;
    server_name _;

    return 444;
}

Konfigurieren von Wildcard-Subdomains

Wildcard-Server-Blöcke verarbeiten alle Subdomains, ohne dass einzelne Konfigurationen erstellt werden müssen:

server {
    listen 80;
    listen [::]:80;
    server_name *.example.com;

    root /var/www/subdomains/html;
    index index.html;

    location / {
        try_files $uri $uri/ =404;
    }
}

Bereitstellen unterschiedlicher Inhalte pro Subdomain

Verwenden Sie die Variable $host, um subdomainspezifische Inhalte bereitzustellen:

server {
    listen 80;
    listen [::]:80;
    server_name *.example.com;

    set $subdomain "";
    if ($host ~ ^(.+).example.com$) {
        set $subdomain $1;
    }

    root /var/www/subdomains/$subdomain/html;
    index index.html;

    location / {
        try_files $uri $uri/ =404;
    }
}

Erstellen Sie Verzeichnisse für jede Subdomain:

mkdir -p /var/www/subdomains/{blog,shop,api}/html

Fortgeschritten: Regex-Servernamen mit benannten Captures

Für anspruchsvolles Routing verwenden Sie Regex mit benannten Captures:

server {
    listen 80;
    listen [::]:80;
    server_name ~^(?<subdomain>.+).app.example.com$;

    root /var/www/apps/$subdomain/html;
    index index.html;

    location / {
        try_files $uri $uri/ =404;
    }
}

Die erfasste Variable $subdomain ist in der gesamten Konfiguration verfügbar. Diese Technik funktioniert gut mit NGINX rewrite rules für komplexe URL-Transformationen.

Best Practices für virtuelle Hosts

Verwenden Sie sites-available und sites-enabled

Dieses Muster bietet mehrere Vorteile:

  • Einfaches Aktivieren/Deaktivieren: Schalten Sie Sites mit Symlinks um, ohne Konfigurationen zu löschen
  • Saubere Organisation: Alle Konfigurationen an einem Ort, aktive verlinkt
  • Sicheres Testen: Erstellen Sie Konfigurationen, ohne sie zu aktivieren

So deaktivieren Sie eine Site:

rm /etc/nginx/sites-enabled/example.com.conf
systemctl reload nginx

So aktivieren Sie sie wieder:

ln -s /etc/nginx/sites-available/example.com.conf /etc/nginx/sites-enabled/
systemctl reload nginx

Dedizierte Protokolldateien

Konfigurieren Sie separate Zugriffs- und Fehlerprotokolle für jeden virtuellen Host:

access_log /var/log/nginx/example.com.access.log;
error_log /var/log/nginx/example.com.error.log;

Diese Trennung hilft beim Debugging und bei der Traffic-Analyse.

Konsistente Verzeichnisstruktur

Halten Sie ein standardisiertes Verzeichnislayout ein:

/var/www/
├── example.com/
│   └── html/
├── example.org/
│   └── html/

SELinux-Überlegungen

Auf Enterprise Linux mit aktiviertem SELinux:

  1. Legen Sie stets die korrekten Dateikontexte für Webinhalte fest
  2. Verwenden Sie httpd_sys_content_t für statische Dateien
  3. Verwenden Sie httpd_sys_rw_content_t für Verzeichnisse, die Schreibzugriff benötigen

Aktuelle Kontexte prüfen:

ls -laZ /var/www/

Sicherheitshärtung

Wenden Sie für Produktionsumgebungen diese wesentlichen Sicherheitskonfigurationen an:

Versionsoffenlegung deaktivieren: Verhindern Sie, dass NGINX seine Version in Fehlerseiten und Antwort-Headern preisgibt, indem Sie Folgendes zu Ihrem http-Block in nginx.conf hinzufügen:

http {
    server_tokens off;
    # ... other directives
}

HTTPS aktivieren: Eine vollständige SSL/TLS-Konfiguration finden Sie in unserem NGINX TLS 1.3 hardening guide. Hier ist eine produktionsreife HTTPS-Konfiguration für einen virtuellen Host:

server {
    listen 80;
    server_name example.com www.example.com;

    # Redirect HTTP to HTTPS
    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl;
    listen [::]:443 ssl;
    http2 on;
    server_name example.com www.example.com;

    # SSL certificates
    ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;

    # Modern TLS configuration
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384;
    ssl_prefer_server_ciphers off;

    # HSTS - force HTTPS for one year
    add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;

    # Security headers
    add_header X-Frame-Options "SAMEORIGIN" always;
    add_header X-Content-Type-Options "nosniff" always;

    root /var/www/example.com/html;
    index index.html;

    location / {
        try_files $uri $uri/ =404;
    }
}

Diese Konfiguration umfasst:

  • Nur TLSv1.2 und TLSv1.3 – ältere Protokolle sind anfällig für Angriffe
  • Starke Cipher Suites – AEAD-Cipher, die authentifizierte Verschlüsselung bieten
  • HSTS-Header – zwingt Browser zur Verwendung von HTTPS und verhindert Downgrade-Angriffe
  • Moderne http2-Direktive – verwendet die separate Direktive http2 on; (NGINX 1.25+)

Fehlerbehebung bei virtuellen Hosts

Konfiguration testen

Testen Sie stets, bevor Sie neu laden:

nginx -t

Prüfen, welcher Server-Block eine Anfrage verarbeitet

Verwenden Sie curl mit einem benutzerdefinierten Host-Header:

curl -H "Host: example.com" http://localhost/

Häufige Probleme

403 Forbidden-Fehler: Meist durch falsche Berechtigungen oder einen falschen SELinux-Kontext verursacht. Prüfen Sie:

ls -laZ /var/www/example.com/
namei -om /var/www/example.com/html/index.html

Konfiguration nicht übernommen: Ein NGINX-Reload übernimmt möglicherweise nicht alle Änderungen. Versuchen Sie einen Neustart:

systemctl restart nginx

Falscher Server-Block antwortet: Prüfen Sie auf doppelte default_server-Direktiven oder überlappende server_name-Muster.

Wenn bei der Verwendung von virtuellen Hosts mit proxied Backends Gateway-Fehler auftreten, lesen Sie unsere Anleitungen zu 502 Bad Gateway und 504 Gateway Timeout-Fehlern.

Leistungsaspekte

Für optimale Leistung virtueller Hosts:

Genaue Server-Namen verwenden, wenn möglich

Genaue Namen werden in einer Hash-Tabelle gespeichert und in O(1)-Zeit abgeglichen. Wildcards erfordern zusätzliche Verarbeitung, und Regex-Muster werden sequenziell ausgewertet.

server_names_hash optimieren

Bei vielen virtuellen Hosts erhöhen Sie die Hash-Bucket-Größe:

http {
    server_names_hash_bucket_size 128;
    server_names_hash_max_size 4096;
    # ...
}

Speicherverbrauch überwachen

Jeder Server-Block mit Regex-Mustern verbraucht zusätzlichen Speicher. Überwachen Sie den Speicherverbrauch Ihres Servers, wenn Sie viele Domains hosten.

Die Konfiguration von NGINX virtuellen Hosts ermöglicht effizientes Multi-Domain-Hosting auf einem einzigen Server. Wenn Sie die Konfiguration von Server-Blöcken, die Übereinstimmungsreihenfolge der server_name-Direktive und Best Practices für Organisation und Sicherheit verstehen, können Sie eine robuste Webhosting-Infrastruktur aufbauen.

Wichtigste Erkenntnisse:

  • Verwenden Sie das Muster sites-available und sites-enabled für eine einfache Verwaltung
  • Erstellen Sie einen dedizierten Benutzer für jede Website zur Sicherheitsisolierung
  • Setzen Sie auf Enterprise Linux immer die korrekten SELinux-Kontexte
  • Konfigurieren Sie einen default_server, um nicht zugeordnete Anfragen zu behandeln
  • Die Versionspreisgabe mit server_tokens off
  • deaktivieren

  • Verwenden Sie HTTPS mit moderner TLS-Konfiguration für die Produktion
  • Testen Sie Konfigurationen, bevor Sie Änderungen anwenden

Ob Sie einige persönliche Projekte hosten oder Dutzende von Kundenwebsites verwalten – NGINX virtuelle Hosts bieten die Flexibilität und Leistung, die Sie benötigen.

Das Routing von heute ist die Sicherheit von morgen. Eine falsch geordnete location oder ein Regex, der falsch greift, wird zu einem offenen Pfad. GetPageSpeed Amplify führt geplante gixy-Scans über jeden Host aus und verknüpft die Ergebnisse mit Live-Laufzeitmetriken von NGINX. Drop-in-kompatibel mit dem veralteten nginx-amplify-agent (EOL Januar 2026).