Egy hibás szabály is elég ahhoz, hogy a weboldal ne legyen elérhető, vagy a látogatót végtelen átirányítási körbe küldje. A htaccess átirányítás ezért nem pusztán egy sor kód beillesztése: a cél URL, az állapotkód és a szabályok sorrendje egyaránt számít.
Nem mindig egyértelmű, hol található a .htaccess fájl, vagy mikor érdemes 301-es, illetve 302-es átirányítást használni. Az Apache webszerveren a fájl egy könyvtár és annak alkönyvtárai beállításait tartalmazhatja. A működéshez az is szükséges, hogy az Apache konfigurációja engedélyezze a használatát. cPanelben a fájlkezelővel szerkesztheti a fájlt, ha a szerverkörnyezet támogatja a szükséges szabályokat.
Az útmutató bemutatja, hogyan működik a .htaccess átirányítás, milyen szabályok használhatók a gyakori helyzetekben, és miben tér el az ideiglenes átirányítás az állandótól. A biztonságos módosítás menetén is végigvezetjük, a biztonsági mentéstől a célzott tesztelésig és a változtatás visszavonásáig. Így élesítés előtt ellenőrizheti a cél URL-t, a válaszkódot és az esetleges átirányítási hurkokat.
Mi az a .htaccess átirányítás, és mikor használható?
A .htaccess átirányítás Apache-szerveroldali szabály, amely egy beérkező kérést másik URL-re vagy útvonalra irányít. A szerver az új címet tartalmazó választ küld a böngészőnek, amely ezután lekéri a céloldalt. A fájl szabályai könyvtárszinten érvényesülnek, ha az Apache konfigurációja engedélyezi őket.
Az átirányítás például akkor hasznos, ha megváltozik egy oldal címe, egy megszűnt aloldal helyett megfelelő új tartalomra szeretné vezetni a látogatókat, vagy a HTTP-címet HTTPS-re irányítaná. A szerver belső URL-átírást is végezhet. Ilyenkor a kérést a háttérben más útvonalon szolgálja ki, de a böngésző címsorában nem feltétlenül változik meg az URL. A két művelet tehát nem azonos.
A böngészőoldali megoldás, például egy HTML-oldal automatikus továbbküldése, csak az oldal betöltése után fut le. Az alkalmazásoldali átirányítást a webhely programkódja kezelheti. A URL átirányítás áttekintése bemutatja ezeket a megközelítéseket és az Apache-hoz kapcsolódó lehetőségeket. A htaccess átirányítás előnye, hogy a szabályt az alkalmazás kódjának módosítása nélkül, a szerver kéréskezelése során lehet érvényesíteni.
- Régi oldal új címre költözik, és a látogatókat az új tartalomhoz kell vezetni.
- A webhelynek egyetlen címváltozatát szeretné használni, például www előtaggal vagy anélkül.
- A nem titkosított HTTP-kéréseket HTTPS-címre irányítaná.
- Egy megszűnt útvonal helyett annak tartalmilag megfelelő oldalát jelölné ki.
Hol található a .htaccess fájl?
A webhely gyökérkönyvtára az a mappa, ahonnan a fő webes tartalom kiszolgálása indul. Az itt található .htaccess fájl szabályai az alkönyvtárakra is kiterjedhetnek. Egy alkönyvtár saját fájlja az adott mappára és annak almappáira vonatkozhat. A fájlnév ponttal kezdődik, ezért egyes fájlkezelők alapértelmezés szerint elrejtik. cPanelben a fájlkezelővel megkeresheti a webhely könyvtárait. Ellenőrizze a rejtett fájlok megjelenítését is.
Milyen szerverkörnyezetben működik a .htaccess?
A .htaccess fájl az Apache webszerver könyvtárszintű beállításaihoz használható. Az Apache központi konfigurációja határozza meg, hogy a fájl milyen direktívákat tartalmazhat. Ezért egy szabály akkor sem feltétlenül működik, ha a fájl jó helyen van, és a szintaxisa helyes. Egyes átirányításokhoz a mod_rewrite modul is szükséges. Az Nginx nem alkalmazza a .htaccess szabályait, ott az átirányítást más szerverkonfigurációban kell megadni.
Hogyan működnek az átirányítási szabályok a .htaccess fájlban?
A htaccess átirányítás szabálya meghatározza, hogy az Apache milyen választ adjon egy kérésre, és szükség esetén melyik új címre irányítsa a látogatót. Egyszerű címcseréhez általában elegendő a Redirect direktíva. Összetettebb feltételekhez, például minták illesztéséhez a RewriteRule használható. A példákban szereplő útvonalakat és domainneveket igazítsa a saját webhelyéhez.
301 Vagy 302: melyik átirányítási kódot válassza?
A 301-es kód tartós címváltozást jelez. Akkor válassza, ha az oldal véglegesen új URL-re költözött. A 302-es kód ideiglenes átirányítást jelez, például rövid teszt vagy átmeneti változtatás esetén. Ha végleges költözésnél 302-t használ, a böngészők és más rendszerek ideiglenesnek értelmezhetik a változást. A kódot ezért a költözés tényleges szándéka szerint válassza ki.
Kód
Cél
Jelzés
Tipikus használat
301
Állandó átirányítás
A cím tartósan megváltozott
Végleges oldal- vagy domainköltözés
302
Ideiglenes átirányítás
A régi cím később ismét használható
Átmeneti átirányítás vagy tesztelés
Redirect vagy RewriteRule: mikor melyik szabály kell?
A Redirect az Apache mod_alias moduljának direktívája. Egyszerű, egyértelmű átirányításhoz használható, például így:
Redirect 301 /regi-oldal https://pelda.hu/uj-oldal
A RewriteRule a mod_rewrite modul része, és rugalmasabban illeszt útvonalakat. Használatához be kell kapcsolni a RewriteEngine-t. Az alábbi példa a megadott útvonalat irányítja át:
RewriteEngine On
RewriteRule ^regi-oldal/?$ https://pelda.hu/uj-oldal [R=301,L]
A példában az R=301 állandó átirányítást jelöl, az L pedig azt, hogy az Apache ne dolgozza fel tovább a későbbi szabályokat az aktuális kérésre. Ideiglenes átirányításhoz az R értékét cserélje 302-re. A mod_rewrite modulnak és a szükséges direktíváknak engedélyezettnek kell lenniük az Apache konfigurációjában, különben a szabály nem működik, vagy szerverhibát okozhat. A 301 átirányítások .htaccess fájlban történő beállításáról további példákat talál.
Élesítés előtt ellenőrizze a forrásútvonalat, a célcímet és a státuszkódot. cPanel tárhelyen a fájlkezelővel szerkesztheti a fájlt, a szabály működését azonban külön is tesztelje.
Melyik htaccess átirányítás illik a gyakori weboldalhelyzetekhez?
A megfelelő szabály attól függ, mi változik: a domainnév, a kapcsolat protokollja vagy egy konkrét oldal útvonala. Az alábbi példákban a pelda.hu helyére írja be a saját domainjét, az útvonalakat pedig igazítsa a webhely tényleges címeihez. Akkor biztonságos egy szabály, ha a céloldal létezik, és a régi címről oda vezető út egyértelmű.
Teljes domain, www és HTTPS átirányítása
A www-s és a www nélküli cím két külön hosztnév. Válasszon egy elsődleges változatot, például a www.pelda.hu címet, majd irányítsa át oda a másikat. Az alábbi szabály a nem titkosított kéréseket és a www nélküli címeket egy lépésben a www-s, HTTPS-változatra küldi. Helyezze el annak a webhelynek a .htaccess fájljában, amely az érintett kéréseket kezeli.
RewriteEngine On
RewriteCond %{HTTPS} !=on [OR]
RewriteCond %{HTTP_HOST} !^www\.pelda\.hu$ [NC]
RewriteRule ^ https://www.pelda.hu%{REQUEST_URI} [R=301,L]
HTTPS-re csak akkor irányítson, ha a célcímen működik az SSL/TLS-kapcsolat, és érvényes tanúsítvány van beállítva. Ellenkező esetben a látogató tanúsítványhibát láthat. A szabály mentése előtt nyissa meg közvetlenül a HTTPS-változatot, és ellenőrizze, hogy az oldal betöltődik-e. A tanúsítványok és a titkosított kapcsolat szerepéről az SSL/TLS tájékoztató ad további információt.
Ha a www nélküli címet választja elsődlegesnek, módosítsa a célhosztot, és igazítsa hozzá az egyezési feltételt is. Ne használjon egyszerre két egymással ellentétes szabályt. Ha például a www nélküli cím www-re irányít, a www-s cím pedig vissza, átirányítási hurok keletkezhet.
Egy oldal vagy könyvtár új címre költöztetése
Egyetlen cikk vagy aloldal költözésekor csak a régi útvonalat irányítsa át a tartalmilag megfelelő új címre. Például a https://pelda.hu/regi-cikk legyen a forrás, a https://pelda.hu/uj-cikk pedig a cél:
RewriteRule ^regi-cikk/?$ https://pelda.hu/uj-cikk [R=301,L]
Könyvtár áthelyezésekor döntse el, hogy meg kell-e őrizni az alkönyvtárak útvonalát. Az alábbi példa a /hirek/2025/anyag címet a /blog/2025/anyag útvonalra irányítja, így megőrzi a könyvtárnév utáni útvonalszakaszt:
RewriteRule ^hirek/(.*)$ /blog/$1 [R=301,L]
WordPress esetén a tartalomkezelő saját átírási szabályai is szerepelhetnek a fájlban. Az egyedi átirányítást ezek elé helyezze, hogy a kérés először a célzott szabályon haladjon át. Módosítás előtt ellenőrizze a meglévő bejegyzéseket és az állandó hivatkozások beállításait. A WordPress működéséhez szükséges tárhelykörnyezet részleteit a webtárhely-megoldások ismertetése segít áttekinteni.
Hogyan állítsa be és tesztelje biztonságosan az átirányítást?
A biztonságos módosítás négy lépésből áll: mentse el az eredeti fájlt, adjon hozzá egyetlen szabályt, ellenőrizze a működését, majd szükség esetén állítsa vissza a korábbi állapotot. A htaccess átirányítás akkor kezelhető könnyebben, ha egyszerre csak egy változtatást végez. Hiba esetén így egyszerűbb megtalálni a problémás sort.
A fájl módosítása előtt készítsen visszaállítható mentést
Készítsen másolatot az eredeti .htaccess fájlról, és őrizze meg olyan helyen, ahonnan szükség esetén vissza tudja állítani. A fájl tartalmát külön szöveges dokumentumba is elmentheti. Az eredetit mindaddig őrizze meg, amíg az új szabály megfelelően nem működik.
Fájlkezelőben töltse le vagy nevezze át a meglévő fájlt, majd készítsen róla másolatot, és azon dolgozzon. cPanelben a fájlkezelő segít a webhely fájljainak kezelésében. A felület bemutatását a cPanel tárhely lehetőségei között is megismerheti. Ne töröljön vagy írjon át egyszerre több, egymástól független szabályt. Ellenőrizze külön az új sort és azt a környezetét is.
Adjon hozzá célzott szabályt, majd próbálja ki
Az alábbi Apache-példa egyetlen útvonalat irányít át. A mod_rewrite használatához be kell kapcsolni a RewriteEngine-t, a modulnak és a direktívának pedig engedélyezettnek kell lennie az adott környezetben.
RewriteEngine On
RewriteRule ^regi-oldal/?$ https://pelda.hu/uj-oldal [R=301,L]
A /regi-oldal helyére írja be a saját forrásútvonalát, a célcím helyére pedig az új URL-t. Mentés után közvetlenül a régi címet nyissa meg, ne csak a főoldalt. Kérésenként ellenőrizze a működést, és ne feltételezze, hogy a változás csak egy adott idő elteltével lép életbe.
Ellenőrizze a válaszkódot, a célcímet és a hurkokat
Az egyedi szabály tesztje és a teljes webhely ellenőrzése két külön feladat. Először a régi URL-en nézze meg, hogy a válasz a megfelelő státuszkódot adja-e, és pontosan a kívánt célra vezet-e. Ezután külön nyissa meg az új címet, majd próbálja végig a fő navigációt és néhány fontos aloldalt. Tartós költözésnél 301-es, átmeneti helyzetben 302-es választ várjon.
- Átirányítási lánc: az eredeti cím egy köztes URL-re, majd egy további címre vezet. Ha lehetséges, irányítsa közvetlenül a végleges célra.
- Átirányítási hurok: két vagy több cím egymásra mutat, így a böngésző nem jut el egy betöltődő oldalhoz.
- Szerverhiba: ha a módosítás után az oldal hibát ad vagy nem töltődik be, állítsa vissza a mentett fájlt, majd ellenőrizze a szabály szintaxisát és az engedélyezett direktívákat.
A teszteléskor ellenőrizze a régi URL-t, a céloldalt és a webhely fő útvonalait is. Ha az átirányítás nem a várt módon működik, ne adjon hozzá találomra újabb feltételeket. Állítsa vissza a mentett fájlt, majd egyetlen módosítással kezdje újra az ellenőrzést.
Mit tegyen, ha a .htaccess átirányítás hibát okoz?
Ha a webhely egy szabály hozzáadása után hibásan működik, először azonosítsa a tünetet. Az 500-as szerverhiba konfigurációs vagy szintaktikai problémára utalhat, a rossz céloldal hibás útvonalra, az ismétlődő átirányítás pedig egymásra ható szabályokra. Ezek eltérő hibák, ezért ne módosítson egyszerre több sort találomra. A htaccess átirányítás javításánál az utolsó változtatás visszavonása adja a legbiztonságosabb kiindulópontot.
500-As hiba vagy hibás oldalbetöltés esetén
Állítsa vissza az utolsó működő .htaccess fájlt, hogy újra elérhető legyen a webhely. Ezután vizsgálja meg a hozzáadott direktíva írásmódját, a zárójeleket, a jelölőket és a cél URL-t. A helyes szintaxisú szabály is hibát okozhat, ha a szerverkörnyezet nem engedélyezi a direktívát vagy a modult. Ne feltételezze, hogy minden Apache-beállítás használható könyvtárszinten.
A hibanapló segíthet megállapítani, melyik kérésnél vagy fájlnál jelentkezett a probléma. Keresse meg a módosítás időpontjához kapcsolódó bejegyzéseket, és vesse össze azokat a fájl aktuális tartalmával. Naplóbejegyzés nélkül ne következtessen egyetlen konkrét okra. Ha a régi verzió visszaállítása után megszűnik a hiba, a szabályt a többi módosítástól elkülönítve ellenőrizze.
Végtelen átirányítás vagy rossz cél esetén
Ha a böngésző túl sok átirányítást jelez, ellenőrizze, hogy két szabály nem küldi-e egymásra ugyanazokat a címeket. Előfordulhat például, hogy egy szabály a www-s változatot www nélküli címre irányítja, egy másik pedig az ellenkező irányt írja elő. Azt is vizsgálja meg, hogy a cél URL nem felel-e meg újra a forrásra illeszkedő feltételnek. Ilyenkor a szabály ismételten aktiválódhat.
Rossz céloldal esetén hasonlítsa össze a kért útvonalat a szabályban megadott céllal. Ellenőrizze a könyvtárneveket, a perjeleket, valamint azt, hogy a cél relatív vagy teljes URL-e. A láncban köztes címek is lehetnek, ezért kövesse végig, milyen URL-eken halad át a kérés.
- Ideiglenesen távolítsa el vagy vonja vissza az érintett szabályt, majd ellenőrizze, helyreállt-e a kívánt működés.
- Próbáljon ki egyetlen szabályt konkrét forrás- és célcímmel.
- Ha a teszt sikeres, fokozatosan állítsa vissza a többi módosítást, és minden lépés után ellenőrizze az eredményt.
Ha a szintaxis megfelelőnek tűnik, de a hiba a visszaállítás után is fennáll, ellenőrizze a szerverkörnyezetet és a naplóbejegyzéseket. A megfelelő Apache-konfiguráció és a tárhely fájlkezelési lehetőségei megkönnyítik a szabályok áttekinthető karbantartását. Ismerje meg az aWh webtárhely-megoldásait, ha webhelyéhez illeszkedő tárhelykörnyezetet keres.
Alakítson ki következetes átirányítási gyakorlatot
A htaccess átirányítás nem egyszeri beállítás, ha a webhely címei idővel változnak. Jegyezze fel, melyik régi útvonal hová vezet, és miért van szükség az adott szabályra. Így később könnyebb felismerni az elavult bejegyzéseket, és kisebb az esélye annak, hogy egy új módosítás felülírja a korábbi működést. A nyilvántartás akkor is hasznos, ha többen kezelik a webhely fájljait.
A megbízható tárhelykörnyezet a webhely napi működésének fontos alapja. Az aWh több mint 10 éves tapasztalattal kínál webtárhelyet, cPanel tárhelyet és VPS tárhelyet. A biztonsági mentés és a kétfaktoros hitelesítés szintén szempont lehet a tárhely kiválasztásakor.
Ha webhelyéhez illeszkedő tárhelymegoldást keres, tekintse meg az aWh webtárhely-megoldásait. Az automatikus biztonsági mentés, a HTTPS és a kétfaktoros hitelesítés segíthet abban, hogy tárhelye és webhelye kezelése biztonságosabb legyen.
Gyakori kérdések a .htaccess átirányításról
Működik a .htaccess átirányítás Nginx szerveren is?
Nem, az Nginx önmagában nem olvassa és nem alkalmazza az Apache .htaccess fájljait. Az átirányítást az Nginx saját szerverkonfigurációjában kell megadni. Ha nem biztos benne, melyik webszerver kezeli a kéréseket, ellenőrizze a tárhely beállításait. Vegyes rendszerben az is számít, melyik kiszolgálón halad át először a kérés, mert az átirányítás másik rétegben is történhet.
Mi történik, ha a .htaccess fájlban hibás szintaxis szerepel?
A hibás direktíva vagy szintaxis Apache esetén 500-as szerverhibát okozhat, és több oldal betöltését is megakadályozhatja. A pontos hatás attól függ, hol található a hiba, és hogyan dolgozza fel a szerver a konfigurációt. Ha a hiba a fájl módosítása után jelentkezik, állítsa vissza az előző működő változatot. Ezután vizsgálja meg a naplóbejegyzést, és külön ellenőrizze a módosított sort.
Megőrzi az átirányítás a lekérdezési paramétereket?
Gyakran igen, de ez a használt Apache-direktívától és a cél URL formájától függ. Például a ?ref=hírlevél paraméter követheti az átirányítást, ha a szabály nem cseréli le vagy távolítja el a lekérdezési részt. Teszteljen olyan címmel is, amely több paramétert, például követőkódot és szűrőt tartalmaz. Ellenőrizze, hogy a céloldal a várt értékeket kapja-e meg.
Beállítható átirányítás csak egy adott aldomainre?
Igen. A szabály elé helyezett RewriteCond %{HTTP_HOST} feltétellel ellenőrizheti, melyik aldomainre érkezett a kérés. Például a shop.pelda.hu hosztnévhez kötött feltétel kizárhatja a fődomaint és más aldomaineket. A hosztnevet pontosan igazítsa a kívánt címhez, és ellenőrizze a kis- és nagybetűk kezelését. Így az átirányítás csak az érintett aldomain kéréseire vonatkozik.
Hogyan lehet ideiglenesen kikapcsolni egy .htaccess szabályt?
Tegyen kettőskeresztet a szabály elé, így az Apache megjegyzésként kezeli, és nem hajtja végre. Ha a szabályhoz feltételsorok is tartoznak, azokat is kapcsolja ki, különben egy megmaradt feltétel másik szabályra is hatással lehet. Módosítás előtt őrizze meg az eredeti fájlt. A próba után távolítsa el a kettőskeresztet, ha újra aktiválni szeretné a szabályt.
Miért nem változik meg az átirányítás a szabály módosítása után?
Előfordulhat, hogy a böngésző megőrizte egy korábban kapott állandó átirányítás eredményét. Próbálja meg az URL-t privát böngészőablakban vagy másik böngészőből megnyitni. Ha ott is a régi útvonal érvényesül, ellenőrizze, hogy a megfelelő .htaccess fájlt módosította-e, és valóban Apache kezeli-e a kérést. Köztes gyorsítótár vagy alkalmazásbeállítás is befolyásolhatja a tesztet.
Alkalmazható külön .htaccess fájl egy alkönyvtárra?
Igen. Az alkönyvtár saját .htaccess fájljában megadott direktívák az adott mappa kéréseire vonatkozhatnak, ha a szerver konfigurációja engedélyezi ezt. Például a /webshop/ mappában elhelyezett fájlban kezelheti a webáruház útvonalait anélkül, hogy ugyanazt a szabályt a teljes webhelyre alkalmazná. A szülőkönyvtár beállításai is hatással lehetnek a működésre, ezért az érintett útvonalon teszteljen.
2026-10-10