Startseite › Entwickler-Tools › Nginx-Config-Generator

Nginx-Config-Generator

Beantworte ein paar Fragen und erhalte einen sauberen, kommentierten nginx-Serverblock. Er deckt statische Websites, Single-Page-Apps, Reverse Proxys (mit WebSockets und Load Balancing) und PHP-FPM ab, dazu HTTPS mit modernen TLS-Einstellungen, Weiterleitungen, gzip, Caching und Sicherheits-Header.

Zuletzt aktualisiert:

Server
HTTPS
Leistung & Sicherheit
Weiterleitungen

Erzeugte Konfiguration

    Anzeige
    Anzeige

    Anleitung: Nginx-Config-Generator

    1. Wähle den Website-Typ: statische Dateien, eine Single-Page-App (React, Vue, Angular), einen Reverse Proxy zu einem App-Server oder PHP.
    2. Gib deine Domainnamen ein sowie das Document Root oder die Backend-Adresse.
    3. Richte HTTPS ein: Behalte die Let's-Encrypt-Pfade oder gib eigene Zertifikatsdateien an und wähle HTTP/2, HSTS und die gewünschte www-Weiterleitung.
    4. Optimiere Leistung und Sicherheit: gzip, Asset-Caching, Sicherheits-Header, Upload-Limit und eigene Weiterleitungen.
    5. Kopiere oder lade die Konfiguration herunter, speichere sie in /etc/nginx/sites-available/ oder /etc/nginx/conf.d/, führe sudo nginx -t aus und lade nginx neu.

    Wie nginx eine location auswählt

    Innerhalb eines Serverblocks wählt nginx pro Anfrage genau eine location. Wer die Reihenfolge kennt, vermeidet die meisten „Warum wird diese Regel ignoriert?“-Probleme:

    1. Exakte Übereinstimmung location = /path gewinnt sofort.
    2. Die längste Präfix-Übereinstimmung wird gemerkt. Verwendet sie ^~, gewinnt sie und reguläre Ausdrücke werden übersprungen.
    3. Reguläre Ausdrücke ~ (Groß-/Kleinschreibung beachten) und ~* (Groß-/Kleinschreibung ignorieren) werden in der Reihenfolge geprüft, in der sie in der Datei stehen; der erste Treffer gewinnt.
    4. Passt kein regulärer Ausdruck, wird das gemerkte längste Präfix (zum Beispiel location /) verwendet.

    Gängige nginx-Direktiven

    DirektiveZweck
    server_nameHostnamen, auf die dieser Serverblock antwortet. Verwende _ als Catch-all.
    root / indexOrdner mit den Dateien und die Datei, die bei einer Verzeichnisanfrage ausgeliefert wird.
    try_files $uri $uri/ /index.htmlVersuche die Datei, dann den Ordner, dann Rückfall auf index.html (SPA-Routing).
    return 301 https://$host$request_uriPermanente Weiterleitung, die Pfad und Query-String beibehält.
    proxy_pass http://127.0.0.1:3000Leitet die Anfrage an einen App-Server weiter. Mit URI-Teil wird das passende Präfix ersetzt.
    proxy_set_headerGibt Host, Client-IP und Protokoll an das Backend weiter.
    expires 30dSetzt Expires und Cache-Control: max-age für das Browser-Caching.
    add_header … alwaysFügt einen Antwort-Header hinzu, auch auf Fehlerseiten. Header werden nicht an eine location vererbt, die ihr eigenes add_header definiert.
    client_max_body_size 20MGrößter erlaubter Upload (Standard 1 MB, größere Anfragen erhalten 413).
    gzip onKomprimiert Textantworten; füge die MIME-Typen in gzip_types hinzu.

    Checkliste zur Fehlersuche

    • Immer zuerst testen: sudo nginx -t gibt Datei und Zeile jedes Syntaxfehlers aus. Lade mit sudo systemctl reload nginx neu, damit laufende Verbindungen nicht abbrechen.
    • 502 Bad Gateway: Das Backend läuft nicht oder lauscht auf einem anderen Port oder Socket. Prüfe es mit curl http://127.0.0.1:3000 auf dem Server und lies /var/log/nginx/error.log.
    • 403 Forbidden bei einer statischen Website: Der nginx-Benutzer (www-data oder nginx) braucht Leserechte für die Dateien und Ausführungsrechte für jeden übergeordneten Ordner.
    • Standardseite wird weiterhin angezeigt: Entferne oder deaktiviere sites-enabled/default oder stelle sicher, dass dein server_name zur angefragten Domain passt.
    • Weiterleitungsschleife hinter einem Load Balancer oder Cloudflare: Der Proxy spricht per HTTP mit nginx, daher erzeugt die Weiterleitung auf HTTPS eine Schleife. Nutze die HTTPS-Einstellungen des Proxys oder prüfe $http_x_forwarded_proto.

    Häufige Fragen

    Wo lege ich die nginx-Konfigurationsdatei ab?

    Unter Debian und Ubuntu speicherst du sie als /etc/nginx/sites-available/example.com.conf und verlinkst sie per Symlink nach /etc/nginx/sites-enabled/. Unter RHEL, Fedora, Alpine und im offiziellen Docker-Image speicherst du sie in /etc/nginx/conf.d/ mit der Endung .conf. Teste dann mit sudo nginx -t und übernimm sie mit sudo systemctl reload nginx.

    Wie leite ich in nginx HTTP auf HTTPS weiter?

    Füge einen Serverblock hinzu, der auf Port 80 für deine Domains lauscht und return 301 https://$host$request_uri; enthält (oder deine kanonische Domain statt $host). Der Generator erstellt diesen Block, wenn du HTTPS und die Weiterleitungsoption aktivierst.

    Wie liefert nginx eine React- oder Vue-Single-Page-App aus?

    Verwende try_files $uri $uri/ /index.html; in location /. Anfragen nach echten Dateien werden direkt ausgeliefert, und jeder andere Pfad fällt auf index.html zurück, damit der clientseitige Router ihn verarbeiten kann. Wähle den Typ „Single-Page-App“, um das plus sinnvolles Caching zu bekommen.

    Welche Header sollte ein Reverse Proxy an das Backend weitergeben?

    Mindestens Host, X-Real-IP, X-Forwarded-For und X-Forwarded-Proto, damit die App den ursprünglichen Host, die Client-IP und die Information kennt, ob die Anfrage HTTPS verwendet hat. Für WebSockets brauchst du zusätzlich proxy_http_version 1.1 sowie die Header Upgrade und Connection.

    Warum schlägt nginx -t mit einem Zertifikatsfehler fehl?

    Die ssl_certificate-Dateien müssen existieren, bevor nginx die Konfiguration lädt. Hol dir zuerst das Zertifikat (zum Beispiel mit sudo certbot certonly --nginx -d example.com) oder starte mit deaktiviertem HTTPS, besorge das Zertifikat und aktiviere dann HTTPS.

    Sollte ich listen 443 ssl http2 oder http2 on verwenden?

    Seit nginx 1.25.1 ist der http2-Parameter von listen zugunsten der separaten Direktive http2 on; veraltet. Verwende die neue Syntax bei aktuellem nginx und die alte Syntax nur für ältere Versionen wie 1.18 oder 1.22, die manche Distributionen ausliefern.

    Wird etwas an einen Server gesendet?

    Nein. Die Konfiguration wird in deinem Browser erzeugt, und deine Einstellungen werden nur im lokalen Speicher dieses Browsers gespeichert.

    Werden alle Tools auf FreeToolCabin auf Qualität und Genauigkeit getestet?

    Ja. Jedes Tool auf der Website durchläuft automatische Tests in echten Browsern, die prüfen, ob das Ergebnis stimmt und keine Fehler auftreten. Wenn du einen Fehler findest oder einen Vorschlag hast, schreib uns an [email protected] – wir sehen es uns an.

    Ähnliche Tools

    Alle Code-Generatoren & Builder ansehen →