Het slechtste uur van een site migratie die ik ooit deed was besteed aan het staren naar een 500 fout op een live site, en de oorzaak was een enkel verdwaald personage in een .htaccess bestand Ik had met de hand geschreven een partij omleidingen voor een WordPress rebuild, vet-vingerige een RewriteRule vlag, en Apache reageerde door te weigeren om het hele domein te bedienen De omleidingen zelf waren prima; de syntaxis om hen heen was niet, en .htaccess is onvergeeflijk op die manier Daarna ben ik gestopt met het schrijven van omleidingsregels met de hand en begon ze te genereren, wat precies de Htaccess-omleidingsgenerator op Toolz.dev doet.Deze gids behandelt hoe Apache werk omleidt, wanneer elk type moet worden gebruikt en hoe HTTPS en www heilig kunnen worden verklaard zonder iets te breken.
tl;dr: Een .htaccess-bestand vertelt Apache hoe URL's om te leiden Gebruik een 301 voor permanente bewegingen, een 302 voor tijdelijke,
Redirectvoor exacte paden, enRewriteRulevoor patronen De Htaccess-omleidingsgenerator bouwt al deze plus force-HTTPS- en www-regels op vanuit een eenvoudige lijst, correct geordend, volledig in uw browser zonder dat er iets is geüpload.
Wat is een htaccess redirect generator?
Een .htaccess redirect generator zet een gewone lijst van oud-naar-nieuw URL mappings om in de exacte Apache richtlijnen die de redirects uitvoeren Welke statuscode je kiest is een protocol vraag, geen Apache: RFC 9110 definieert 301 als permanent en 302 zoals gevonden Het .htaccess-bestand is een configuratiebestand per map dat Apache bij elk verzoek leest, en bij gedeelde hosting is het meestal de enige plaats waar u omleidingen kunt declareren, omdat u de hoofdserverconfiguratie niet kunt bewerken De generator schrijft beide smaken van omleiding Apache ondersteunt: de mod_alias Redirect richtlijn voor eenvoudige één-op-één padwijzigingen en de mod_rewrite RewriteRule richtlijn voor patroonmatches die veel URL's tegelijk bevatten.
De reden om deze te genereren in plaats van ze te typen is dat de syntaxis van .htaccess nauwkeurig en straffend is. Een misplaatste vlag, een onontsnapte stip in een patroon of een regel in de verkeerde volgorde levert geen waarschuwing op; het levert een fout van 500 op die de hele site verwijdert totdat je hem vindt en repareert. De richtlijnen moeten ook in een specifieke volgorde verschijnen, waarbij de herschrijfengine is ingeschakeld vóór een RewriteRule en regels voor de hele site vóór regels op paginaniveau, of ze gedragen zich op manieren die moeilijk te debuggen zijn. Een generator codeert die volgorde en syntaxis, zodat je het niet subtiel verkeerd kunt krijgen.
Op Toolz.dev spiegelt de flow hoe je eigenlijk over een migratie denkt Je somt elk oud pad en zijn nieuwe bestemming op, kiest of de verhuizing permanent of tijdelijk is en of het een exact pad of een patroon is, en schakelt optioneel de twee site-brede regels in die bijna elke site nodig heeft De tool stelt het hele bestand in de juiste volgorde samen en markeert alles wat verdacht is, zoals een regel die een pad naar zichzelf omleidt, voordat je het op je site plakt.
Wat is het verschil tussen een 301 en een 302-omleiding?
Een 301 is een permanente omleiding en een 302 is een tijdelijke, en naar een zoekmachine is dat onderscheid het hele punt Een 301 vertelt browsers en crawlers dat de pagina voorgoed is verplaatst, en zoekmachines reageren door bijna alle oude URL' s verzamelde rankingsignalen naar het nieuwe adres en uiteindelijk de oude URL uit hun index te laten vallen Een 302 vertelt hen dat de verhuizing tijdelijk is, dus ze houden de originele URL geïndexeerd en gerangschikt en behandelen de bestemming als een stand-in die zal verdwijnen.
Het kiezen van de verkeerde heeft echte gevolgen Gebruik een 302 voor een permanente verhuizing en zoekmachines kunnen de oude URL gerangschikt houden terwijl uw nieuwe pagina moeite heeft om zijn eigen autoriteit te verzamelen, omdat de signalen nooit zijn overgedragen Gebruik een 301 voor iets echt tijdelijks, zoals een pagina die niet beschikbaar is voor onderhoud of een seizoensgebonden landingspagina, en u kunt de ranglijst van het origineel permanent verliezen zodra de situatie terugkeert. De vuistregel is eenvoudig: als de oude URL nooit meer terugkomt, gebruik dan 301; als dat zo is, gebruik dan 302.
Hier is hoe de twee zich verhouden tot de eigenschappen die er toe doen:
| Property | 301 Permanent | 302 Tijdelijk |
|---|---|---|
| veelbetekenend | Page is voorgoed verhuisd | Page is tijdelijk elders |
| Rangschikkingssignalen | Overgezet naar de nieuwe URL | Blijf bij de originele URL |
| Oude URL in index | Uiteindelijk gedaald | gevangen |
| Typisch gebruik | Herontwerpen, migraties, samengevoegde pagina's | Onderhoud, A/B-tests, seizoenspagina's |
| Browsercaching | Agressief in de cache opgeslagen | Standaard niet in de cache opgeslagen |
Met de generator kunt u de status per regel instellen, dus een migratie die meestal permanente bewegingen is met één tijdelijke promotionele omleiding is een enkele gemengde lijst in plaats van twee bestanden. Omdat 301's agressief in de cache worden opgeslagen door browsers, is het de moeite waard om ze de eerste keer goed te krijgen; een verkeerde 301 kan blijven bestaan in een bezoeker's-browser lang nadat u de server hebt gerepareerd.
Wanneer moet ik omleiding versus rewriterule gebruiken?
Gebruik de Redirect richtlijn voor een exacte, één-op-één padverandering, en een RewriteRule wanneer u een patroon moet matchen. Redirect 301 /old-page /new-page is de hele regel voor het verplaatsen van een enkele pagina, en het is leesbaar, moeilijk om fout te krijgen, en afgehandeld door Apache' s mod_alias module Wanneer u een handvol specifieke pagina's die elk verplaatst naar een specifieke nieuwe locatie, een lijst van Redirect lijnen is de duidelijkste en veiligste manier om het uit te drukken.
a RewriteRule verdient zijn complexiteit wanneer één regel veel URL's moet vangen Als elk bericht onder /blog/2023/ verplaatst naar hetzelfde pad zonder het jaartal, schrijvend a Redirect regel voor elke post zou honderden regels zijn; een enkele RewriteRule ^blog/2023/(.*)$ /blog/$1 [R=301,L] behandelt ze allemaal door het onderdeel na het jaar vast te leggen en te hergebruiken op de bestemming. De kracht komt van reguliere expressies en capture-groepen, maar dat geldt ook voor het risico, omdat een onontsnapt speciaal personage of een hebzuchtig patroon veel meer kan matchen dan je bedoelde.
De generator kiest de juiste richtlijn voor u op basis van het wedstrijdtype dat u per regel kiest: exacte regels worden Redirect lijnen en patroonregels worden RewriteRule lijnen, waarbij de herschrijf-engine automatisch wordt ingeschakeld wanneer er een patroonregel aanwezig is, Het houdt de twee groepen ook in de juiste volgorde in de uitvoer Als u nieuw bent in het schrijven van de patronen zelf, dan is de regex-tester hiermee kunt u een patroon controleren aan de hand van voorbeeld-URL's voordat u het in een omleiding vertrouwt. Zo bevestig ik dat een opnamegroep doet wat ik verwacht.
Hoe forceer ik HTTPS in htaccess?
Om HTTPS te forceren, voegt u een herschrijfvoorwaarde toe die controleert of het huidige verzoek nog niet veilig is, gevolgd door een regel die doorverwijst naar de https-versie van dezelfde host en hetzelfde pad. Het standaardformulier controleert %{HTTPS} off en dan herschrijft naar https://%{HTTP_HOST}/$1 met een 301, dus elk gewoon-HTTP-verzoek wordt permanent geüpgraded naar de gecodeerde versie van de identieke URL. Het bedienen van een site over zowel http als https zonder deze omleiding betekent dat zoekmachines twee versies van elke pagina kunnen indexeren, waardoor uw rankingsignalen ertussen worden gesplitst.
De subtiliteit is bestellen De HTTPS-regel moet lopen voordat een host herschrijft, zoals het toevoegen of verwijderen van www, zodat die latere regels ook op het beveiligde schema terechtkomen in plaats van een bezoeker van http naar https te sturen en vervolgens via een tweede omleiding Dit verkeerd krijgen levert omleidingsketens op, waarbij een enkel verzoek door twee of drie hops stuitert voordat het aankomt, wat langzamer is voor gebruikers en het rankingvoordeel van de omleiding verwatert De generator plaatst de HTTPS-regel precies om deze reden op de eerste plaats.
Schakel Force HTTPS in de tool in en deze voegt de juiste voorwaarde en regel bovenaan de uitvoer in, vóór uw paginaomleidingen en www-regel. Omdat HTTPS nu een basisverwachting is in plaats van een optionele extra, en browsers plain-http-pagina's steeds vaker als onveilig markeren, is dit een regel die ik aan vrijwel elke site toevoeg. Het past op natuurlijke wijze bij de volgende canonieke hostregel, en samen regelen ze een site op precies één adres voor elke pagina.
Hoe verwijs ik www naar non-www of omgekeerd?
U canonicaliseert het voorvoegsel www met een herschrijfregel die de host controleert en doorverwijst naar de versie die u hebt gekozen Om www te verwijderen, matcht u hosts die beginnen met www., leg de rest vast en stuur deze door naar het kale domein; om nl toe te voegen, matcht u hosts waarmee niet wordt begonnen www. en doorverwijzen naar de prefixed versie Hoe dan ook, het doel is dat elke pagina bereikbaar is bij precies één canonieke host, omdat het dezelfde inhoud bij beide serveert www.example.com en example.com is een klassiek probleem met dubbele inhoud dat rankingsignalen splitst, net zoals een onopgeloste http/https-splitsing dat doet.
Er is geen SEO voordeel om www over niet-www of het omgekeerde; waar het om gaat is dat je er een kiest en deze consequent afdwingt Grote sites die historisch gezien om technische redenen werden gebruikt www rond cookies en subdomeinen, terwijl veel moderne sites het kortheidshalve laten vallen Het belangrijkste is dat zodra je kiest, elke link, elke canonieke tag en elke omleiding op dezelfde versie wijst, zodat zoekmachines al je autoriteit consolideren op één host in plaats van deze te verdelen.
De generator biedt een enkele www-instelling met drie opties: laat deze ongewijzigd, forceer www of verwijder www. Het schrijft de matchingvoorwaarde en -regel en plaatst deze na de HTTPS-regel, zodat de twee samenwerken in plaats van keten. Welke host u ook kiest, het moet ook degene zijn in uw canonieke tags en uw sitemap, dus het is de moeite waard om uw sitemap met dezelfde canonieke host en het declareren van uw crawlregels in een matching robots.txt. Consistentie tussen alle drie zorgt ervoor dat de heiligverklaring daadwerkelijk blijft bestaan.
Werken deze omleidingen op nginx?
Nee. Het .htaccess formaat is specifiek voor de Apache webserver en de servers die deze opzettelijk emuleren, met name LiteSpeed Nginx leest helemaal geen.htaccess bestanden; het negeert ze volledig, dus het plakken van Apache richtlijnen in een Nginx setup doet niets Nginx handelt omleidingen met zijn eigen return en rewrite richtlijnen binnen server en location blokken in de hoofdconfiguratie, met behulp van een andere syntaxis en een ander evaluatiemodel.
Dit is belangrijk omdat een verrassend aantal omleidingsproblemen komt door het toepassen van de juiste regel op de verkeerde server Als uw omleidingen lijken te worden genegeerd, ongeacht wat u schrijft, het eerste dat u moet controleren is welke webserver daadwerkelijk uw site bedient, omdat een .htaccess-bestand op een Nginx-host inert is Vooral beheerde WordPress-hosts draaien soms Nginx voor of in plaats van Apache, en daar heeft het .htaccess-bestand dat u zorgvuldig hebt bewerkt geen effect.
De generator produceert Apache syntax, die de grote meerderheid van shared hosting en elke host waarop Apache of LiteSpeed draait dekt Als u op Nginx zit, vertaalt de logica van de regels zich direct, een permanente omleiding is nog steeds een 301 en een canonieke host is nog steeds een canonieke host, maar de syntaxis moet worden herschreven voor Nginx' s richtlijnen, wat een taak is voor uw host' s configuratie in plaats van een .htaccess bestand Weten op welke server u zich bevindt voordat u begint, bespaart de verwarring die ik heb zien slikken hele middagen.
Wanneer zou ik dit eigenlijk gebruiken?
Site migraties zijn het primaire geval Telkens wanneer ik een site herbouw, of het nu een WordPress project is dat naar nieuwe URL structuren gaat of een nieuwe build die een oude vervangt, elke oude URL die verkeer of backlinks had, heeft een 301 nodig naar zijn nieuwe thuis, of dat verkeer en autoriteit verdampen in 404s, Het vermelden van die mappings en het genereren van het omleidingsblok in één pass, correct geordend en syntactisch schoon, is veel veiliger dan het handmatig bewerken van een bestand dat de site over één typefout kan neerhalen De patroonregels behandelen hele secties die als groep zijn verplaatst.
Het afdwingen van HTTPS en een canonieke host is het dagelijkse geval Zelfs op een site zonder omleidingen op paginaniveau zijn de force-HTTPS- en www-regels de moeite waard om toe te voegen om rankingsignalen te consolideren en te voldoen aan de beveiligingsbasisregels die browsers nu verwachten. Ik genereer deze twee regels voor vrijwel elke nieuwe site en plak ze in vóór de lancering, dus de site is canoniek vanaf de eerste dag in plaats van later te worden opgeschoond zodra dubbele versies al zijn geïndexeerd.
Opruimen nadat het feit het heeft afgerond Oude omleidingen stapelen zich op, sommige keten door twee of drie hops, en een punt op pagina's die sindsdien weer zijn verplaatst Het regenereren van het hele blok uit een schone lijst, met de lus en formaat waarschuwingen die de tool biedt, is een goede manier om die ketens weer af te vlakken naar enkele hops Omleidingen zijn een hoek van on-site SEO, en ze zitten naast de meta tag generator en de rest van de toolkit op de pagina; het bredere argument om dit soort hulpprogramma's in de browser te behouden, is er een die ik in de browser maak Handleiding voor webontwikkelaars, en de productiviteitshoek in de Handleiding voor productiviteitstools voor .
Zijn mijn URL-gegevens privé?
Ja. elke regel wordt gegenereerd in JavaScript binnen uw browser De URL's die u invoert, uw domein en uw omleidingskaart worden nooit verzonden, gelogd of opgeslagen, en de tool blijft werken zonder netwerkverbinding zodra de pagina is geladen. Een omleidingskaart is in feite een diagram van uw site's-structuur en de meest waardevolle pagina's, en hoewel het niet geheim is in de manier waarop een wachtwoord is, is er geen reden om het door iemand anders te laten stromen's server alleen maar om een tekstbestand samen te stellen.
Omdat het werk lokaal gebeurt, kunt u een migratie offline plannen, de regels genereren op een laptop zonder verbinding en deze plakken wanneer u er klaar voor bent, zonder dat een deel van uw site' s URL-structuur het apparaat verlaat Die lokale-eerste benadering is dezelfde achter elke tool op Toolz.dev, en het betekent dat de tool net zo bruikbaar is in een vliegtuig als aan een bureau Het algemene argument om de voorkeur te geven aan browsergebaseerde tools die uw gegevens nooit uploaden, is er een die ik in het bureau heb uiteengezet gegevensprivacy in online tools gids.
FAQ
Wat is het verschil tussen een 301 en een 302-omleiding?
Een 301 is een permanente omleiding: het vertelt browsers en zoekmachines dat de pagina voorgoed is verplaatst en geeft bijna de hele oude URL' s-ranglijstsignalen door aan de nieuwe. Een 302 is tijdelijk: het stuurt bezoekers door, maar geeft aan dat de originele URL zijn ranglijst moet behouden en mag terugkeren. Gebruik 301 voor permanente zetten en 302 alleen als de wijziging echt tijdelijk is.
Waar plaats ik het htaccess-bestand?
Plaats het .htaccess-bestand in de hoofdmap van uw website, meestal de map die ook index.php of index.html bevat. Omleidingen die daar zijn aangegeven, gelden voor de hele site. De bestandsnaam begint met een punt en heeft geen extensie, en Apache moet allowOverRide ingeschakeld hebben voor de map, die de meeste gedeelde hosts standaard configureren.
Wanneer moet ik omleiding versus rewriterule gebruiken?
Gebruik de richtlijn mod_alias redirect voor een eenvoudige een-op-een padwijziging, zoals /old-page naar /new-page. Gebruik een mod_rewrite rewriterule wanneer u een patroon moet matchen, bijvoorbeeld het verzenden van elke URL onder /blog/2023/ naar hetzelfde pad zonder het jaar. Deze tool zendt omleiding uit voor exacte regels en herschrijfregel voor patroonregels automatisch.
Hoe forceer ik HTTPS in htaccess?
Schakel Force HTTPS in en de generator voegt een RewriteCond toe die controleert of HTTPS is uitgeschakeld, gevolgd door een RewriteRule die met een 301 doorverwijst naar de https-versie van dezelfde host en pad. Door deze regel vóór uw andere omleidingen te plaatsen, wordt ervoor gezorgd dat elk verzoek eerst wordt geüpgraded naar een beveiligde verbinding, zonder dat er extra hop wordt vastgeketend.
Werken deze omleidingen op nginx?
Nee. Het .htaccess-formaat is specifiek voor de Apache-webserver en servers die het emuleren, zoals LiteSpeed. Nginx leest geen .htaccess-bestanden en gebruikt zijn eigen herschrijf - en retourrichtlijnen in de serverconfiguratie, dus u zou deze regels moeten vertalen naar de Nginx-syntaxis Controleer op welke server uw site draait voordat u genegeerde omleidingen oplost.
Zullen deze omleidingen mijn SEO schaden?
correct gebruikt, omleidt om door te sturen naar SEO in plaats van schade te berokkenen. Een 301 behoudt de rangschikking van een verplaatste pagina en het canoniseren van HTTPS en WW voorkomt dat dubbele versies uw signalen splitsen. De risico's komen van omleidingsketens, loops of doorverwijzingen naar irrelevante pagina's, dus houd elke regel rechtstreeks op de meest relevante bestemming.
Kan één regel veel URL's tegelijk omleiden?
Ja. zet de regel in de patroonmodus en gebruik een reguliere expressie in het bronveld met capture-groepen, en verwijs ze vervolgens in de bestemming met $1, $2, enzovoort. Bijvoorbeeld ^blog/(.*)$ doorgestuurd naar /artikelen/$1 verplaatst elke pagina onder /blog/naar de overeenkomende pagina onder /artikelen/met een enkele regel.
Zijn mijn URL-gegevens privé?
Ja. de regels worden gegenereerd in uw browser met JavaScript Niets dat u invoert wordt geüpload, gelogd of opgeslagen, en de tool blijft werken zonder internetverbinding zodra de pagina is geladen Een omleidingskaart beschrijft uw site's-structuur, en met een client-side tool verlaat het uw apparaat nooit om het bestand samen te stellen.
Bouw uw omleidingen met de gratis Htaccess-omleidingsgenerator. Het schrijft Apache 301- en 302-regels, force-HTTPS en www-canonicalisatie uit een eenvoudige lijst, correct geordend, volledig in uw browser zonder dat er iets is geüpload.
