Thomas.will@claude: Neue Seite: fehlte, war aber schon von drei Seiten verlinkt

2026-10-31T15:16:47Z

Neue Seite: fehlte, war aber schon von drei Seiten verlinkt

Neue Seite

Einstieg in Nginx: Installation, Verzeichnisstruktur, der erste Server-Block und wie man Änderungen übernimmt, ohne den Dienst lahmzulegen. Vertiefung in [[Nginx Reverse Proxy und Load Balancing]]. Dazu die Animation [https://xinux.org/nginx-grundkonfiguration.html Nginx: Grundkonfiguration] ([https://xinux.org/nginx-grundkonfiguration-einfach.html einfach]).

== Installation ==

<pre>
# Debian/Ubuntu
sudo apt install nginx

# Rocky/RHEL (ggf. vorher epel-release)
sudo dnf install nginx
</pre>

<pre>
sudo systemctl enable --now nginx
sudo systemctl status nginx
</pre>

'''Erster Verdacht bei "geht nicht von außen":''' Nginx läuft und antwortet lokal, trotzdem kommt von einem anderen Rechner nichts an – meist blockiert die lokale Firewall (<code>ufw</code>, <code>firewalld</code>) Port 80/443, nicht Nginx selbst.

== Verzeichnisstruktur ==

{| class="wikitable"
! Pfad !! Zweck
|-
| <code>/etc/nginx/nginx.conf</code> || Hauptkonfiguration, lädt die anderen Dateien per <code>include</code>
|-
| <code>/etc/nginx/conf.d/*.conf</code> bzw. <code>sites-available</code>/<code>sites-enabled</code> || eingebundene Server-Blöcke – <code>sites-*</code> nur bei Debian/Ubuntu üblich, bei Rocky/RHEL meist direkt <code>conf.d</code>
|-
| <code>/var/www/html</code> || Standard-Webroot, per <code>root</code> frei änderbar
|-
| <code>/var/log/nginx/access.log</code>, <code>error.log</code> || erster Blick bei jeder Störung
|}

<code>sudo nginx -T</code> gibt die komplette, tatsächlich geladene Konfiguration aus.

== Der erste Server-Block ==

<pre>
server {
listen 80;
server_name example.com;
root /var/www/html;
index index.html;

location / {
try_files $uri $uri/ =404;
}
}
</pre>

<code>try_files $uri $uri/ =404;</code> prüft erst die Datei, dann das Verzeichnis, sonst eine 404-Antwort. Fehlt die Index-Datei und ist kein passender <code>location</code>-Block da, antwortet Nginx mit 403 Forbidden (kein Directory Listing erlaubt) oder 404 – nicht mit einer Meldung über die fehlende Datei selbst.

== Sicher ändern ==

<pre>
sudo nginx -t && sudo systemctl reload nginx
</pre>

<code>nginx -t</code> prüft nur die Syntax, ohne etwas zu verändern. <code>systemctl reload</code> übernimmt eine gültige Konfiguration ohne Verbindungsabbruch – anders als <code>restart</code>, der den Dienst kurz komplett beendet: Bei einem Tippfehler in der Konfiguration kommt er danach nicht mehr hoch, und die Seite ist für alle weg. Das <code>&&</code> sorgt dafür, dass bei einem Syntaxfehler gar nicht erst neu geladen wird.

== Mehrere Sites ==

Mehrere <code>server</code>-Blöcke können denselben Port teilen. <code>server_name</code> entscheidet anhand des Host-Headers, welcher Block zuständig ist – nicht die Reihenfolge im Config.

<pre>
server {
listen 80;
server_name a.example.com;
root /srv/a;
}
server {
listen 80;
server_name b.example.com;
root /srv/b;
}
</pre>

'''Wichtig:''' <code>server_name</code> erzeugt keinen DNS-Eintrag. Ohne passenden DNS-Eintrag, der auf diesen Server zeigt, landet eine Anfrage nie hier. <code>listen 80 default_server;</code> fängt alle Anfragen ohne passenden <code>server_name</code> auf.

== Fehlerbilder ==

{| class="wikitable"
! Symptom !! Ursache !! Erster Schritt
|-
| Seite lädt gar nicht || Dienst nicht gestartet oder Firewall blockiert Port || <code>systemctl status nginx</code>, dann Firewall-Regeln prüfen
|-
| 403 Forbidden || Dateirechte oder kein Index, kein Directory Listing erlaubt || Rechte und Vorhandensein der Index-Datei prüfen
|-
| 404 Not Found || falscher <code>root</code> oder Datei liegt woanders || <code>root</code> im richtigen <code>server</code>-Block prüfen
|-
| Dienst nach Änderung ganz weg || <code>restart</code> statt <code>reload</code> bei fehlerhafter Konfiguration || vor jedem Reload: <code>nginx -t</code>
|-
| Änderung an <code>sites-available</code> wirkt nicht || Symlink in <code>sites-enabled</code> fehlt (Debian-Familie) || <code>ln -s ../sites-available/datei sites-enabled/datei</code>
|}

== Links ==

* [https://nginx.org/en/docs/ offizielle Nginx-Dokumentation]
* [[Nginx Grundlagen]]
* [[Nginx Reverse Proxy und Load Balancing]]
* Animation: [https://xinux.org/nginx-grundkonfiguration.html Nginx: Grundkonfiguration]

Nginx Grundkonfiguration - Versionsgeschichte

Thomas.will@claude: Neue Seite: fehlte, war aber schon von drei Seiten verlinkt