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:
- Einen dedizierten Systembenutzer für die Website
- Eine Server-Block-Konfiguration
- 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:
- Genaue Namensübereinstimmung – Am schnellsten, höchste Priorität
- Längste Wildcard, die mit einem Stern beginnt – z. B.
*.example.com - Längste Wildcard, die mit einem Stern endet – z. B.
mail.* - Erster übereinstimmender regulärer Ausdruck – In Konfigurationsreihenfolge
- 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:
- Legen Sie stets die korrekten Dateikontexte für Webinhalte fest
- Verwenden Sie
httpd_sys_content_tfür statische Dateien - Verwenden Sie
httpd_sys_rw_content_tfü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-availableundsites-enabledfü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 - Verwenden Sie HTTPS mit moderner TLS-Konfiguration für die Produktion
- Testen Sie Konfigurationen, bevor Sie Änderungen anwenden
deaktivieren
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).