Die Seite Weiterleitungen einer Site schickt Besucher von einem Pfad der Site zu einer anderen Seite oder Adresse, zum Beispiel von /alte-seite zu /neue-seite oder von /shop zu https://shop.example.com. Nginx beantwortet diese Anfragen selbst, bevor deine App sie sieht, du musst also keinen Code ändern.
Nutze sie, wenn du eine Seite verschiebst oder umbenennst, damit alte Links, Lesezeichen und Suchergebnisse weiter funktionieren.
Eine Weiterleitung hinzufügen
- Öffne die Site und klicke in der Seitenleiste auf Weiterleitungen.
- Klicke auf Weiterleitung hinzufügen.
- Fülle aus:
- Von: der Pfad auf dieser Site, beginnend mit
/, etwa/alte-seite. Nur genau dieser Pfad wird weitergeleitet:/alte-seite/oder/alte-seite/mehrnicht. - Nach: ein Pfad auf dieser Site, etwa
/neue-seite, oder eine vollständige Adresse, die mithttps://(oderhttp://) beginnt, etwahttps://example.com/neue-seite. - Typ: der Statuscode (siehe unten).
- Von: der Pfad auf dieser Site, beginnend mit
- Klicke auf Weiterleitung hinzufügen.
Die Regel zeigt einen Status, während sie auf den Server geschrieben wird, und ist aktiv, sobald das erledigt ist. Klicke auf Bearbeiten, um eine Regel zu ändern, oder auf Entfernen, um sie zu löschen; der Pfad wird dann wieder von der Site selbst behandelt.
Eine Site kann bis zu 100 Weiterleitungen haben, eine pro Pfad. Pfade unter /.well-known/ lassen sich nicht weiterleiten: Sie werden für HTTPS-Zertifikate gebraucht.
Welchen Typ wählst du?
| Typ | Bedeutung | Nutze ihn, wenn |
|---|---|---|
| 301 · Dauerhaft | Die Seite ist endgültig umgezogen. Browser und Suchmaschinen merken sich die neue Adresse. | Eine Seite umgezogen oder umbenannt wurde (die übliche Wahl). |
| 302 · Vorübergehend | Die Seite ist vorerst woanders. | Eine vorübergehende Seite, etwa eine Kampagnen- oder Wartungsseite. |
| 307 · Vorübergehend, gleiche Methode | Wie 302, aber ein abgeschicktes Formular (POST) bleibt ein POST. |
Ein Endpunkt, der Formulare oder API-Aufrufe empfängt, vorübergehend umgezogen ist. |
| 308 · Dauerhaft, gleiche Methode | Wie 301, aber ein POST bleibt ein POST. |
Ein Endpunkt, der Formulare oder API-Aufrufe empfängt, endgültig umgezogen ist. |
Wie funktionieren Weiterleitungen auf dem Server?
Vimonto Deploy schreibt alle Weiterleitungen der Site in redirects.conf im Include-Ordner der Nginx-Konfiguration der Site, /etc/nginx/vimonto-conf/site-{id}/, ein Block pro Regel:
location = "/alte-seite" {
return 301 "/neue-seite";
}
Die Konfiguration wird mit nginx -t geprüft, bevor Nginx neu lädt. Lehnt Nginx sie ab, werden die vorherigen Regeln wiederhergestellt und bleiben aktiv, und die Regel zeigt an, dass sie fehlgeschlagen ist. Der Include-Ordner bleibt erhalten, wenn die Konfiguration der Site neu geschrieben wird, deine Weiterleitungen also auch.
Nicht alle Regeln sind aktiv
Ist eine Änderung fehlgeschlagen oder kam sie, während noch ein anderes Update lief, zeigt die Seite Nicht alle Regeln sind aktiv. Klicke auf Erneut anwenden, um alle Regeln noch einmal auf den Server zu schreiben. Die Ausgabe des letzten Updates steht auf der Seite Aktivität.
Diese Regeln gelten nicht für diese Site
Weiterleitungen funktionieren mit der Konfiguration, die Vimonto Deploy erzeugt, und mit deiner eigenen Nginx-Konfiguration, solange sie die include-Zeile für den Include-Ordner der Site behält. Ohne sie zeigt die Seite Diese Regeln gelten nicht für diese Site, und du kannst keine Regeln hinzufügen. Stelle die Standardkonfiguration auf der Seite Nginx der Site wieder her oder füge die Include-Zeile wieder ein.
Wer darf Weiterleitungen ändern?
Jedes Mitglied kann die Weiterleitungen sehen. Hinzufügen, Ändern und Entfernen erfordern die Berechtigung, Sites zu verwalten (Owner, Administrator, Manager und Developer), und Site und Server müssen aktiv sein. Änderungen werden im Audit-Log festgehalten.
Häufig gestellte Fragen
Kann ich eine ganze Domain weiterleiten, etwa www auf die Hauptdomain?
Nicht mit einer Weiterleitungsregel: Eine Regel gilt für einen Pfad. www auf deine Domain weiterzuleiten ist eine Einstellung der Domain: siehe Weiterleitungen zwischen www und der Domain ohne www.
Kann ich einen Pfad mit allen Unterseiten weiterleiten?
Nein. Eine Regel gilt nur für genau ihren Pfad. Lege für jeden Pfad eine Regel an oder regle umfassendere Weiterleitungen in deiner App oder in einer eigenen .conf-Datei im Include-Ordner.
Funktionieren Weiterleitungen auf einer lastverteilten Site?
Ja. Auf einem Load Balancer beantwortet der Balancer die Weiterleitung selbst, bevor die Anfrage einen App-Server erreicht.
Bleibt der Query-String erhalten?
Nein. Die Weiterleitung geht an genau die Adresse unter Nach. Füge dort einen Query-String hinzu, wenn du einen brauchst.