Nginx. Modul verwalten

Dieser Artikel behandelt die Verwaltung des Nginx-Moduls als Ganzes: Starten und Stoppen des Service, Neuladen der Konfiguration, Aktualisieren und Deinstallieren des Moduls. Virtuelle Hosts, Locations und SSL sind in einem separaten Artikel beschrieben — Nginx. Arbeiten mit virtuellen Hosts.

Service verwalten

Auf der Modulseite stehen folgende Aktionen für den Nginx-Service zur Verfügung:

• „Start“ — startet den Service, wenn er gestoppt ist.
• „Stopp“ — schaltet den Service ab. Alle Sites auf diesem Nginx antworten nicht mehr, Besucher erhalten einen Verbindungsfehler.
• „Neustart“ — stoppt den Service und startet ihn sofort wieder. Offene Verbindungen werden getrennt. Nützlich nach einer manuellen Konfigurationsänderung, wenn der Service garantiert frisch hochgefahren werden soll.
• „Konfiguration neu laden“ — wendet die neue Konfiguration an, ohne aktive Client-Verbindungen zu trennen. Nützlich nach manuellen Anpassungen der Virtual-Host-Konfigurationen.

⚠️ Den Service bei laufenden Sites zu stoppen ist riskant

Solange der Service angehalten ist, sind alle von diesem Nginx bedienten Sites nicht erreichbar — Besucher sehen einen Verbindungsfehler. Planen Sie Stopps und Neustarts in einem Wartungsfenster ein.

Modul aktualisieren

Um das Modul zu aktualisieren, wählen Sie im Aktionsmenü des Moduls „Nginx aktualisieren“. Das BeAdmin-Panel prüft, ob eine neuere Version verfügbar ist, und installiert sie gegebenenfalls über die aktuelle. Virtuelle Hosts, Locations und ausgestellte SSL-Zertifikate bleiben erhalten. Nach der Aktualisierung wird der Service automatisch neu gestartet.

Während die Aktualisierung läuft, sind Service-Aktionen und Punkte der Modulverwaltung nicht verfügbar — warten Sie den Abschluss ab.

Modul deinstallieren

Um das Modul zu deinstallieren, wählen Sie im Aktionsmenü des Moduls „Nginx deinstallieren“. Das BeAdmin-Panel fragt in einem Dialog nach einer Bestätigung.

‼️ Beim Deinstallieren des Moduls geht die Nginx-Konfiguration verloren

Die Aktion ist nicht rückgängig zu machen: Zusammen mit dem Modul werden alle virtuellen Hosts, Locations und Nginx-Logs entfernt. Ausgestellte Let's-Encrypt-SSL-Zertifikate und Site-Dateien in den DocumentRoot-Verzeichnissen bleiben auf der Festplatte, werden aber ohne die vhost-Konfigurationen des Panels nicht mehr ausgeliefert. Nach einer erneuten Installation des Moduls müssen die virtuellen Hosts neu angelegt und die SSL-Zertifikate erneut ausgestellt werden.

Siehe auch

• Nginx. Schnellstart — Installation des Moduls und erste Site.
• Nginx. Arbeiten mit virtuellen Hosts — Anlegen und Bearbeiten virtueller Hosts, Locations und SSL.
• Behebung von ACME-Fehlern bei der Ausstellung eines SSL-Zertifikats — typische ACME-Fehler und wie man sie analysiert.