HTTP-Umleitungen für nginx

Es gibt viele Gründe, HTTP Umleitungen für Webseiten in der Konfiguration des Servers (in diesem Artikel hier nginx) einzusetzen. Beispielsweise wenn du eine Seite erneuerst du oder ein Link auf externen Seiten verwendet wird. Je nach Bedarf gibt es dazu einige Möglichkeiten um dem Webserver davon zu überzeugen, gültige Anfragen direkt weiterzuleiten. In der Konfiguration können Diese temporär sowie auch permanent konfiguriert werden. Wichtig dabei ist, dass der Server im Antwort-Header den richtigen HTTP-Statuscode zurücksendet. Hier zuerst einmal einige Beispiele:

• 200 Ok -> die Anfrage wurde erfolgreich verarbeitet
• 301 Moved Permanently -> die angeforderte Ressource wurde dauerhaft verschoben und der Aufruf wird auf eine andere URL weitergeleitet
• 302 Found(Moved Temporarily) -> die angefragte Ressource ist derzeit nicht und der Aufruf wird auf eine andere Adresse weitergeleitet
• 404 Not Found -> die angefragte Ressource ist nicht verfügbar

Weitere Statuscodes sowie deren ausführlichen Beschreibungen findest du auf der deutschen Wikipedia Seite unter de.wikipedia.org/wiki/HTTP-Statuscode

Achtung: In diesem Artikel werden keine internen Weiterleitungen (wie Proxy-Funktionalität) beschrieben. Hierzu schreibe ich in Kürze einen eigenen Artikel.

Permanente Weiterleitung im Webserver von HTTP nach HTTPS für nginx

Um alle Anfragen weiterzuleiten sind nur wenige Schritte notwendig. Im Folgenden legst du eine 2. server – Konfiguration direkt nach der Konfiguration der verschlüsselten server – Konfiguration anlegen.

server {
  server_name www.example.com;
  listen 443 ssl;
  ...
}

server {
  server_name www.example.com;
  listen 80;
  if($host = www.example.com) {
    return 301 https://$host$request_uri;
  }
}

Einfache Weiterleitung innerhalb des Webservers

Innerhalb einer Serverkonfiguration kannst du überdies die location Funktion eine Weiterleitung konfigurieren. Diese Umleitungen verarbeitet nginx ab sofort so wie du sie benötigst. Sofern diese nur in geringer Anzahl da sind kannst du diese in der server Konfiguration direkt ablegen.

server {
  location /alt {
    return 302 /neu.html
  }
}

Innerhalb der location Definition gibt es unterschiedliche RegEx-Funktionen die du in der Dokumentation unter nginx.org/en/docs/ nachlesen kannst.

Mehrere Weiterleitungen im Webserver in einer zentralen Datei verwalten

Wenn du eine alte Seite erneuerst wird zwangsweise immer auf das gleiche Problem stoßen, eine permanente Weiterleitung im Webserver von nicht mehr vorhandenen Dateipfaden (URI’s). Daher hat nginx hier eine Möglichkeit geschaffen – die Verwendung einer Key -> Value Tabelle mittels Keymap-Datei

Zuerst wird eine map Datei erstellt (Dateiendung nicht notwendig). Ich verwende hierzu der Übersicht halber eine eigene Datei (die Konfiguration kannst du auch direkt in der jeder anderen schon verwendeten Datei gesetzt werden). path/to/com.example.www.map

map $request_uri $new_uri {
  /old/path.html    /new/path.html;
  /old-path/        /new-path/;
  /old-x            /new-y;
}

Diese Datei muss nur innerhalb der http Struktur eingefügt werden:
include path/to/com.example.www.map

Jetzt wird die Datei innerhalb der server Struktur einer Datei eingefügt:

include path/to/com.example.www.map

server {
  server_name www.example.com;
  listen 443 ssl;

  location / {
    if ($new_uri) {
      return 301 https://$host$new_uri;
    }
    try_files $uri $uri/;
  }
}

Mit dieser Lösung kannst du eine nginx Instanz für eine Domain sämtliche Anfragen bearbeiten. Alle anderen server -Konfigurationen bleiben allerdings infolgedessen davon unberührt.

Fazit

Ich hoffe, ich konnte dir auf deiner Suche nach einer Lösung zu HTTP Umleitungen für nginx helfen, abgesehen davon kannst du mir gerne mit Hilfe der Kommentar-Funktion über die Möglichkeiten diskutieren. Gerne auch Feedback – so kann ich den Artikel weiterhin aktualisieren.

Zuletzt noch eine Artikel-Empfehlung für dich. Möchtest du mehr über Monitoring in nginx erfahren? Ich habe einen Artikel über zwei Module – VTS und VTS-Exporter geschrieben.

Foto: Taylor Vick