SSD Nodes Learn Hosting plans →
Anleitungen Matt ConnorVon Matt Connor

NGINX2Root: Das gebündelte nginx in GitLab absichern

apt upgrade schützt Ihr GitLab nicht vor NGINX2Root, denn das Linux-Paket bringt nginx 1.31.7 selbst mit. So prüfen Sie die Version, schalten HTTP/2 ab und erkennen den Fix.

Warum NGINX2Root Ihr GitLab betrifft

NGINX2Root trifft auch selbst betriebenes GitLab, denn das Linux-Paket (früher Omnibus genannt) bringt sein eigenes nginx mit. Ein apt upgrade auf dem Server ändert daran nichts. Stand 20. November 2026 enthält keine GitLab-Version das reparierte nginx 1.31.9 oder 1.30.7. Auch das Patch-Release 19.6.1 vom 20. November ändert nginx nicht.

Bis ein GitLab-Paket mit repariertem nginx erscheint, haben Sie drei Aufgaben. Erstens prüfen Sie, welche nginx-Version in GitLab wirklich läuft. Zweitens entscheiden Sie, ob Sie HTTP/2 vorübergehend abschalten. Drittens beobachten Sie die Stellen, an denen GitLab den Fix ankündigen wird. Diese Anleitung geht alle drei Schritte durch. Sie gilt für das Linux-Paket auf Debian, Ubuntu und RHEL-Systemen. Sie gilt auch für das Docker-Image gitlab/gitlab-ce, das auf demselben Paket aufbaut.

Viele Hochschulen, Forschungsgruppen und mittelständische Firmen betreiben GitLab selbst. Oft läuft es auf einer einzelnen VM, die einmal eingerichtet wurde und seitdem niemand mehr anfasst. Genau dort fällt eine Lücke im mitgelieferten Webserver leicht durch das Raster. Der Grund: Die übliche Patch-Routine erfasst nur die Pakete der Distribution.

Die fünf Lücken in Kürze

Die Sicherheitsfirma Xint hat NGINX2Root am 18. November 2026 veröffentlicht. Xint beschreibt es als Sammlung von fünf kritischen CVEs (Common Vulnerabilities and Exposures, die öffentliche Nummerierung von Sicherheitslücken). Die schwerste Lücke erlaubt laut Xint einem Angreifer ohne Anmeldung, Befehle auf einem nginx-Server mit aktiviertem HTTP/2 auszuführen. Die betroffenen Versionen laut nginx.org:

  • CVE-2026-123007: Integer-Überlauf in der HTTP/2-Flusskontrolle, nginx 1.9.5 bis 1.31.8, von nginx.org als major eingestuft.
  • CVE-2026-123633: Use-after-free in HTTP/2, wenn Anfragen an einen Upstream (Backend-Server) weitergeleitet werden, nginx 1.19.7 bis 1.31.8.
  • CVE-2026-123634: betrifft resolver zusammen mit einem aus der Anfrage abgeleiteten proxy_pass-Ziel und mirror mit mirror_request_body off, nginx 0.6.18 bis 1.31.8.
  • CVE-2026-121810: HTTP/3 mit Weiterleitung an einen Upstream, nginx 1.25.0 bis 1.31.8.
  • CVE-2026-113425: Mail-Proxy mit proxy on und auth_http, nginx 0.5.33 bis 1.31.8, ebenfalls major.

nginx.org hat am 18. November 2026 die Versionen 1.31.9 (mainline) und 1.30.7 (stable) veröffentlicht. Beide beheben alle fünf Lücken. Als nicht verwundbar gelten laut nginx.org 1.31.9 und neuer sowie 1.30.7 und neuer.

Das in GitLab 19.6 gebündelte nginx 1.31.7 liegt in allen fünf Bereichen. Ob jede einzelne Lücke auf Ihrem Server erreichbar ist, hängt vom Build und von der Konfiguration ab. Für die HTTP/2-Lücken lautet die Antwort aber meist ja. GitLab schaltet HTTP/2 standardmäßig ein, sobald die Instanz über HTTPS erreichbar ist.

Warum apt upgrade das gebündelte nginx nicht repariert

Das Linux-Paket von GitLab bringt laut Dokumentation alle Abhängigkeiten mit, die GitLab braucht. nginx ist eine davon. Es liegt unter /opt/gitlab/embedded und gehört zum Paket gitlab-ce oder gitlab-ee. Mit dem Paket nginx Ihrer Distribution hat es nichts zu tun.

Das sieht man an den Upgrade-Hinweisen zu GitLab 19.6. Dort steht, dass 19.6 das gebündelte nginx von 1.31.4 auf 1.31.7 hebt. Das war ein GitLab-Release, kein Distributions-Update. Daraus folgt: Die nginx-Version in GitLab ändert sich nur, wenn Sie ein neues GitLab-Paket installieren. Die fünf CVEs, die 19.6 damit behoben hat, sind übrigens andere als die von NGINX2Root.

Ein apt upgrade holt ein neues gitlab-ce nur, wenn das GitLab-Repository eingerichtet ist und das Paket nicht gesperrt ist. Selbst dann bringt es heute keinen Schutz, weil es noch kein GitLab-Paket mit nginx 1.31.9 gibt. Ein eventuell installiertes Distributions-nginx wird zwar aktualisiert. In einer Standardinstallation bedient es aber nicht GitLab.

Welche nginx-Version läuft in Ihrem GitLab?

Der dokumentierte Weg ist die Datei /opt/gitlab/version-manifest.txt. Laut GitLab steht dort nach der Installation die Version von GitLab und aller gebündelten Bibliotheken.

grep -i nginx /opt/gitlab/version-manifest.txt

Die Zeile mit nginx nennt die gebündelte Version. Liegt sie unter 1.31.9 und ist es auch keine 1.30.7 oder neuer, ist Ihr GitLab-nginx von NGINX2Root betroffen.

Sie können zusätzlich das Programm selbst fragen. Den Pfad nennt die GitLab-Dokumentation allerdings nicht. Er folgt nur aus dem Build-Präfix /opt/gitlab/embedded im Bauskript von omnibus-gitlab. Prüfen Sie deshalb zuerst, ob die Datei existiert:

ls -l /opt/gitlab/embedded/sbin/nginx
sudo /opt/gitlab/embedded/sbin/nginx -v

Meldet ls den Fehler No such file or directory, verlassen Sie sich auf das Manifest. Ein nacktes nginx -v hilft hier nicht. Es fragt das erste nginx in Ihrem PATH, und die Ausgabe verrät nicht, ob das GitLabs Kopie ist. Mit command -v nginx sehen Sie, welche Datei gemeint ist.

Die installierte GitLab-Version zeigt Ihnen der Paketmanager:

apt-cache policy gitlab-ce

Auf RHEL, Rocky oder Alma nutzen Sie rpm -q gitlab-ce. Für die Enterprise Edition ersetzen Sie jeweils gitlab-ce durch gitlab-ee.

Im Docker-Container steckt dasselbe Linux-Paket. Ersetzen Sie gitlab durch den Namen Ihres Containers:

docker exec gitlab grep -i nginx /opt/gitlab/version-manifest.txt

Zuerst das Patch-Release 19.6.1 einspielen

Am 20. November 2026 hat GitLab die Versionen 19.6.1, 19.5.8 und 19.4.10 als kritisches Patch-Release veröffentlicht. Es behebt CVE-2026-132825, einen Heap-Pufferüberlauf in Ruby bei der Umwandlung von Groß- und Kleinschreibung in Strings. Die Einträge zum Ruby-Update auf 3.3.14 und 3.4.13 stehen nur unter 19.6.1. Unter 19.5.8 und 19.4.10 stehen unter anderem ein Update von PostgreSQL auf 18.7 und 17.12 sowie des webauthn-Gems auf 3.4.4. Ein nginx-Update steht nicht in der Ankündigung. Der einzige nginx-Eintrag ist eine Konfigurationsänderung am Smartcard-Server.

Spielen Sie es trotzdem ein, wegen der Ruby-Lücke. Der Befehl aus der GitLab-Dokumentation für Debian und Ubuntu lautet:

sudo apt update && sudo apt install gitlab-ce

Auf RHEL-Systemen lautet er sudo dnf upgrade gitlab-ce. Wer eine bestimmte Version festlegen will, schreibt sie mit, zum Beispiel gitlab-ee=<version>-ee.0. Passiert nichts, ist das Paket vielleicht gesperrt. apt-mark showhold listet gesperrte Pakete. Machen Sie vor jedem GitLab-Upgrade ein Backup nach der GitLab-Dokumentation.

Für Docker ziehen Sie ein neueres Image-Tag und erstellen den Container neu. Mit Compose ändern Sie die Version in der docker-compose.yml. Dann führen Sie docker compose pull und docker compose up -d aus. GitLab empfiehlt, in Produktion eine feste Version zu verwenden. Beim ersten Start konfiguriert und aktualisiert sich GitLab selbst. Laut Docker-Anleitung sichern Sie vorher mindestens die Datenbank und die GitLab-Secrets-Datei.

Übergangslösung: HTTP/2 im gebündelten nginx abschalten

Das gebündelte nginx wird immer mit --with-http_v2_module gebaut. Ob HTTP/2 wirklich aktiv ist, entscheidet also nicht der Build. Es entscheidet die Konfiguration, die GitLab erzeugt. Laut GitLab ist HTTP/2 an, sobald die Instanz über HTTPS erreichbar ist.

Die GitLab-Dokumentation nennt den folgenden Schalter. Tragen Sie ihn in /etc/gitlab/gitlab.rb ein:

gitlab_rails['nginx']['http2_enabled'] = false

Danach erzeugen Sie die Konfiguration neu:

sudo gitlab-ctl reconfigure

Laut GitLab liegen die nginx-Einstellungen für die Rails-Anwendung seit GitLab 19.2 unter gitlab_rails['nginx'][...]. In Foren kursiert auch die Zeile nginx['http2_enabled'] = false. Die aktuelle GitLab-Dokumentation nennt diesen Schlüssel nicht. Verlassen Sie sich auf keinen der beiden Schlüssel, bevor Sie das Ergebnis geprüft haben.

Prüfen, ob HTTP/2 wirklich aus ist

Die erzeugte nginx-Konfiguration liegt unter /var/opt/gitlab/nginx/conf/. Suchen Sie dort nach http2, einmal vor und einmal nach der Änderung:

sudo grep -rn http2 /var/opt/gitlab/nginx/conf/

Vergleichen Sie die beiden Ausgaben. Welche Datei die Zeile enthält und wie sie genau aussieht, hängt von der GitLab-Version ab. Entscheidend ist, dass sich die Treffer für die GitLab-Anwendung nach reconfigure geändert haben.

Der zuverlässigere Test kommt von außen. Fragen Sie den Server von einem anderen Rechner aus, welches Protokoll er aushandelt. Ersetzen Sie gitlab.example.com durch Ihre Adresse:

curl -sI --http2 https://gitlab.example.com/ | head -n 1

Beginnt die Zeile mit HTTP/2, spricht der Server weiterhin HTTP/2. Die Änderung wirkt dann nicht. Beginnt sie mit HTTP/1.1, ist HTTP/2 aus. Dieser Test setzt ein curl mit HTTP/2-Unterstützung voraus: curl -V muss unter Features den Eintrag HTTP2 zeigen. Zeigt curl weiterhin HTTP/2, starten Sie nginx mit sudo gitlab-ctl restart nginx neu und testen erneut.

Im Docker-Betrieb tragen Sie die Zeile in die gemountete gitlab.rb ein oder in die Variable GITLAB_OMNIBUS_CONFIG. Laut GitLab bleibt der Inhalt dieser Variable zwischen zwei Starts nicht erhalten. Wer mit docker run arbeitet, muss sie also bei jedem Start erneut setzen. In einer Compose-Datei steht sie ohnehin bei jedem Start drin.

Was diese Übergangslösung nicht leistet

Xint sagt klar: Das Abschalten von HTTP/2 blockiert nur CVE-2026-123007 und CVE-2026-123633. Die anderen drei Lücken schließt es nicht. Zwei davon erreicht ein Angreifer im gebündelten nginx allerdings gar nicht: Laut Bauskript config/software/nginx.rb wird es weder mit --with-http_v3_module noch mit --with-mail gebaut, also ohne HTTP/3 und ohne Mail-Proxy. Daran ändert auch keine Einstellung in der gitlab.rb etwas. Offen bleibt die Resolver-Lücke CVE-2026-123634. Ob sie auf Ihrem GitLab erreichbar ist, hängt davon ab, ob die oben genannten Funktionen in Ihrer Konfiguration aktiv sind. Den echten Schutz bringt nur ein reparierter nginx-Build.

Zweitens gilt der Schalter laut GitLab nur für die Haupt-Anwendung. GitLab Pages und die Container Registry deckt er nicht ab.

Drittens kann der Schalter den Agent for Kubernetes stören. Seit GitLab 19.5 meldet das Linux-Paket den Agenten eine native gRPC-Adresse (grpcs://), wenn das gebündelte nginx TLS (Transport Layer Security) mit HTTP/2 beendet. gRPC ist ein Protokoll für Programmaufrufe über das Netz, und es braucht HTTP/2 auf der ganzen Strecke. Laut GitLab scheitern neue Agenten, wenn ein Proxy dazwischen kein HTTP/2 durchreicht. Ob der HTTP/2-Schalter die gemeldete Adresse ändert, dokumentiert GitLab nicht. Testen Sie Ihre Agenten deshalb nach der Änderung. WebSocket bleibt laut GitLab verfügbar. Mit gitlab_rails['gitlab_kas_external_url'] können Sie die Agenten bei WebSocket halten. Die genaue Syntax steht in den Upgrade-Hinweisen zu GitLab 19.

Der längere Weg: ein externes nginx aus der Distribution

Wer nicht auf GitLab warten will, kann das gebündelte nginx abschalten und ein eigenes nginx davorsetzen. Die GitLab-Dokumentation beschreibt dafür zwei Einstellungen in /etc/gitlab/gitlab.rb:

nginx['enable'] = false
web_server['external_users'] = ['www-data']

Danach folgt wieder sudo gitlab-ctl reconfigure. external_users ist eine Liste. Die genannten Benutzer kommen in die Gruppe gitlab-www. Das Linux-Paket hat für diesen Benutzer keinen Standardwert, also müssen Sie ihn setzen. Das Beispiel der Dokumentation nennt www-data. Tragen Sie den Benutzer ein, unter dem Ihr nginx tatsächlich läuft.

Bedenken Sie zwei Punkte. Erstens stellt GitLab diese Anleitung ausdrücklich nur zur Orientierung bereit. Die Seite enthält keine fertige nginx-Konfiguration für den externen Server. Den Server-Block mit TLS und Weiterleitung an GitLab schreiben und pflegen Sie selbst. Wie Weiterleitungen und Header in nginx funktionieren, erklärt unsere Erklärung der nginx-Reverse-Proxy-Konfiguration.

Zweitens ist dieser Weg nur sinnvoll, wenn das nginx Ihrer Distribution die fünf Lücken schon schließt. Distributionen spielen Fixes oft als Backport ein, ohne die Versionsnummer zu ändern. Deshalb zählt der Sicherheits-Tracker Ihrer Distribution, nicht die Ausgabe von nginx -v. Für Debian ist das der Security Tracker, für Ubuntu die CVE-Datenbank von Canonical. Suchen Sie dort jede der fünf CVE-Nummern für Ihr Release. Wie Sie solche Abfragen regelmäßig und für alle Pakete erledigen, zeigt die Anleitung zum Prüfen Ihres Servers auf bekannte CVEs.

Für die meisten Teams ist das zu viel Umbau für eine Lücke, die GitLab mit einem kommenden Release schließen dürfte. Der Weg lohnt sich eher, wenn Sie ohnehin einen zentralen Reverse Proxy für mehrere Dienste betreiben.

Helm-Chart und Kubernetes

Installationen über das Helm-Chart nutzen das gebündelte nginx des Linux-Pakets nicht. Das steht ausdrücklich im Upgrade-Hinweis zu GitLab 19.6. Seit GitLab 19.0 setzt das Chart standardmäßig auf die Gateway API mit dem mitgelieferten Envoy Gateway. Das gebündelte NGINX Ingress ist seitdem abgeschaltet. Es gilt seit 18.9 als veraltet und soll mit GitLab 20.0 entfallen. GitLab weist außerdem darauf hin, dass das Upstream-NGINX-Ingress nach März 2026 keine Sicherheitspatches mehr bekommt.

Läuft vor Ihrem GitLab trotzdem ein Ingress-Controller auf nginx-Basis, prüfen Sie dessen Version. Ob er von den fünf CVEs betroffen ist, steht auf keiner GitLab-Seite. Lesen Sie das Advisory des Herstellers Ihres Controllers.

Woran Sie den echten Fix erkennen

Stand 20. November 2026 legt das Bauskript config/software/nginx.rb im Projekt omnibus-gitlab die Version release-1.31.7 fest. Das gilt auf master und auf den Zweigen 19-4-stable, 19-5-stable und 19-6-stable. Das beschreibt den Quellcode, nicht ein veröffentlichtes Paket. Es zeigt aber, dass noch keine nginx-Änderung auf dem Weg in die stabilen Zweige ist.

Drei Stellen sollten Sie beobachten:

Nach dem Update auf ein solches Release prüfen Sie erneut das Manifest. Es muss nginx 1.31.9 oder neuer nennen, oder 1.30.7 oder neuer. Prüfen Sie dann, ob der laufende Prozess neu ist. Xint weist darauf hin, dass ein bloßes Neuladen der Konfiguration die laufende Programmdatei nicht ersetzt.

sudo gitlab-ctl status nginx

Die Ausgabe zeigt, seit wie vielen Sekunden nginx läuft. Ist der Prozess älter als Ihr Update, starten Sie ihn mit sudo gitlab-ctl restart nginx neu. Erst danach entfernen Sie die Zeile gitlab_rails['nginx']['http2_enabled'] = false wieder und führen sudo gitlab-ctl reconfigure aus.

Die Schritte in Kurzform

  1. Version prüfen mit grep -i nginx /opt/gitlab/version-manifest.txt.
  2. Das Patch-Release 19.6.1, 19.5.8 oder 19.4.10 einspielen, wegen der Ruby-Lücke.
  3. HTTP/2 mit gitlab_rails['nginx']['http2_enabled'] = false abschalten, reconfigure ausführen und mit curl von außen prüfen.
  4. Den Agent for Kubernetes nach der Änderung testen.
  5. Upgrade-Hinweise und Patch-Ankündigungen beobachten und nach dem nginx-Update den Prozess neu starten.

Finden Sie in den Logs Hinweise, dass jemand die Lücke schon ausgenutzt hat, reicht ein Patch nicht mehr. Dann brauchen Sie einen geordneten Ablauf, wie ihn ein Notfallplan für kleine Teams beschreibt. Wer nach diesem Vorfall überlegt, ob eine schlankere Lösung mit weniger gebündelten Komponenten besser passt, findet einen Überblick in unserem Vergleich selbst gehosteter Git-Server.

FAQ

Hilft apt upgrade bei GitLab gegen NGINX2Root?

Nein, nicht für das nginx, das GitLab ausliefert. Das Linux-Paket bringt nginx unter /opt/gitlab/embedded selbst mit, und diese Version ändert sich nur mit einem neuen GitLab-Paket. Stand 20. November 2026 enthält kein GitLab-Release das reparierte nginx 1.31.9 oder 1.30.7. Prüfen Sie die gebündelte Version mit grep -i nginx /opt/gitlab/version-manifest.txt.

Mit welcher Einstellung schalte ich HTTP/2 in GitLab ab?

Die GitLab-Dokumentation nennt gitlab_rails['nginx']['http2_enabled'] = false in /etc/gitlab/gitlab.rb, gefolgt von sudo gitlab-ctl reconfigure. Der in Foren genannte Schlüssel nginx['http2_enabled'] steht nicht in der aktuellen Dokumentation. Prüfen Sie das Ergebnis von außen mit curl -sI --http2 https://gitlab.example.com/ | head -n 1. Die Zeile muss mit HTTP/1.1 beginnen.

Reicht es, HTTP/2 abzuschalten?

Nein. Laut Xint blockiert das nur CVE-2026-123007 und CVE-2026-123633. Die Resolver-Lücke CVE-2026-123634 bleibt bestehen. HTTP/3 und den Mail-Proxy enthält das gebündelte nginx laut Bauskript gar nicht. Außerdem gilt der GitLab-Schalter nur für die Haupt-Anwendung, nicht für Pages oder die Container Registry. Den vollständigen Schutz bringt erst ein GitLab-Paket mit nginx 1.31.9 oder 1.30.7.

Ist mein GitLab aus dem Helm-Chart betroffen?

Nicht über das gebündelte nginx, denn das Helm-Chart nutzt es laut GitLab nicht. Seit GitLab 19.0 verwendet das Chart standardmäßig Envoy Gateway. Betreiben Sie trotzdem einen Ingress-Controller auf nginx-Basis, prüfen Sie dessen Version und das Advisory seines Herstellers.

Woran erkenne ich, dass GitLab den nginx-Fix ausliefert?

Achten Sie in den Upgrade-Hinweisen zu GitLab 19 und in den Patch-Release-Ankündigungen auf eine Zeile zum NGINX-Update. Nach der Installation muss /opt/gitlab/version-manifest.txt nginx 1.31.9 oder neuer nennen, oder 1.30.7 oder neuer. Zeigt sudo gitlab-ctl status nginx danach einen Prozess, der älter ist als das Update, starten Sie nginx mit sudo gitlab-ctl restart nginx neu.

War dieser Artikel hilfreich?

#gitlab#nginx#security#cve#http2