Wie man Virtual Hosts in Nginx auf Ubuntu konfiguriert

Die Konfiguration virtueller Hosts in Nginx ist eine der leistungsstärksten Techniken zum Hosten mehrerer Websites auf einem einzelnen Server, jeweils mit eigenem Domainnamen, Root-Verzeichnis und unabhängiger Konfiguration. Nginx handhabt dies durch Server Blocks — flexible, leichte Konfigurationseinheiten, die definieren, wie der Webserver auf Anfragen für jede Domain reagiert.

Egal ob Sie ein persönliches Portfolio verwalten, Client-Websites betreiben oder eine Multi-Tenant-Anwendung skalieren — dieser Leitfaden bietet eine vollständige, produktionsreife Anleitung zum Einrichten von Nginx Virtual Hosts auf Ubuntu. Wir behandeln Verzeichnisstruktur, Server-Block-Konfiguration, Aktivierung von Sites, SSL/HTTPS-Setup und Fehlerbehebung — alles, was Sie benötigen, um von Null zu einem vollständig funktionsfähigen Multi-Site-Nginx-Server zu gelangen.

> Suchen Sie nach einem zuverlässigen Ubuntu-Server zum Mitverfolgen? AlexHost’s VPS Hosting Pläne bieten Ihnen vollständigen Root-Zugriff, SSD-Speicher und sofortige Bereitstellung — perfekt für genau diesen Anwendungsfall.

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass die folgenden Bedingungen erfüllt sind:

Nginx auf Ihrem Server installiert

Wenn Nginx noch nicht installiert ist, führen Sie die folgenden Befehle auf Ihrem Ubuntu-Server aus:

sudo apt update
sudo apt install nginx

Überprüfen Sie die Installation und stellen Sie sicher, dass der Service läuft:

sudo systemctl status nginx

Sie sollten active (running) in der Ausgabe sehen. Wenn nicht, starten Sie ihn manuell:

sudo systemctl start nginx
sudo systemctl enable nginx

Domainnamen, die auf Ihren Server verweisen

Jeder Virtual Host benötigt einen Domainnamen, der sich zu Ihrer öffentlichen IP-Adresse des Servers auflöst. Sie müssen A-Einträge in Ihren DNS-Einstellungen erstellen, die auf die Server-IP verweisen.

> Benötigen Sie eine Domain? Registrieren Sie Ihre über AlexHost Domain Registration und verwalten Sie DNS-Einträge direkt von Ihrem Control Panel aus.

Für lokale Testzwecke können Sie DNS vollständig umgehen, indem Sie Ihre /etc/hosts Datei bearbeiten (behandelt in Schritt 7).

Erforderliche Berechtigungen

Sie benötigen sudo Berechtigungen auf Ihrem Ubuntu-Server, um Verzeichnisse zu erstellen, Konfigurationsdateien zu bearbeiten und den Nginx-Service zu verwalten.

Schritt 1: Verzeichnisse für jede Website einrichten

Jede auf Ihrem Server gehostete Website sollte ihr eigenes isoliertes Verzeichnis haben, um Webdateien zu speichern. Diese Trennung hält Ihre Projekte organisiert und verhindert Konfigurationskonflikte.

In diesem Leitfaden konfigurieren wir zwei Beispiel-Domains: example1.com und example2.com. Ersetzen Sie diese in der gesamten Anleitung durch Ihre tatsächlichen Domainnamen.

Web-Root-Verzeichnisse erstellen

sudo mkdir -p /var/www/example1.com/html
sudo mkdir -p /var/www/example2.com/html

Das -p Flag erstellt alle erforderlichen Zwischenverzeichnisse.

Korrekte Eigentumsrechte zuweisen

Gewähren Sie Eigentumsrechte dieser Verzeichnisse an www-data, den Systembenutzer, unter dem Nginx läuft:

sudo chown -R www-data:www-data /var/www/example1.com/html
sudo chown -R www-data:www-data /var/www/example2.com/html

Dies stellt sicher, dass Nginx die erforderlichen Leseberechtigungen hat, um Dateien aus diesen Verzeichnissen bereitzustellen.

Verzeichnisberechtigungen festlegen

sudo chmod -R 755 /var/www

Die 755 Berechtigung bedeutet, dass der Besitzer vollständigen Lese-/Schreib-/Ausführungszugriff hat, während Gruppen und andere Benutzer Lese- und Ausführungszugriff haben — angemessen für öffentlich bereitgestellte Webinhalte.

Schritt 2: Beispiel-HTML-Inhalte erstellen

Um zu überprüfen, dass jeder Virtual Host korrekt funktioniert, erstellen Sie eine einfache index.html Datei für jede Site.

Für example1.com

echo "<h1>Welcome to Example1.com!</h1>" | sudo tee /var/www/example1.com/html/index.html

Für example2.com

echo "<h1>Welcome to Example2.com!</h1>" | sudo tee /var/www/example2.com/html/index.html

Diese Platzhalter-Seiten bestätigen, dass Nginx Anfragen zum richtigen Dokumentenstammverzeichnis für jede Domain leitet.

Schritt 3: Virtual-Host-Konfigurationsdateien erstellen

Nginx speichert Site-Konfigurationsdateien in /etc/nginx/sites-available/. Jede Datei definiert einen Server Block — das Nginx-Äquivalent eines Apache Virtual Host. Aktivierte Sites werden dann in /etc/nginx/sites-enabled/ symlink-verknüpft.

Konfiguration für example1.com

Erstellen Sie eine neue Konfigurationsdatei:

sudo nano /etc/nginx/sites-available/example1.com

Fügen Sie den folgenden Server Block hinzu:

server {
    listen 80;
    listen [::]:80;

    server_name example1.com www.example1.com;

    root /var/www/example1.com/html;
    index index.html index.htm;

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

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

Speichern und schließen Sie die Datei (Ctrl+X, dann Y, dann Enter).

Konfiguration für example2.com

Erstellen Sie eine zweite Konfigurationsdatei:

sudo nano /etc/nginx/sites-available/example2.com

Fügen Sie den folgenden Server Block hinzu:

server {
    listen 80;
    listen [::]:80;

    server_name example2.com www.example2.com;

    root /var/www/example2.com/html;
    index index.html index.htm;

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

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

Wichtige Direktiven erklärt

Schritt 4: Virtual Hosts aktivieren

Nginx aktiviert Sites durch Erstellen symbolischer Links von sites-available zu sites-enabled. Dieses Design ermöglicht es Ihnen, Konfigurationen vorzubereiten, ohne sie sofort zu aktivieren.

sudo ln -s /etc/nginx/sites-available/example1.com /etc/nginx/sites-enabled/
sudo ln -s /etc/nginx/sites-available/example2.com /etc/nginx/sites-enabled/

Standard-Site deaktivieren (Optional, aber empfohlen)

Wenn Sie verhindern möchten, dass Nginx’s Standard-Platzhalter-Seite interferiert, deaktivieren Sie sie:

sudo rm /etc/nginx/sites-enabled/default

Sie können sie später jederzeit wieder aktivieren, indem Sie den Symlink neu erstellen.

Schritt 5: Nginx-Konfiguration testen

Bevor Sie Nginx neu starten, validieren Sie immer Ihre Konfigurationsdateien auf Syntaxfehler. Eine falsch konfigurierte Datei kann alle Sites auf dem Server lahmlegen.

sudo nginx -t

Ein erfolgreicher Test gibt Folgendes zurück:

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

Wenn Sie Fehler sehen, zeigt Nginx die Datei und Zeilennummer an, wo das Problem auftritt. Überprüfen Sie die relevante Konfigurationsdatei und korrigieren Sie alle Tippfehler oder fehlende Semikola, bevor Sie fortfahren.

Schritt 6: Nginx neu starten, um Änderungen anzuwenden

Sobald der Konfigurationstest erfolgreich ist, laden Sie Nginx neu oder starten Sie es neu, um Ihre Änderungen anzuwenden:

sudo systemctl restart nginx

Alternativ können Sie reload für einen sanften Neustart verwenden, der aktive Verbindungen nicht unterbricht:

sudo systemctl reload nginx

Schritt 7: Auf Ihre Websites zugreifen

Wenn DNS bereits konfiguriert ist

Wenn Ihre Domainnamen bereits über DNS A-Einträge auf die IP-Adresse Ihres Servers verweisen, öffnen Sie einfach einen Browser und navigieren Sie zu:

• http://example1.com
• http://example2.com

Sie sollten die jeweiligen „Willkommens”-Meldungen sehen, die Sie in Schritt 2 erstellt haben.

Für lokale Tests (ohne DNS)

Wenn Sie lokal testen oder DNS noch nicht propagiert hat, können Sie die Domain-Auflösung simulieren, indem Sie die /etc/hosts Datei Ihres lokalen Computers (auf Linux/macOS) oder C:WindowsSystem32driversetchosts (auf Windows) bearbeiten.

Öffnen Sie die Datei mit erhöhten Berechtigungen:

sudo nano /etc/hosts

Fügen Sie die folgenden Zeilen hinzu und ersetzen Sie YOUR_SERVER_IP durch Ihre tatsächliche Server-IP:

YOUR_SERVER_IP example1.com www.example1.com
YOUR_SERVER_IP example2.com www.example2.com

Speichern Sie die Datei und testen Sie in Ihrem Browser. Denken Sie daran, diese Einträge zu entfernen, sobald Ihre echten DNS-Einträge live sind.

Schritt 8: HTTPS mit Let’s Encrypt aktivieren (empfohlen)

Das Ausführen von Websites über einfaches HTTP ist für Produktionsumgebungen nicht mehr akzeptabel. HTTPS verschlüsselt den Datenverkehr zwischen Ihrem Server und Besuchern, verbessert SEO-Rankings und ist erforderlich für moderne Browser-Funktionen. Let’s Encrypt bietet kostenlose, automatisch erneuerbare SSL/TLS-Zertifikate.

> Bevorzugen Sie eine Premium-SSL-Lösung? AlexHost bietet vertrauenswürdige SSL-Zertifikate für Unternehmen, die erweiterte Validierung oder Wildcard-Abdeckung benötigen.

Certbot installieren

sudo apt install certbot python3-certbot-nginx

SSL-Zertifikate erhalten und installieren

Führen Sie Certbot für jede Domain aus. Das --nginx Plugin modifiziert automatisch Ihre Nginx-Konfiguration, um HTTPS zu aktivieren:

sudo certbot --nginx -d example1.com -d www.example1.com

sudo certbot --nginx -d example2.com -d www.example2.com

Folgen Sie den interaktiven Aufforderungen. Certbot wird:

1. Domain-Eigentumsrecht über HTTP-Challenge überprüfen
2. Ein signiertes Zertifikat von Let’s Encrypt erhalten
3. Ihren Nginx Server Block automatisch aktualisieren, um auf Port 443 zu lauschen
4. HTTP-zu-HTTPS-Umleitung konfigurieren

Automatische Erneuerung überprüfen

Let’s Encrypt-Zertifikate verfallen alle 90 Tage. Certbot installiert einen systemd-Timer zur automatischen Handhabung von Erneuerungen. Testen Sie ihn mit:

sudo certbot renew --dry-run

Wenn der Testlauf ohne Fehler abgeschlossen wird, werden Ihre Zertifikate automatisch ohne manuelle Eingriffe erneuert.

So sieht Ihr aktualisierter Server Block aus

Nach der Ausführung von Certbot wird Ihre Konfiguration automatisch auf etwa folgende Weise aktualisiert:

server {
    listen 443 ssl;
    server_name example1.com www.example1.com;

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

    ssl_certificate /etc/letsencrypt/live/example1.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/example1.com/privkey.pem;
    include /etc/letsencrypt/options-ssl-nginx.conf;
    ssl_dhparam /etc/letsencrypt/ssl-dhparams.pem;

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

server {
    listen 80;
    server_name example1.com www.example1.com;
    return 301 https://$host$request_uri;
}

Fehlerbehebung häufiger Probleme

Auch bei sorgfältiger Konfiguration können Probleme auftreten. Hier sind die häufigsten Probleme und deren Lösungen:

502 Bad Gateway

Dies bedeutet normalerweise, dass Nginx nicht mit einem Backend-Service kommunizieren kann (z.B. PHP-FPM oder eine Node.js-App). Überprüfen Sie, dass der Upstream-Service läuft und dass der Socket/Port in Ihrer Konfiguration korrekt ist.

403 Forbidden

Normalerweise ein Berechtigungsproblem. Überprüfen Sie, dass www-data das Web-Root-Verzeichnis besitzt und dass Dateiberechtigungen korrekt eingestellt sind:

sudo chown -R www-data:www-data /var/www/example1.com
sudo chmod -R 755 /var/www/example1.com

404 Not Found

Überprüfen Sie, dass die root Direktive in Ihrem Server Block auf das richtige Verzeichnis verweist und dass index.html in diesem Pfad existiert.

Falsche Site wird geladen

Wenn der Besuch von example1.com den Inhalt von example2.com lädt, überprüfen Sie, dass:

• Jede server_name Direktive eindeutig und korrekt ist
• Symlinks in sites-enabled gültig sind: ls -la /etc/nginx/sites-enabled/