Zum Hauptinhalt springen

So richten Sie eine Nginx-Konfigurationsdatei ein: eine vollständige Anleitung

Die Nginx-Konfigurationsdatei ist ein Schlüsselelement bei der Konfiguration und Optimierung des Webservers. Es enthält eine Reihe von Richtlinien, mit denen Sie das Verhalten des Servers definieren, Verbindungen verwalten, virtuelle Hosts konfigurieren und vieles mehr können. In diesem Handbuch werden wir die grundlegenden Aspekte der Konfiguration einer Nginx-Konfigurationsdatei untersuchen und Beispiele für ihre Verwendung angeben.

Bevor Sie mit der Nginx-Konfigurationsdatei beginnen, müssen Sie den Nginx-Server selbst auf Ihrem System installieren. Sie können dies tun, indem Sie den Anweisungen auf der offiziellen Website folgen. Nach der Installation des Servers können Sie die Nginx-Konfigurationsdatei im Pfad /etc/nginx/nginx finden.conf.

Die Nginx-Konfigurationsdatei hat eine ziemlich flexible Struktur und ermöglicht die Erstellung komplexer Konfigurationen mit verschiedenen Modulen. Es ist wichtig zu wissen, dass die Syntax der Konfigurationsdatei streng ist und nur wenige Fehler zulässt. Um zu überprüfen, ob die Konfiguration korrekt ist, können Sie den Befehl verwenden nginx -t.

Beispiel: Konfigurieren eines virtuellen Hosts

Ein wichtiger Aspekt der Nginx-Konfiguration ist die Konfiguration eines virtuellen Hosts. Mit virtuellen Hosts können Sie mehrere Websites auf demselben Server mit unterschiedlichen Domänen oder IP-Adressen konfigurieren. Sie können die folgende Syntax verwenden, um einen virtuellen Host in der Nginx-Konfigurationsdatei zu konfigurieren:

In diesem Beispiel wird ein virtueller Host für die Domäne definiert example.com , die auf Port 80 hören wird. Das in der root-Direktive angegebene Stammverzeichnis zeigt den Pfad zu den Dateien der Website an. Die index-Direktive definiert die Datei, die standardmäßig geladen wird, wenn Sie auf eine Website zugreifen.

Vorbereitung für die Einrichtung

Bevor Sie mit der Konfiguration der Nginx-Konfigurationsdatei beginnen, müssen Sie einige vorbereitende Schritte ausführen. Diese Schritte helfen Ihnen, Probleme zu vermeiden und den Setup-Prozess reibungsloser und effizienter zu gestalten.

1. Einführung in die Dokumentation

Der erste Schritt vor dem Einrichten von Nginx besteht darin, sich mit der offiziellen Dokumentation vertraut zu machen. Die Dokumentation enthält alle notwendigen Informationen zu den verfügbaren Optionen und Einstellungen. Nehmen Sie sich Zeit, die Abschnitte zu Ihrer spezifischen Aufgabe oder Ihren Anforderungen zu erkunden.

2. Erstellen einer Sicherung

Es wird empfohlen, eine Sicherungskopie zu erstellen, bevor Sie Änderungen an der Nginx-Konfigurationsdatei vornehmen. Dies ermöglicht es Ihnen, die vorherige Version der Datei im Falle eines Fehlers oder unerwünschter Konsequenzen nach vorgenommenen Änderungen schnell wiederherzustellen.

3. Analysieren der aktuellen Konfiguration

Analysieren Sie die aktuelle Nginx-Konfiguration, um zu verstehen, welche Optionen und Einstellungen bereits vorhanden sind. Dadurch können Sie doppelte Einstellungen vermeiden und Änderungen leichter planen.

4. Erstellen eines Konfigurationsplans

Bevor Sie mit der Konfiguration beginnen, erstellen Sie einen Plan, der eine Liste der Änderungen enthält, die Sie an der Nginx-Konfiguration vornehmen müssen. Teilen Sie diese Liste in Teilaufgaben auf und priorisieren Sie die einzelnen Aufgaben.

5. Überprüfen, ob die erforderlichen Module vorhanden sind

Stellen Sie sicher, dass Sie alle erforderlichen Module installiert haben, die Sie für Ihre Nginx-Konfiguration benötigen. Lesen Sie die Dokumentation durch und stellen Sie sicher, dass alle erforderlichen Module aktiviert sind.

Nachdem Sie diese vorbereitenden Schritte abgeschlossen haben, können Sie mit der Konfiguration der Nginx-Konfigurationsdatei fortfahren.

Nginx herunterladen und installieren

Der Installationsprozess von Nginx variiert je nach Betriebssystem, das Sie verwenden. In diesem Abschnitt werden wir uns die grundlegenden Möglichkeiten ansehen, Nginx auf mehreren gängigen Plattformen zu installieren.

Installieren von Nginx auf Ubuntu oder Debian

1. Aktualisieren Sie die Paketliste:

sudo apt update

2. Installieren Sie Nginx mit dem folgenden Befehl:

sudo apt install nginx

3. Überprüfen Sie nach Abschluss der Installation den Status des Nginx-Dienstes, um sicherzustellen, dass er funktioniert:

sudo systemctl status nginx

Installieren von Nginx auf CentOS oder Fedora

1. Aktualisieren Sie die Paketliste:

sudo yum update

2. Installieren Sie Nginx mit dem folgenden Befehl:

sudo yum install nginx

3. Führen Sie Nginx aus und fügen Sie es zum Autorun hinzu:

sudo systemctl start nginx sudo systemctl enable nginx

Installieren von Nginx auf macOS

1. Installieren Sie Homebrew, wenn Sie es noch nicht installiert haben:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. Installieren Sie Nginx mit dem folgenden Befehl:

brew install nginx

3. Führen Sie Nginx aus und überprüfen Sie den Dienststatus:

brew services start nginx brew services list

Sie können überprüfen, ob Nginx erfolgreich installiert wurde, indem Sie zu der folgenden Adresse gehen http://localhost in Ihrem Webbrowser.

Arbeiten mit Konfigurationsdateien

Die Konfigurationsdateien in Nginx enthalten Einstellungen, die bestimmen, wie der Server ausgeführt wird. Diese Dateien werden verwendet, um Servereinstellungen zu definieren, Anforderungen weiterzuleiten und verschiedene Module zu konfigurieren. In diesem Abschnitt werden wir die grundlegenden Aspekte der Arbeit mit Nginx-Konfigurationsdateien untersuchen.

  • Speicherort der Konfigurationsdateien: Nginx-Konfigurationsdateien befinden sich normalerweise im Verzeichnis /etc/nginx. Die Hauptkonfigurationsdatei heißt nginx.conf. Diese Datei definiert die globalen Einstellungen für den gesamten Server.
  • Struktur der Konfigurationsdateien: Nginx-Konfigurationsdateien haben eine einfache Struktur, sie bestehen aus Anweisungsblöcken. Richtlinienblöcke beginnen mit einer Block-ID, z. B. http oder server. Innerhalb der Richtlinienblöcke befinden sich die Direktiven selbst, die bestimmte Einstellungen definieren.
  • Die Syntax der Direktiven: Direktiven in Nginx-Konfigurationsdateien haben normalerweise die Form "Schlüsselwert;". Werte können Strings oder Zahlen oder Arrays von Werten sein. Direktiven können ineinander verschachtelt werden, um Richtlinienblöcke zu bilden.
  • Kommentare: Nginx-Konfigurationsdateien unterstützen Kommentare. Kommentare sind Strings, die mit dem Zeichen "#" beginnen. Kommentare werden zur Erläuterung der Konfiguration oder zum vorübergehenden Deaktivieren von Direktiven verwendet.
  • Testen der Konfiguration: Nachdem Sie die Konfigurationsdateien geändert haben, können Sie testen, ob die eingegebenen Einstellungen korrekt sind. Verwenden Sie dazu den Befehl "nginx -t", der die syntaktische Korrektheit und logische Konfigurationssemantik überprüft. Wenn die Ausgabe des Befehls die Meldung "configuration file is valid" enthält, sind die Dateien korrekt konfiguriert.
  • Server neu starten: Um Änderungen an Nginx-Konfigurationsdateien zu übernehmen, muss der Server neu gestartet werden. Verwenden Sie dazu den Befehl "nginx -s reload". Wenn der Neustart erfolgreich war, wird die Meldung "reloading configuration" angezeigt.

Grundeinstellung

Bevor Sie mit Nginx arbeiten, müssen Sie die Konfigurationsdatei des Servers grundlegend konfigurieren.

1. Öffnen Sie die Nginx-Konfigurationsdatei. Die Datei befindet sich standardmäßig im Verzeichnis /etc/nginx/nginx.conf.

2. Nehmen Sie die erforderlichen Einstellungen vor:

- Konfigurieren Sie den Parameter user, indem Sie den Benutzernamen angeben, unter dem der Server arbeiten soll. Zum Beispiel:

- Konfigurieren Sie den Parameter worker_processes, indem Sie die Anzahl der Workflows angeben, die Anforderungen verarbeiten. Zum Beispiel, um die Anzahl der verfügbaren CPU-Kerne zu verwenden:

- Konfigurieren Sie den Parameter error_log, indem Sie den Pfad zur Datei mit den Fehlerprotokollen angeben. Zum Beispiel:

- Konfigurieren Sie den Parameter access_log, indem Sie den Pfad zur Datei mit den Zugriffsprotokollen angeben. Zum Beispiel:

- Konfigurieren Sie den pid-Parameter, indem Sie den Pfad zu der Datei angeben, in der die Prozess-ID des Masterprozesses gespeichert werden soll. Zum Beispiel:

3. Überprüfen Sie die korrekten Einstellungen mit dem Befehl:

4. Starten Sie den Nginx-Server neu, um die Einstellungen anzuwenden:

Jetzt ist Ihr Nginx-Server konfiguriert und bereit zu gehen!

Grundlegende Konfigurationsdateidirektiven

Die Nginx-Konfigurationsdatei verwendet verschiedene Direktiven, um das Verhalten des Servers zu bestimmen. Im Folgenden sind die grundlegenden Richtlinien aufgeführt, die Sie kennen sollten:

RichtlinieDie BeschreibungAnwendungsbeispiel
worker_processesGibt die Anzahl der Workflows an, die Anforderungen erfüllen sollen.worker_processes 4;
eventsDefiniert die Ereigniseinstellungen für Workflows.events worker_connections 1024;
>
httpDefiniert die globalen Einstellungen des HTTP-Protokolls.http .
>
serverDefiniert die Einstellungen für den virtuellen Server.server .
>
locationLegt die Einstellungen für einen bestimmten Standort auf dem Server fest.location / .
>
rootDefiniert das Stammverzeichnis für die Wartung statischer Dateien.root /usr/share/nginx/html;
indexGibt die Indexdatei an, die beim Zugriff auf das Stammverzeichnis angezeigt wird.index index.html;
try_filesGibt die Reihenfolge an, in der versucht wird, die angeforderte Datei abzurufen.try_files $uri $uri/ =404;
proxy_passGibt die Adresse und den Port des Proxyservers an, der Anforderungen senden soll.proxy_pass http://localhost:8080;

Konfigurieren von Ports und Abhören von Adressen

Wenn Sie die Nginx-Konfigurationsdatei konfigurieren, können Sie die Ports und Adressen angeben, an denen der Server eingehende Verbindungen abhören soll.

Verwenden Sie die Direktive, um die Ports anzugeben listen. Zum Beispiel:

listen 80;

Diese Direktive gibt an, dass der Server auf eingehende Verbindungen an Port 80 wartet.

Sie können auch die Adresse angeben, an der der Server Verbindungen abhören soll. Zum Beispiel:

listen 192.168.1.100:80;

Diese Direktive gibt an, dass der Server eingehende Verbindungen an der IP-Adresse 192.168.1.100 und an Port 80 abhört.

Damit Nginx alle verfügbaren Adressen abhört, können Sie die Adresse 0.0.0.0 angeben:

listen 0.0.0.0:80;

Dies bedeutet, dass der Server eingehende Verbindungen an allen verfügbaren Adressen und Port 80 abhört.

Sie können auch mehrere Ports durch ein Leerzeichen angeben:

listen 80 8080;

Diese Direktive gibt an, dass der Server auf eingehende Verbindungen an den Ports 80 und 8080 wartet.

Wenn Sie Verbindungen an einem bestimmten Port abhören und das HTTPS-Protokoll verwenden möchten, verwenden Sie eine Direktive ssl:

listen 443 ssl;

Dies bedeutet, dass der Server eingehende Verbindungen an Port 443 mithilfe des HTTPS-Protokolls abhört.

Das Konfigurieren von Ports und das Abhören von Adressen ist ein wichtiger Teil der Konfiguration von Nginx, da es bestimmt, an welchen Adressen und Ports der Server für eingehende Verbindungen verfügbar sein wird. Verwenden Sie Richtlinien listen und ssl um diese Einstellungen in Ihrer Konfigurationsdatei zu konfigurieren.