nginx unter Debian aktualisieren (Paket und nginx.org)

nginx unter Debian sicher aktualisieren: Version prüfen, Paket aus Debian oder dem offiziellen nginx.org-Repository updaten, Konfiguration testen.

Stand: November 2026. Beschrieben für Debian 12 „bookworm“ (nginx 1.22.1 aus Debian) und Debian 13 „trixie“ (nginx 1.26.3 aus Debian). Auf nginx.org sind zu diesem Zeitpunkt die Versionen 1.30.7 (stable) und 1.31.9 (mainline) aktuell.

Diese Anleitung zeigt, wie du nginx unter Debian auf den neuesten Stand bringst. Es gibt zwei Wege: Du bleibst beim Paket aus Debian und spielst dessen Sicherheitsupdates ein, oder du wechselst auf das offizielle Repository von nginx.org, das neuere Versionen liefert. Alle Befehle führst du als root aus.

Kurz gesagt (Update des Debian-Pakets):

apt update
apt install --only-upgrade nginx
nginx -t && systemctl restart nginx

nginx -t prüft die Konfiguration. Nur wenn die Prüfung erfolgreich ist, startet nginx neu.

Voraussetzungen

cp -a /etc/nginx /root/nginx-sicherung-$(date +%F)

Schritt 1: Installierte Version und Paketquelle prüfen

  1. Zeige die installierte Version an:

nginx -v

Mit nginx -V siehst du zusätzlich die Compiler-Version und die Build-Parameter, zum Beispiel die eingebauten Module.

  1. Prüfe, aus welcher Quelle das Paket stammt und welche Version verfügbar ist:

apt update
apt policy nginx

In der Ausgabe steht hinter Installed die installierte und hinter Candidate die Version, die beim nächsten Update installiert würde. Darunter folgen die Quellen: deb.debian.org bzw. security.debian.org steht für das Debian-Paket, nginx.org für das offizielle nginx-Repository.

Wichtig für die Einordnung: Debian bleibt innerhalb einer Version bei derselben nginx-Hauptversion. Sicherheitslücken werden dort durch Updates des Pakets geschlossen, erkennbar am Zusatz hinter der Versionsnummer (zum Beispiel 1.22.1-9+deb12u11). Eine niedrige Versionsnummer allein bedeutet also nicht, dass dein nginx ungepatcht ist.

Schritt 2: Update aus Debian einspielen

Diesen Weg empfehlen wir, solange du keine Funktion einer neueren nginx-Version brauchst.

  1. Lade die Paketlisten neu:

apt update
  1. Aktualisiere nur nginx und die zugehörigen Pakete:

apt install --only-upgrade nginx

--only-upgrade installiert ausschließlich Updates für bereits installierte Pakete. Alternativ aktualisierst du alle Pakete des Systems:

apt upgrade
  1. Prüfe die Konfiguration und starte nginx neu, damit das aktualisierte Programm läuft:

nginx -t && systemctl restart nginx
  1. Kontrolliere den Dienst und die Version:

systemctl status nginx
nginx -v

Schritt 3: Auf das offizielle nginx.org-Repository wechseln

Das Repository von nginx.org liefert aktuelle Versionen direkt vom Hersteller. Laut nginx.org werden Debian 12 und 13 auf x86_64 und aarch64/arm64 unterstützt. Die folgenden Befehle entsprechen der Anleitung auf nginx.org (dort mit sudo, hier als root).

  1. Installiere die benötigten Pakete:

apt install curl gnupg2 ca-certificates lsb-release debian-archive-keyring
  1. Lade den Signaturschlüssel von nginx.org und speichere ihn als eigenen Schlüsselbund:

curl https://nginx.org/keys/nginx_signing.key | gpg --dearmor \
    | tee /usr/share/keyrings/nginx-archive-keyring.gpg >/dev/null
  1. Prüfe den Fingerabdruck des Schlüssels:

gpg --dry-run --quiet --no-keyring --import --import-options import-show /usr/share/keyrings/nginx-archive-keyring.gpg

Die Ausgabe muss den Fingerabdruck 573BFD6B3D8FBC641079A6ABABF5BD827BD9BF62 enthalten. Sie kann weitere Schlüssel enthalten, mit denen nginx.org Pakete signiert. Steht der Fingerabdruck nicht in der Ausgabe, lösche die Datei /usr/share/keyrings/nginx-archive-keyring.gpg und brich ab.

  1. Richte die Paketquelle ein. Für die Variante stable:

echo "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg] \
https://nginx.org/packages/debian `lsb_release -cs` nginx" \
    | tee /etc/apt/sources.list.d/nginx.list

Möchtest du stattdessen die Variante mainline nutzen:

echo "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg] \
https://nginx.org/packages/mainline/debian `lsb_release -cs` nginx" \
    | tee /etc/apt/sources.list.d/nginx.list

Für Produktivserver empfehlen wir stable. signed-by sorgt dafür, dass apt Pakete aus dieser Quelle nur mit dem Schlüssel von nginx.org akzeptiert.

  1. Lege das Pinning an. Es sorgt dafür, dass apt die Pakete von nginx.org den Debian-Paketen vorzieht:

echo -e "Package: *\nPin: origin nginx.org\nPin: release o=nginx\nPin-Priority: 900\n" \
    | tee /etc/apt/preferences.d/99nginx

Die Datei /etc/apt/preferences.d/99nginx enthält danach:

Package: *
Pin: origin nginx.org
Pin: release o=nginx
Pin-Priority: 900
  1. Lade die Paketlisten neu und prüfe, dass jetzt nginx.org als Quelle für den Candidate erscheint:

apt update
apt policy nginx
  1. Installiere nginx aus dem neuen Repository:

apt install nginx

Fragt apt, ob Konfigurationsdateien wie /etc/nginx/nginx.conf ersetzt werden sollen, lies die Meldung genau. Deine bisherige Konfiguration liegt in jedem Fall in der Sicherung aus den Voraussetzungen.

  1. Prüfe die Konfiguration, bevor nginx neu startet (siehe Schritt 4). Das nginx.org-Paket ist anders aufgebaut als das Debian-Paket: Seine Standardkonfiguration bindet Dateien aus /etc/nginx/conf.d/*.conf ein und lässt nginx als Benutzer nginx laufen. Das Debian-Paket nutzt dagegen /etc/nginx/sites-enabled/ und den Benutzer www-data. Übernimm deine Server-Blöcke deshalb gezielt, zum Beispiel als Dateien in /etc/nginx/conf.d/. Zeilen, die Debian-Module laden (etwa include /etc/nginx/modules-enabled/*.conf;), passen nicht zum nginx.org-Paket.

Schritt 4: Konfiguration mit nginx -t testen und neu laden

Teste die Konfiguration nach jeder Änderung und nach jedem Update, bevor du nginx neu lädst:

nginx -t

nginx prüft dabei die Syntax und versucht, alle in der Konfiguration genannten Dateien zu öffnen. Bei Erfolg endet die Ausgabe mit test is successful. Mit nginx -T gibt nginx zusätzlich die vollständige Konfiguration aus, das hilft bei der Fehlersuche.

Nach einer Änderung an der Konfiguration genügt ein Neuladen. nginx startet dabei neue Arbeitsprozesse mit der neuen Konfiguration und beendet die alten, sobald sie ihre Anfragen abgeschlossen haben:

nginx -t && systemctl reload nginx

Nach einem Update des Programms startest du nginx dagegen neu, damit die neue Version läuft. Das unterbricht laufende Verbindungen kurz:

nginx -t && systemctl restart nginx

Rücksprung auf das Debian-Paket (Downgrade)

Läuft nginx nach dem Wechsel nicht wie gewünscht, kehre zum Debian-Paket zurück.

  1. Entferne Paketquelle und Pinning von nginx.org und lade die Paketlisten neu:

rm /etc/apt/sources.list.d/nginx.list /etc/apt/preferences.d/99nginx
apt update
  1. Zeige die verfügbaren Versionen an. Notiere die Versionsnummer, die aus deb.debian.org oder security.debian.org stammt:

apt policy nginx
  1. Installiere diese Version gezielt. Ersetze <Version> durch die notierte Nummer:

apt install nginx=<Version>

apt warnt dabei, dass ein Paket auf eine ältere Version zurückgesetzt wird. Meldet apt fehlende oder unpassende Abhängigkeiten, gib die zugehörigen Debian-Pakete mit derselben Versionsnummer zusätzlich an, zum Beispiel nginx-common=<Version>.

  1. Stelle bei Bedarf deine Konfiguration aus der Sicherung wieder her, prüfe sie und starte nginx neu:

nginx -t && systemctl restart nginx

Wenn es nicht klappt

Häufige Fragen

Wie finde ich heraus, welche nginx-Version installiert ist?

Mit nginx -v. Ob das Paket aus Debian oder von nginx.org stammt, zeigt apt policy nginx.

Ist das nginx-Paket aus Debian veraltet?

Nicht im Sinne der Sicherheit. Debian behält innerhalb einer Version die nginx-Hauptversion bei und schließt Sicherheitslücken über Paketupdates. Neue Funktionen bekommst du aber erst mit der nächsten Debian-Version oder über das Repository von nginx.org.

Reicht systemctl reload nach einem Update?

Für Änderungen an der Konfiguration ja. Nach einem Update des Programms startest du nginx mit systemctl restart nginx neu, damit die neue Version läuft. Prüfe vorher immer mit nginx -t.

Soll ich stable oder mainline verwenden?

Für Produktivserver empfehlen wir stable. Mainline wählst du, wenn du eine Funktion brauchst, die es nur in der neuesten Version gibt. Beide Varianten richtest du wie in Schritt 3 beschrieben ein, der Unterschied liegt nur in der Zeile der Paketquelle.

Wie aktualisiere ich nginx später, wenn ich das nginx.org-Repository nutze?

Genauso wie jedes andere Paket: apt update und apt install --only-upgrade nginx, danach nginx -t && systemctl restart nginx.

Verwandte Artikel

Unterstützung durch Dawico

Du kommst an einer Stelle nicht weiter oder möchtest Aufgaben wie diese abgeben? Die Dawico Deutschland GmbH ist seit 2008 IT-Dienstleister. Sprich uns an: telefonisch unter 030 8878680 oder über unsere Kontaktseite. Mehr zur laufenden IT-Betreuung durch Dawico.

Du bist bereits Kunde? Dann erreichst du uns über das Ticket-System oder per Fernwartung und Support.