Redirect-Regeln-Generator

Funktionsweise des Redirect-Regeln-Generators

Der Redirect-Regeln-Generator ist ein spezialisiertes Werkzeug, das eine Liste von Quell- und Ziel-URLs einliest und daraus den exakten Konfigurationscode für Webserver oder Hosting-Plattformen erstellt. Die Eingabe erfolgt über eine CSV-Datei, die die gewünschten URL-Zuordnungen enthält. Nach der Auswahl des gewünschten HTTP-Statuscodes und der Zielumgebung erzeugt das Tool die passenden Direktiven, die direkt kopiert oder als Datei heruntergeladen werden können.

Die Verarbeitung der Daten erfolgt vollständig lokal: Ihre CSV-Datei und die generierten Regeln verbleiben in Ihrem Browser. Es wird nichts an BroBroGo übertragen.

Anforderungen an die CSV-Eingabedatei

Für eine fehlerfreie Verarbeitung muss die importierte CSV-Datei bestimmte strukturelle Vorgaben erfüllen:

• Dateigröße und Zeilenlimit: Die Datei muss unter 5 MB groß sein. Das Tool verarbeitet maximal 2.000 Zuordnungen pro Durchgang.
• Spaltenstruktur: Die Kopfzeile benötigt Spalten für Quelle („source“) und Ziel („target“ oder „destination“).
• Format der Quell-URL: Erlaubt sind vollständige HTTP- oder HTTPS-URLs oder relative Pfade, die mit einem / beginnen. Hostnames in der Quelle werden bei der Verarbeitung automatisch entfernt.
• Format der Ziel-URL: Hier kann eine vollständige HTTP- oder HTTPS-URL oder ein relativ zum Root-Verzeichnis angegebener Pfad hinterlegt werden.
• Zeichenbegrenzung: Eine URL in einer Zeile darf eine Länge von 2.048 Zeichen nicht überschreiten.

Da der Generator auf exakte Pfadübereinstimmungen ausgelegt ist, sind Query-Strings, Fragmente (Hashtags) sowie Wildcards oder Routen-Muster in den Quell-URLs nicht zulässig. Jede Quell-URL darf zudem nur einmal in der Datei vorkommen, um zirkuläre oder widersprüchliche Weiterleitungen zu verhindern.

Statuscodes: 301 Permanent vs. 302 Temporär

Bei der Erstellung von Weiterleitungsregeln muss der passende HTTP-Statuscode gewählt werden, da dieser Suchmaschinen signalisiert, wie die neue Adresse zu bewerten ist:

• 301 Permanent: Dieser Statuscode teilt Clients und Suchmaschinen-Crawlern mit, dass die angeforderte Ressource dauerhaft unter der neuen Ziel-URL erreichbar ist. Suchmaschinen übertragen die Linkautorität (PageRank) in der Regel auf die neue Adresse. Dies ist der Standardweg bei einer vollständigen Website-Migration oder nach einer dauerhaften Restrukturierung der URL-Struktur.
• 302 Temporär: Dieser Statuscode signalisiert, dass die Umleitung nur vorübergehend aktiv ist. Die ursprüngliche URL bleibt im Suchmaschinenindex bestehen, und es wird keine dauerhafte Linkautorität übertragen. Dies ist nützlich für kurzzeitige Wartungsarbeiten oder zeitlich begrenzte Kampagnen.

Syntax-Besonderheiten der Serverumgebungen

Je nach gewählter Serverumgebung unterscheidet sich die Syntax der generierten Regeln erheblich, um eine exakte Übereinstimmung zu gewährleisten:

Nginx

Für den Nginx-Webserver werden exakt verankerte Regeln erzeugt. Da Nginx-Konfigurationen präzise Pfadprüfungen erfordern, stellt der Generator sicher, dass die Regeln exakt auf den Quellpfad matchen und nicht fälschlicherweise tieferliegende Unterpfade miterfassen.

Apache

In der Apache-Konfiguration (typischerweise für die .htaccess-Datei) werden die Regeln ebenfalls fest auf den exakten Quellpfad verankert. Dadurch wird verhindert, dass unvollständige Pfadübereinstimmungen ungewollte Weiterleitungen auslösen.

Vercel

Die Konfiguration für Vercel-Deployments wird im JSON-Format ausgegeben. Vercel nutzt standardmäßig den Statuscode 308 für permanente und 307 für temporäre Weiterleitungen. Um sicherzustellen, dass die klassischen Statuscodes 301 oder 302 exakt eingehalten werden, verwendet die Vercel-Ausgabe explizit das Attribut statusCode. Da Standard-Vercel-Deployments insgesamt maximal 2.048 Routen erlauben, ist das Tool-Limit von 2.000 Zuordnungen darauf abgestimmt.

Statusmeldungen und Fehlerbehandlung

Während des Import- und Generierungsprozesses gibt das Tool präzise Rückmeldungen über den aktuellen Zustand oder eventuelle Formatierungsfehler aus:

• ready: Bereit. Importieren Sie eine CSV-Datei mit Quell- und Ziel-Zuordnungen.
• selected: {name} ist bereit.
• reading: {name} wird gelesen…
• parsing: CSV-Zeilen in {name} werden geprüft…
• generating: Weiterleitungsregeln aus {name} werden generiert…
• generated: {count} exakte {status}-Weiterleitung(en) generiert.
• downloaded: Regeln heruntergeladen.
• cleared: Datei und Regeln gelöscht.

Sollte die CSV-Datei Fehler enthalten, bricht die Verarbeitung mit einer der folgenden Meldungen ab:

• Wählen Sie zuerst eine CSV-Datei aus.
• Bitte wählen Sie eine.csv-Datei aus.
• Diese CSV-Datei ist zu groß. Bitte wählen Sie eine Datei unter {max}.
• Die CSV-Datei enthält keine Weiterleitungs-Zuordnungen.
• Die CSV-Datei konnte in der Nähe von Zeile {line} nicht verarbeitet werden. Prüfen Sie Anführungszeichen und Kommas.
• Die Kopfzeile benötigt Spalten für Quelle („source“) und Ziel („target“ oder „destination“).
• Zeile {line} erfordert sowohl eine Quelle als auch ein Ziel.
• Zeile {line} enthält eine ungültige Quelle. Verwenden Sie eine HTTP(S)-URL oder einen Pfad, der mit / beginnt.
• Zeile {line} enthält einen Query-String oder ein Fragment in der Quelle. Verwenden Sie nur den reinen Quellpfad.
• Zeile {line} enthält Wildcards oder Routen-Muster. Dieser Generator akzeptiert nur exakte Quellpfade.
• Zeile {line} enthält ein ungültiges Ziel. Verwenden Sie eine HTTP(S)-URL oder einen Pfad, der mit / beginnt.
• Eine URL in Zeile {line} ist länger als 2,048 Zeichen.
• Zeile {line} wiederholt den Quellpfad {source}. Jede Quelle darf nur einmal vorkommen.
• Dieses Tool unterstützt maximal {max} Zuordnungen gleichzeitig.
• Die Erstellung hat zu lange gedauert. Prüfen Sie die CSV-Datei und versuchen Sie es erneut.
• Die Regeln konnten nicht generiert werden. Prüfen Sie die CSV-Datei und versuchen Sie es erneut.

Häufig gestellte Fragen (FAQ)

Wie muss die CSV-Datei formatiert sein?

Verwenden Sie eine Kopfzeile mit den Spalten „source“ und „target“ (oder „destination“). Jede folgende Zeile kann eine vollständige HTTP- oder HTTPS-Quell-URL bzw. einen mit / beginnenden Pfad sowie ein vollständiges oder relativ zum Root-Verzeichnis angegebenes Ziel enthalten.

Handelt es sich bei den generierten Weiterleitungen um exakte Übereinstimmungen?

Ja. Die Ausgaben für Nginx und Apache sind fest auf den exakten Quellpfad verankert, und Vercel erhält denselben literalen Pfad. Ein Quell-Hostname wird entfernt; Quell-Query-Strings, Fragmente und Wildcard-Muster werden abgelehnt, da die drei Serverumgebungen diese unterschiedlich verarbeiten.

Warum verwendet die Vercel-Ausgabe „statusCode“?

Die permanente Weiterleitung von Vercel erzeugt standardmäßig einen Statuscode 308 und die temporäre einen 307. Es wird statusCode verwendet, damit Ihre Auswahl exakt bei 301 oder 302 bleibt. Standard-Vercel-Deployments erlauben insgesamt 2.048 Routen, weshalb dieses Tool bis zu 2.000 Zuordnungen akzeptiert.

Werden meine Daten auf einen Server hochgeladen?

Nein. Ihre CSV-Datei und die generierten Regeln verbleiben in Ihrem Browser. Es wird nichts an BroBroGo übertragen.