Eine Seite umbenannt, einen Ordner verschoben oder die Domain gewechselt? Dann muss die alte Adresse auf die neue zeigen, sonst landen Besucher und Suchmaschinen auf einer Fehlerseite. Bei Apache genügen dafür ein paar Zeilen in der .htaccess. Welche, hängt vom Fall ab. Dazu kommt die Frage, ob 301, 302, 307 oder 308 passt und wie du Ketten und Schleifen vermeidest.

Für eine 301-Weiterleitung mit .htaccess öffnest du die Datei im Hauptverzeichnis der Website, trägst eine Zeile ein und speicherst. Apache liest die Datei bei jedem Aufruf neu, die Regel wirkt also sofort. LiteSpeed, das manche Hoster statt Apache betreiben, wertet die .htaccess ebenfalls aus, die freie Ausgabe OpenLiteSpeed allerdings nur die Rewrite-Regeln und erst nach einem Neustart. Nginx ignoriert die Datei, dort gehören Weiterleitungen in die Konfiguration des Servers.
Bearbeite die Datei mit einem reinen Texteditor (eine Auswahl findest du unter Editoren in den Downloads) und sichere vorher die alte Fassung. Ein Tippfehler legt das ganze Verzeichnis mit einem Fehler 500 lahm. Bleibt dagegen jede Regel wirkungslos, wertet der Server die Datei vermutlich gar nicht aus. Dann hilft nur eine Nachfrage beim Hoster.
Welche Weiterleitung wann passt
Die Zahl entscheidet, wie Browser und Suchmaschinen den Umzug verstehen. Für fast jeden Umzug ist 301 richtig.
| Art | Bedeutung | Typischer Einsatz | Google |
| 301 | dauerhaft umgezogen | Seite, Ordner oder Domain zieht um | zeigt die neue Adresse in den Ergebnissen |
| 308 | dauerhaft, Methode bleibt gleich | wie 301, wenn Formulare dorthin senden | wie 301 |
| 302 | vorübergehend woanders | Aktionsseite, kurzer Umbau, Test | behält meist die alte Adresse |
| 307 | vorübergehend, Methode bleibt gleich | wie 302 für Formulare | wie 302 |
| Meta-Refresh | Anweisung im <head> der alten Seite | kein Zugriff auf den Server | ohne Wartezeit dauerhaft, mit Wartezeit vorübergehend |
| JavaScript | ein Skript wechselt die Adresse | nur als Notlösung | wirkt nur, wenn Google die Seite rendert |
Zwischen 301 und 308 musst du nur wählen, wenn ein Formular per POST an die alte Adresse sendet. Bei 301 und 302 machen Browser daraus einen GET, und die Formulardaten gehen unterwegs verloren. 307 und 308 verbieten diesen Wechsel.
Ein Meta-Refresh steht im HTML der alten Seite und funktioniert auch auf Webspace ohne .htaccess. Das Tag erzeugt dir der Weiterleitungs-Generator, seinen Aufbau erklärt der Tipp automatische Weiterleitung mit einem Meta-Tag. Für einen dauerhaften Umzug setzt du die Wartezeit auf 0. JavaScript bleibt die letzte Wahl.
301-Weiterleitung mit .htaccess: Code für die häufigsten Fälle
Ersetze in allen Beispielen www.example.de durch deine eigene Adresse.
Einzelne Seite
Redirect 301 /alt.html https://www.example.de/neu.html
Vorn steht der Pfad mit Schrägstrich am Anfang, dahinter die vollständige neue Adresse. Groß- und Kleinschreibung zählt.
Ganzer Ordner
Redirect 301 /archiv https://www.example.de/blog
Was hinter dem Pfad folgt, hängt Apache an das Ziel an. Aus /archiv/2019.html wird /blog/2019.html. Verglichen werden ganze Pfadteile, ein Ordner /archiv-alt bleibt also unberührt.
Domainumzug
Hat die alte Domain ein eigenes Verzeichnis, reicht dort eine Zeile:
Redirect 301 / https://www.neue-domain.example/
Zeigen beide Domains auf dasselbe Verzeichnis, unterscheidest du sie am Hostnamen:
RewriteEngine On
RewriteCond %{HTTP_HOST} ^(www\.)?alte-domain\.example$ [NC]
RewriteRule ^(.*)$ https://www.neue-domain.example/$1 [R=301,L]
Google rät, die Weiterleitungen nach einem Umzug so lange wie möglich zu behalten, in der Regel mindestens ein Jahr. Kündige die alte Domain also nicht gleich.
Mit oder ohne www
Entscheide dich für eine Form. Diese Regel leitet alle Aufrufe ohne www auf die Adresse mit www um:
RewriteEngine On
RewriteCond %{HTTP_HOST} ^example\.de$ [NC]
RewriteRule ^(.*)$ https://www.example.de/$1 [R=301,L]
Für den umgekehrten Weg prüfst du auf ^www\.example\.de$ und leitest auf https://example.de/$1 um.
Von HTTP auf HTTPS
RewriteEngine On
RewriteCond %{HTTPS} !=on
RewriteRule ^(.*)$ https://%{HTTP_HOST}/$1 [R=301,L]
Zertifikat, gemischte Inhalte und den Sonderfall hinter einem Proxy behandelt der Artikel Website auf HTTPS umstellen.
Abschließender Schrägstrich
Liefert dein System /seite und /seite/ mit demselben Inhalt aus, hat jede Seite zwei Adressen. Diese Regel entfernt den Schrägstrich am Ende und lässt echte Verzeichnisse in Ruhe:
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_URI} (.+)/$
RewriteRule ^ https://www.example.de%1 [R=301,L]
%1 ist der Pfad ohne den letzten Schrägstrich, den die zweite Bedingung herausgreift. Die Ausnahme für Verzeichnisse ist Pflicht. Bei Ordnern hängt Apache den Schrägstrich selbst an. Ohne die erste Bedingung schicken sich Server und Regel den Besucher endlos hin und her.
Redirect oder RewriteRule?
Redirect aus dem Modul mod_alias vergleicht nur den Anfang des Pfads. Für einfache Weiterleitungen von Seiten und Ordnern empfiehlt die Apache-Dokumentation genau das. RewriteRule aus mod_rewrite arbeitet mit regulären Ausdrücken und prüft mit RewriteCond Bedingungen wie den Hostnamen oder die Verschlüsselung. Die brauchst du für www, HTTPS und den Domainumzug im selben Verzeichnis.
- Ohne Statusangabe schicken beide eine 302. Schreib die 301 immer dazu.
- Bei
Redirect beginnt der Pfad mit Schrägstrich, im Muster einer RewriteRule in der .htaccess ohne.
- Punkte im Muster maskierst du mit Backslash:
alt\.html.
- Eine
RewriteCond gilt nur für die RewriteRule direkt darunter.
RewriteEngine On genügt einmal am Anfang der Datei.
Mische beide möglichst nicht in einer Datei. In der .htaccess arbeitet Apache erst alle RewriteRule-Zeilen ab und danach die Redirect-Zeilen, egal in welcher Reihenfolge sie dastehen. Schickt eine RewriteRule den Besucher weiter, etwa auf HTTPS, kommt das passende Redirect erst beim nächsten Aufruf an die Reihe, und der Besucher springt zweimal. Steht in der Datei schon eine Regel für HTTPS oder www, schreib deshalb auch einzelne Weiterleitungen als RewriteRule.
Reihenfolge: erst der Einzelfall, dann die allgemeine Regel
Innerhalb von mod_rewrite zählt die Reihenfolge in der Datei. Die erste passende Regel mit [R=301,L] schickt die Antwort ab, alle folgenden kommen nicht mehr dran. Setz deshalb die einzelnen Seiten nach oben, jeweils mit der endgültigen Zieladresse, und die allgemeine Regel für HTTPS und www ans Ende:
RewriteEngine On
RewriteRule ^alt\.html$ https://www.example.de/neu.html [R=301,L]
RewriteRule ^archiv/(.*)$ https://www.example.de/blog/$1 [R=301,L]
RewriteCond %{HTTPS} !=on [OR]
RewriteCond %{HTTP_HOST} !^www\.example\.de$ [NC]
RewriteRule ^(.*)$ https://www.example.de/$1 [R=301,L]
Ein Aufruf von http://example.de/alt.html landet so mit einem einzigen Sprung auf der neuen Seite. Stünde die allgemeine Regel oben, ginge es erst zu HTTPS mit www und danach in einem zweiten Sprung zur neuen Seite. Die Regel für den Schrägstrich gehört ebenfalls vor die allgemeine Regel, die Regeln deines CMS kommen erst danach.
Ketten und Schleifen erkennen
Eine Kette entsteht, wenn das Ziel einer Weiterleitung selbst weiterleitet. Seite A zeigt auf B, Monate später ziehst du B nach C um. Googlebot folgt höchstens zehn Sprüngen, und Google rät, direkt auf das endgültige Ziel zu leiten. Pass deshalb bei jedem Umzug auch die älteren Regeln an, sodass A gleich auf C zeigt. In die XML-Sitemap gehören nur Adressen, die selbst nicht weiterleiten (mehr dazu im Artikel über robots.txt und XML-Sitemap).
Bei einer Schleife führt die Weiterleitung am Ende zurück zum Anfang. Chrome bricht dann mit ERR_TOO_MANY_REDIRECTS ab, andere Browser zeigen eine ähnliche Meldung. Die üblichen Ursachen:
- Eine Regel ohne passende Bedingung, deren Ziel wieder auf ihr eigenes Muster passt.
- Zwei Regeln, die sich widersprechen, etwa eine, die den Schrägstrich anhängt, und eine, die ihn entfernt.
- Das CMS hat eine eigene Einstellung für die Adresse der Website, zum Beispiel ohne www, während die .htaccess auf www besteht.
- Die HTTPS-Regel hinter einem Proxy oder CDN: Apache sieht dort nur unverschlüsselte Anfragen und leitet immer wieder um.
Weiterleitung prüfen mit Kommandozeile und Browser
Am zuverlässigsten zeigt die Kommandozeile, was der Server antwortet. curl ist auf Linux, macOS und aktuellen Windows-Versionen vorhanden. In der Windows-PowerShell tippst du curl.exe, weil curl dort je nach Version ein anderer Befehl ist.
curl -I http://example.de/alt.html
In der Antwort suchst du zwei Zeilen: die Statuszeile, etwa HTTP/1.1 301 Moved Permanently (über HTTPS oft kurz HTTP/2 301), und Location mit dem Ziel. Mit curl -IL folgt curl allen Sprüngen und zeigt jede Antwort als eigenen Block. Siehst du mehr als zwei Blöcke, hast du eine Kette.
Im Browser zeigt der Reiter Netzwerk der Entwicklerwerkzeuge (F12) jede Weiterleitung mit Status und Ziel. Setz dort in Chrome die Haken bei „Cache deaktivieren“ und „Protokoll beibehalten“ (englisch „Preserve log“), dann bleibt die Liste beim Seitenwechsel stehen. Browser merken sich eine 301 und fragen danach nicht mehr beim Server nach. Probier neue Regeln deshalb erst mit 302 oder in einem privaten Fenster aus und stell auf 301 um, wenn alles stimmt. Was die übrigen Zahlen in der Statuszeile bedeuten, erklärt der Artikel über HTTP-Statuscodes und eigene Fehlerseiten.
Weiterlesen