Die Datei .htaccess kann wichtige Einstellungen für eine Website enthalten. Sie wird bei entsprechend konfigurierten Apache-basierten Webservern verwendet, um bestimmte Regeln direkt auf Verzeichnis- beziehungsweise Website-Ebene festzulegen.
Dazu können beispielsweise Weiterleitungen, URL-Umschreibungen, Zugriffsbeschränkungen oder anwendungsspezifische Regeln gehören.
Bei WordPress spielt .htaccess häufig eine wichtige Rolle für die Permalink-Struktur.
In dieser Anleitung zeigen wir dir, wie du eine vorhandene .htaccess-Datei im CURIAWEB-cPanel findest, sicherst, bearbeitest und nach Änderungen überprüfst. Außerdem erklären wir, wie du vorgehst, wenn nach einer Änderung ein Fehler auftritt.
Wichtig: Bereits eine fehlerhafte Zeile in
.htaccesskann dazu führen, dass eine Website nicht mehr korrekt erreichbar ist. Erstelle deshalb vor jeder Änderung eine Sicherung der vorhandenen Datei.
Was ist .htaccess? #
.htaccess ist eine Konfigurationsdatei, die bei geeigneter Apache-Konfiguration Anweisungen für ein bestimmtes Verzeichnis und dessen Unterverzeichnisse enthalten kann.
Der Name beginnt mit einem Punkt:
.htaccess
Dadurch wird die Datei unter Linux-basierten Systemen als versteckte Datei beziehungsweise Dotfile behandelt.
Wenn du sie im Dateimanager nicht siehst, musst du möglicherweise zuerst die Anzeige versteckter Dateien aktivieren.
Die genaue Vorgehensweise findest du unter Versteckte Dateien wie .htaccess in cPanel anzeigen.
Wofür wird .htaccess verwendet? #
Je nach Website und Serverkonfiguration kann .htaccess unterschiedliche Aufgaben übernehmen.
Typische Einsatzgebiete sind:
- URL-Umschreibungen
- Weiterleitungen
- Zugriffsbeschränkungen
- Regeln für bestimmte Dateitypen
- anwendungsspezifische Konfigurationen
- Permalink-Regeln bei WordPress
Nicht jede Website benötigt dieselben Regeln und nicht jede .htaccess-Datei sieht gleich aus.
Wichtig: Kopiere niemals die komplette
.htaccesseiner fremden Website in deine eigene Installation, nur weil dort eine ähnliche Anwendung verwendet wird.
1. cPanel-Dateimanager öffnen #
Melde dich bei deinem CURIAWEB-cPanel an und öffne:
Dateien → Dateimanager
Wenn du mit dem Dateimanager noch nicht vertraut bist, findest du eine ausführliche Einführung unter cPanel-Dateimanager verwenden.
2. Versteckte Dateien einblenden #
Da .htaccess mit einem Punkt beginnt, kann sie im Dateimanager ausgeblendet sein.
Öffne oben rechts die Einstellungen und aktiviere:
Verborgene Dateien anzeigen (dotfiles)
Speichere anschließend die Einstellung.
3. Richtiges Website-Verzeichnis öffnen #
Navigiere zum Dokumentenstamm der Website, deren .htaccess du bearbeiten möchtest.
Für die Hauptdomain ist dies bei einer typischen cPanel-Konfiguration häufig:
public_html
Bei zusätzlichen Domains oder Subdomains kann jedoch ein anderer Dokumentenstamm verwendet werden.
Achtung: Bei mehreren Websites können mehrere
.htaccess-Dateien vorhanden sein. Kontrolliere deshalb immer, ob du dich im richtigen Verzeichnis befindest.
4. .htaccess-Datei suchen #
Suche im gewünschten Verzeichnis nach:
.htaccess
Bei einer WordPress-Installation kann sie beispielsweise zusammen mit Dateien und Ordnern wie:
.htaccess
index.php
wp-admin/
wp-content/
wp-includes/
wp-config.phpim Hauptverzeichnis der Installation liegen.
Wenn keine .htaccess-Datei vorhanden ist #
Wenn die Datei trotz aktivierter Dotfile-Anzeige nicht vorhanden ist, solltest du nicht automatisch eine neue Datei anlegen.
Prüfe zuerst:
- ob du im richtigen Dokumentenstamm bist
- ob die Website tatsächlich eine
.htaccessbenötigt - ob die verwendete Anwendung die Datei normalerweise selbst erzeugt
- ob sie möglicherweise umbenannt wurde
Nicht jede Website und nicht jede Serverkonfiguration benötigt zwingend eine .htaccess-Datei.
5. .htaccess vor der Bearbeitung sichern #
Bevor du Änderungen vornimmst, solltest du eine Sicherung der vorhandenen Datei erstellen.
Markiere:
.htaccess
und lade sie auf deinen Computer herunter.
Alternativ kannst du vorübergehend eine Kopie erstellen, beispielsweise:
.htaccess-backup
Praxis-Tipp: Die sicherste Arbeitsweise ist: Original herunterladen, Änderung durchführen, Website testen und bei einem Fehler sofort die vorherige Version wiederherstellen.
Wie du Dateien herunterlädst und bearbeitest, zeigen wir ausführlich unter Dateien in cPanel hochladen, herunterladen und bearbeiten.
6. .htaccess im Editor öffnen #
Markiere die Datei .htaccess und wähle Bearbeiten.
cPanel öffnet den Inhalt anschließend im integrierten Editor.
Kontrolliere zunächst den bestehenden Inhalt, bevor du etwas veränderst.
Kommentare in .htaccess erkennen #
Zeilen, die mit einem Doppelkreuz beginnen, werden üblicherweise als Kommentare verwendet.
Beispielsweise:
# Eigene Weiterleitungen
# WordPress-Regeln nicht verändernKommentare sind hilfreich, um eigene Bereiche oder Änderungen zu dokumentieren.
Das kann besonders bei umfangreicheren Dateien die spätere Fehlersuche erleichtern.
7. Nur die notwendige Änderung durchführen #
Verändere möglichst nur die konkrete Regel, die tatsächlich angepasst werden muss.
Wenn du gleichzeitig mehrere unabhängige Änderungen einfügst, wird die Fehlersuche deutlich schwieriger.
Grundregel: Eine Änderung durchführen, speichern, testen – erst danach die nächste Änderung vornehmen.
Reihenfolge der Regeln kann wichtig sein #
Bei Weiterleitungen und Rewrite-Regeln kann die Reihenfolge einzelner Anweisungen eine Rolle spielen.
Eine allgemein formulierte Regel kann beispielsweise eine danach folgende speziellere Regel beeinflussen.
Füge neue Regeln deshalb nicht wahllos an irgendeiner Stelle ein.
Weiterleitungen über .htaccess #
.htaccess kann verwendet werden, um Besucher von einer URL zu einer anderen weiterzuleiten.
Bei geeigneter Apache-Konfiguration kann eine einfache permanente Weiterleitung beispielsweise grundsätzlich mit einer Anweisung wie dieser umgesetzt werden:
Redirect 301 /alte-seite/ https://example.com/neue-seite/Dabei wird eine permanente HTTP-Weiterleitung mit Statuscode 301 verwendet.
Wichtig: Verwende in einer produktiven Website keine Beispiel-Domain aus dieser Anleitung. Passe Regeln immer exakt an deine tatsächliche Domain und URL-Struktur an.
301 und 302 nicht verwechseln #
Eine 301-Weiterleitung signalisiert grundsätzlich eine permanente Verschiebung.
Eine 302-Weiterleitung signalisiert grundsätzlich eine vorübergehende Weiterleitung.
Welche Variante richtig ist, hängt vom Zweck der Weiterleitung ab.
Wenn eine alte URL dauerhaft durch eine neue ersetzt wurde, ist häufig 301 die passende Variante.
Weiterleitungsschleifen vermeiden #
Fehlerhafte Redirect-Regeln können dazu führen, dass eine URL immer wieder auf sich selbst oder zwischen mehreren URLs weitergeleitet wird.
Der Browser meldet dann beispielsweise zu viele Weiterleitungen.
Wenn ein solcher Fehler unmittelbar nach einer neuen .htaccess-Regel auftritt, entferne beziehungsweise korrigiere zuerst die zuletzt hinzugefügte Regel.
Rewrite-Regeln verstehen #
Komplexere URL-Umschreibungen werden häufig über mod_rewrite umgesetzt.
Dabei können unter anderem Direktiven wie:
RewriteEngine
RewriteCond
RewriteRule
verwendet werden.
Ein typischer Beginn eines solchen Bereichs kann beispielsweise sein:
RewriteEngine OnDie konkrete Logik hängt jedoch vollständig vom gewünschten Verhalten ab.
Achtung: Rewrite-Regeln können sehr mächtig sein. Kopiere keine komplexe Regel aus dem Internet in eine produktive Website, wenn du Bedingungen, Ziel und mögliche Seiteneffekte nicht verstehst.
WordPress und .htaccess #
WordPress kann bei Apache-basierten beziehungsweise kompatiblen Serverkonfigurationen .htaccess für sogenannte Pretty Permalinks verwenden.
Die entsprechenden Regeln ermöglichen beispielsweise URLs wie:
anstatt rein parameterbasierter Adressen.
WordPress-Bereich erkennen #
Eine von WordPress verwaltete .htaccess kann einen gekennzeichneten WordPress-Bereich enthalten.
Typischerweise erkennst du ihn an Kommentaren wie:
# BEGIN WordPress
...
# END WordPressDieser Bereich kann von WordPress selbst verwaltet beziehungsweise neu geschrieben werden.
Wichtig: Eigene dauerhafte Regeln solltest du nicht unüberlegt innerhalb eines automatisch von WordPress verwalteten Bereichs platzieren. WordPress kann diesen Abschnitt bei bestimmten Änderungen neu erzeugen.
WordPress-Permalinks funktionieren nicht #
Wenn die Startseite funktioniert, Unterseiten aber einen 404-Fehler zeigen, können die Rewrite- beziehungsweise Permalink-Regeln ein möglicher Prüfpunkt sein.
Bei WordPress kann es helfen, die Permalink-Einstellungen im Backend zu öffnen und korrekt erneut zu speichern, sofern die Server- und Dateiberechtigungen dies zulassen.
Ändere .htaccess nicht auf Verdacht, wenn die Ursache noch nicht festgestellt wurde.
Eigene Regeln bei WordPress platzieren #
Wenn du eigene Regeln benötigst, solltest du berücksichtigen, welche Bereiche von WordPress automatisch verwaltet werden.
Dokumentiere eigene Regeln mit Kommentaren, beispielsweise:
# CURIAWEB - eigene Weiterleitung
Redirect 301 /alt/ https://example.com/neu/So lässt sich später leichter nachvollziehen, welche Regeln manuell hinzugefügt wurden.
8. Änderung speichern #
Kontrolliere deine Anpassung sorgfältig.
Speichere anschließend die Datei im cPanel-Editor.
Die Änderung wird direkt auf dem Server wirksam.
9. Website sofort testen #
Öffne die betroffene Website unmittelbar nach dem Speichern.
Teste nicht nur die Startseite, sondern gezielt die Funktion, die du verändert hast.
Bei einer Weiterleitung solltest du beispielsweise sowohl die alte als auch die neue URL prüfen.
Bei Permalink-Regeln solltest du mehrere Unterseiten aufrufen.
Browser-Cache bei Weiterleitungen berücksichtigen #
Browser können permanente Weiterleitungen zwischenspeichern.
Wenn du an einer 301-Weiterleitung arbeitest und das Verhalten trotz Änderung unverändert erscheint, kann deshalb auch ein zwischengespeicherter Redirect eine Rolle spielen.
Teste gegebenenfalls in einem privaten Browserfenster oder mit einem geeigneten HTTP-Prüfwerkzeug.
Nach Änderung erscheint ein 500 Internal Server Error #
Einer der häufigsten Hinweise auf eine fehlerhafte .htaccess-Änderung ist ein:
500 Internal Server Error
Wenn der Fehler unmittelbar nach dem Speichern auftritt, ist die zuletzt eingefügte oder veränderte Regel ein wichtiger Verdachtsbereich.
10. Bei 500-Fehler vorherige Version wiederherstellen #
Öffne den Dateimanager und ersetze die fehlerhafte .htaccess durch deine zuvor gesicherte Version.
Teste anschließend die Website erneut.
Wenn sie danach wieder funktioniert, lag die Ursache sehr wahrscheinlich in der vorgenommenen Änderung.
Die vollständige Fehleranalyse behandeln wir unter 500 Internal Server Error beheben.
.htaccess zur Diagnose vorübergehend umbenennen #
Wenn du untersuchen möchtest, ob eine vorhandene .htaccess einen Fehler verursacht, kann die Datei testweise umbenannt werden.
Beispielsweise von:
.htaccess
zu:
.htaccess-test
Der Webserver behandelt sie unter diesem Namen nicht mehr als normale .htaccess-Datei.
Rufe anschließend die Website erneut auf.
Achtung: Durch das Umbenennen können Weiterleitungen, Permalinks, Zugriffsschutz oder andere Regeln vorübergehend entfallen. Verwende diese Methode nur kurzzeitig zur Diagnose.
Was sagt der Test aus? #
Wenn die Website mit umbenannter .htaccess wieder funktioniert, ist die Datei beziehungsweise eine darin enthaltene Regel ein starker Verdachtsbereich.
Wenn der Fehler unverändert bleibt, liegt die Ursache wahrscheinlich an anderer Stelle.
Das Umbenennen beweist jedoch nicht automatisch, welche einzelne Regel fehlerhaft ist.
.htaccess danach wiederherstellen #
Nach dem Test solltest du die Datei wieder auf ihren ursprünglichen Namen setzen:
.htaccess
oder eine korrekt bereinigte Version verwenden.
Lass eine diagnostisch umbenannte Datei nicht unbeabsichtigt dauerhaft deaktiviert.
403 Forbidden nach .htaccess-Änderung #
.htaccess kann auch Regeln enthalten, die den Zugriff auf bestimmte Verzeichnisse, Dateien oder Besucher einschränken.
Wenn nach einer Änderung plötzlich ein 403 Forbidden erscheint, prüfe deshalb auch die zuletzt veränderten Zugriffsregeln.
Die vollständige Diagnose behandeln wir unter 403 Forbidden beheben.
Dateiberechtigungen der .htaccess prüfen #
Auch die Berechtigungen der Datei können relevant sein.
Für viele normale Website-Dateien ist 644 ein typischer Wert, aber die konkrete Einstellung hängt von der Serverkonfiguration ab.
Wie Berechtigungen funktionieren und geändert werden, erklären wir unter Dateiberechtigungen 644 und 755 in cPanel richtig einstellen.
.htaccess nicht auf 777 setzen #
Wenn eine Anwendung die Datei nicht beschreiben kann, solltest du sie nicht einfach auf:
777
setzen.
Prüfe stattdessen Berechtigungen, Eigentumsverhältnisse und die konkrete Fehlermeldung.
Mehrere .htaccess-Dateien können gleichzeitig wirken #
In einer Verzeichnisstruktur können mehrere .htaccess-Dateien vorhanden sein.
Eine Datei im übergeordneten Verzeichnis kann Einstellungen vorgeben, während eine weitere Datei in einem Unterverzeichnis zusätzliche Regeln enthält.
Wenn du einen Fehler untersuchst, solltest du deshalb nicht automatisch nur die erste gefundene Datei betrachten.
Beispiel einer Verzeichnisstruktur #
public_html/
.htaccess
index.php
shop/
.htaccess
index.phpIn diesem Beispiel können für das Verzeichnis shop sowohl übergeordnete als auch dort definierte Regeln relevant sein.
Regeln können sich gegenseitig beeinflussen #
Bei mehreren .htaccess-Dateien und komplexen Rewrite-Regeln kann das resultierende Verhalten schwer nachvollziehbar werden.
Dokumentiere deshalb eigene Anpassungen und vermeide unnötig doppelte Regeln.
Doppelte Weiterleitungen vermeiden #
Wenn eine Weiterleitung bereits durch WordPress, ein Plugin, cPanel oder eine andere Serverkonfiguration umgesetzt wird, solltest du dieselbe Logik nicht zusätzlich ohne Grund in .htaccess eintragen.
Mehrere konkurrierende Regeln können Weiterleitungsketten oder Schleifen verursachen.
cPanel-Umleitungen und .htaccess #
Wenn du eine Weiterleitung über die entsprechende cPanel-Funktion einrichtest, kann diese technisch ebenfalls über Webserver-Regeln umgesetzt werden.
Wenn du anschließend zusätzlich manuell an .htaccess arbeitest, solltest du deshalb prüfen, welche Regeln bereits vorhanden sind.
HTTPS-Weiterleitungen vorsichtig behandeln #
Weiterleitungen von HTTP auf HTTPS werden häufig über Webserver-Regeln umgesetzt.
Wenn deine Website bereits über eine andere Ebene eine HTTPS-Weiterleitung besitzt, kann eine zusätzliche manuelle Regel zu doppelten oder fehlerhaften Weiterleitungen führen.
Prüfe deshalb zuerst die vorhandene Konfiguration.
www und non-www nicht gleichzeitig widersprüchlich erzwingen #
Eine Website kann beispielsweise auf:
oder:
kanonisiert werden.
Problematisch wird es, wenn unterschiedliche Regeln gleichzeitig jeweils die andere Variante erzwingen.
Das kann zu einer Redirect-Schleife führen.
Regeln aus dem Internet nicht ungeprüft verwenden #
Viele ältere Anleitungen enthalten Regeln, die für eine bestimmte Serverkonfiguration, Apache-Version oder Anwendung geschrieben wurden.
Eine Regel kann deshalb auf einem anderen System unnötig, wirkungslos oder fehlerhaft sein.
Sicherheit: Übernimm nur Regeln, deren Zweck du verstehst und deren Quelle du einschätzen kannst. Besonders unbekannte Rewrite- und Zugriffsregeln solltest du nicht ungeprüft auf einer produktiven Website einsetzen.
Keine Zugangsdaten in .htaccess-Kommentaren speichern #
Kommentare sind praktisch für technische Hinweise, aber kein sicherer Speicherort für vertrauliche Informationen.
Speichere dort keine:
- Passwörter
- API-Schlüssel
- Datenbankzugänge
- persönlichen Zugangsdaten
.htaccess-Datei nicht öffentlich bereitstellen #
Wenn du Support benötigst, solltest du den Inhalt sensibler Konfigurationsdateien nicht ungeprüft öffentlich in Foren oder sozialen Netzwerken veröffentlichen.
Entferne beziehungsweise anonymisiere vertrauliche Informationen, bevor du Ausschnitte weitergibst.
Änderungen dokumentieren #
Bei einer produktiven Website lohnt es sich, wichtige manuelle Änderungen nachvollziehbar zu dokumentieren.
Du kannst beispielsweise einen Kommentar ergänzen:
# CURIAWEB - permanente Weiterleitung alte URL
Redirect 301 /alt/ https://example.com/neu/Zusätzlich solltest du außerhalb der Datei festhalten, wann und warum die Änderung vorgenommen wurde.
Temporäre Backup-Dateien wieder entfernen #
Wenn du Kopien wie:
.htaccess-backup
.htaccess-old
.htaccess-test
erstellt hast, solltest du nach Abschluss der Arbeiten prüfen, ob diese noch benötigt werden.
Lass unnötige Konfigurationskopien nicht dauerhaft in öffentlich erreichbaren Verzeichnissen liegen.
Empfohlener Ablauf bei einer .htaccess-Änderung #
- Öffne Dateien → Dateimanager.
- Aktiviere die Anzeige versteckter Dateien.
- Öffne den Dokumentenstamm der richtigen Website.
- Suche
.htaccess. - Lade die Originaldatei als Sicherung herunter.
- Öffne
.htaccessim Editor. - Ändere nur die notwendige Regel.
- Speichere die Datei.
- Teste die betroffene Website-Funktion sofort.
- Stelle bei einem Fehler die vorherige Version wieder her.
Empfohlener Ablauf bei einem Fehler #
- Prüfe, ob der Fehler unmittelbar nach einer
.htaccess-Änderung auftrat. - Stelle die zuvor gesicherte Version wieder her.
- Teste die Website erneut.
- Falls keine Sicherung vorhanden ist, benenne
.htaccesskurzzeitig zur Diagnose um. - Prüfe, ob sich das Fehlerbild verändert.
- Analysiere anschließend die verdächtigen Regeln einzeln.
- Stelle die benötigte korrekte Konfiguration wieder her.
Grundregel: Verwende
.htaccessgezielt. Sichere die Datei vor Änderungen, ändere nur eine Sache gleichzeitig und teste unmittelbar danach.
Wann solltest du den Support kontaktieren? #
Wenn eine Website nach einer .htaccess-Änderung nicht mehr erreichbar ist oder eine Regel nicht wie erwartet funktioniert, solltest du die zuletzt vorgenommene Änderung dokumentieren.
Für eine Analyse sind insbesondere folgende Angaben hilfreich:
- betroffene Domain
- Verzeichnis der
.htaccess - welche Funktion umgesetzt werden sollte
- welche Regel geändert beziehungsweise ergänzt wurde
- welcher Fehler anschließend auftritt
- ob die Website mit der vorherigen
.htaccessfunktioniert - gegebenenfalls der HTTP-Fehlercode
Teile keine Passwörter, API-Schlüssel oder andere vertrauliche Zugangsdaten innerhalb einer normalen Fehlerbeschreibung mit.
Zusammenfassung #
.htaccess ist eine wichtige Konfigurationsdatei für Websites auf entsprechend konfigurierten Apache-basierten Webservern. Sie kann unter anderem Weiterleitungen, Rewrite-Regeln, Zugriffsbeschränkungen und WordPress-Permalink-Regeln enthalten.
Da die Datei mit einem Punkt beginnt, musst du im cPanel-Dateimanager gegebenenfalls zuerst Verborgene Dateien anzeigen (dotfiles) aktivieren.
Erstelle vor jeder Änderung eine Sicherung der vorhandenen Datei. Bearbeite anschließend nur die tatsächlich notwendige Regel und teste die Website unmittelbar nach dem Speichern.
Wenn nach einer Änderung ein 500- oder 403-Fehler erscheint, stelle zuerst die vorherige Version wieder her beziehungsweise verwende ein kurzfristiges Umbenennen nur zur gezielten Diagnose.
Kopiere keine unbekannten .htaccess-Regeln oder vollständigen Konfigurationsdateien fremder Websites ungeprüft in deine eigene Installation. Gerade bei Rewrite- und Weiterleitungsregeln können kleine Unterschiede große Auswirkungen haben.
