Website Redirects Configureren in ServBay
Website redirects sturen bezoekers automatisch van de ene URL naar een andere. Het instellen van redirects in een lokale ontwikkelomgeving is cruciaal om productiegedrag te simuleren, URL-structuurwijzigingen te testen of ervoor te zorgen dat oude links blijven werken in uw ontwikkelversie. ServBay, een krachtig lokaal webontwikkelplatform, maakt het eenvoudig om website redirects te configureren via de geïntegreerde webservers (Caddy of Nginx).
Overzicht
Binnen ServBay wordt elke website beheerd via een eigen webserverconfiguratie. Redirects worden ingesteld door het aanpassen van deze configuratiebestanden. ServBay ondersteunt Caddy en Nginx als webserver; u kiest de server die het beste bij uw project of voorkeur past. Het instellen van een redirect vereist meestal het aangeven van de bron-URL, de doel-URL en het type redirect (zoals 301 Permanent of 302 Tijdelijk).
Toepassingsscenario’s
Enkele veelvoorkomende redenen om website redirects binnen ServBay lokaal te configureren:
- Productieomgeving simuleren: Zorg dat uw lokale setup identiek is qua redirects aan uw live server.
- HTTPS testen: Dwing al het HTTP-verkeer om te leiden naar HTTPS en simuleer een veilige verbinding.
- URL normaliseren: Redirect domeinen mét
www
naar zonderwww
of omgekeerd, voor consistente URL’s. - URL-structuurwijzigingen verwerken: Redirect oude paden naar nieuwe, zodat u geen “pagina niet gevonden” fouten krijgt tijdens het testen.
- Domeinmigratie testen: Simuleer het redirecten van een oud domein naar een nieuw domein.
Vereisten
Om redirects te configureren in ServBay:
- Zorg dat ServBay geïnstalleerd en actief is.
- Voeg de website toe waarvoor u redirects wilt instellen en configureer deze binnen ServBay.
- Weet welke webserver uw website gebruikt: Caddy of Nginx.
Configuratiemethode
Elke website in ServBay heeft een eigen webserverconfiguratiebestand. U kunt deze eenvoudig openen en bewerken via de ServBay UI.
Het configuratiebestand van een website openen
- Open de ServBay-applicatie.
- Klik in de linker navigatiebalk op Websites (Website).
- Zoek de website waarvoor u redirects wilt instellen en klik op de naam om naar de detailpagina te gaan.
- Op de detailpagina klikt u op “Configuratiebestand” of een soortgelijke optie (de precieze naam kan per ServBay-versie verschillen). Hiermee opent u het relevante webserverconfiguratiebestand.
Volg vervolgens onderstaande instructies, afhankelijk van of uw website Caddy of Nginx als webserver gebruikt.
Redirects instellen met Caddy
Maakt uw website gebruik van Caddy, dan bewerkt u het Caddyfile. De syntaxis van het Caddyfile is eenvoudig en overzichtelijk.
Hieronder enkele veelgebruikte Caddy-configuraties voor redirects. Voeg deze toe in het Caddyfile van uw website, meestal binnen het site-adresblok ({}
).
Voorbeeld 1: HTTP naar HTTPS redirect
Caddy regelt standaard automatisch de HTTP-naar-HTTPS redirect als u een SSL-certificaat heeft ingesteld (via ServBay User CA of ACME). Wilt u meer controle, gebruik dan de redir
directive:
bash
servbay.demo {
# ... overig(e) configuratie ...
# Alle HTTP-verkeer forceren om te leiden naar HTTPS
# Indien u ServBay’s SSL gebruikt, is deze regel meestal niet nodig
# Voor aangepaste instellingen gebruikt u het volgende:
redir http://servbay.demo https://servbay.demo{uri} permanent
# ... overig(e) configuratie ...
}
1
2
3
4
5
6
7
8
9
10
2
3
4
5
6
7
8
9
10
Voorbeeld 2: Non-www naar www redirect
Redirect servbay.demo
naar www.servbay.demo
:
bash
servbay.demo {
# Alle verzoeken voor servbay.demo permanent omleiden naar www.servbay.demo
redir https://www.servbay.demo{uri} permanent
}
www.servbay.demo {
# Standaardconfiguratie voor www.servbay.demo
root * /Applications/ServBay/www/your-servbay-demo-site
file_server
# ... overig(e) configuratie ...
}
1
2
3
4
5
6
7
8
9
10
11
2
3
4
5
6
7
8
9
10
11
Voorbeeld 3: www naar non-www redirect
Redirect www.servbay.demo
naar servbay.demo
:
bash
www.servbay.demo {
# Alle verzoeken voor www.servbay.demo permanent omleiden naar servbay.demo
redir https://servbay.demo{uri} permanent
}
servbay.demo {
# Standaardconfiguratie voor servbay.demo
root * /Applications/ServBay/www/your-servbay-demo-site
file_server
# ... overig(e) configuratie ...
}
1
2
3
4
5
6
7
8
9
10
11
2
3
4
5
6
7
8
9
10
11
Voorbeeld 4: Redirect van een specifiek pad
Redirect van het oude /old-path
naar het nieuwe /new-path
:
bash
servbay.demo {
# ... overig(e) configuratie ...
# /old-path permanent omleiden naar /new-path
redir /old-path /new-path permanent
# /deprecated/page.html tijdelijk omleiden naar /new/page/
redir /deprecated/page.html /new/page/ temporary
# ... overig(e) configuratie ...
}
1
2
3
4
5
6
7
8
9
10
11
2
3
4
5
6
7
8
9
10
11
Caddy redirect types
permanent
: 301 Permanent Redirect, goed voor SEO.temporary
: 302 Tijdelijke Redirect.internal
: Interne rewrite, URL blijft hetzelfde (geen echte HTTP redirect).
Nadat u het Caddyfile heeft aangepast, slaat u het bestand op; ServBay zal de Caddy configuratie automatisch herladen of u vragen dit handmatig te doen.
Redirects instellen met Nginx
Gebruikt u Nginx als webserver, dan bewerkt u het Nginx configuratiebestand van uw website (doorgaans .conf
). Nginx gebruikt de return
of rewrite
directives om redirects uit te voeren. return
is eenvoudiger voor vaste redirects; rewrite
is flexibeler, ook met reguliere expressies.
Hieronder enkele gangbare voorbeelden voor Nginx-redirects. Voeg deze toe aan het .conf
bestand van uw website, meestal binnen een server
block.
Voorbeeld 1: HTTP naar HTTPS redirect
In ServBay, als uw website luistert op poorten 80 en 443, voegt u een redirect toe aan de server die op poort 80 luistert:
nginx
server {
listen 80;
listen [::]:80;
server_name servbay.demo www.servbay.demo;
# Alle HTTP-verkeer omleiden naar HTTPS
return 301 https://$host$request_uri;
}
server {
listen 443 ssl http2;
listen [::]:443 ssl http2;
server_name servbay.demo www.servbay.demo;
# ... overige HTTPS-configuratie ...
# ssl_certificate ...;
# ssl_certificate_key ...;
# Webroot, index, etc.
root /Applications/ServBay/www/your-servbay-demo-site;
index index.html index.htm index.php;
# ... overige location blocks ...
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
Voorbeeld 2: Non-www naar www redirect
Redirect servbay.demo
naar www.servbay.demo
:
nginx
server {
listen 80;
listen [::]:80;
server_name servbay.demo; # Luistert naar non-www domein
# Alles omleiden naar het www-subdomein, behoud URI en protocol
return 301 $scheme://www.servbay.demo$request_uri;
}
server {
listen 80;
listen [::]:80;
listen 443 ssl http2;
listen [::]:443 ssl http2;
server_name www.servbay.demo; # Luistert naar www-domein
# ... Normale configuratie voor www website ...
# ssl_certificate ...;
# ssl_certificate_key ...;
root /Applications/ServBay/www/your-servbay-demo-site;
index index.html index.htm index.php;
# ...
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
Voorbeeld 3: www naar non-www redirect
Redirect www.servbay.demo
naar servbay.demo
:
nginx
server {
listen 80;
listen [::]:80;
server_name www.servbay.demo; # Luistert naar www-domein
# Alles omleiden naar het non-www domein, behoud URI en protocol
return 301 $scheme://servbay.demo$request_uri;
}
server {
listen 80;
listen [::]:80;
listen 443 ssl http2;
listen [::]:443 ssl http2;
server_name servbay.demo; # Luistert naar non-www domein
# ... Normale configuratie voor non-www website ...
# ssl_certificate ...;
# ssl_certificate_key ...;
root /Applications/ServBay/www/your-servbay-demo-site;
index index.html index.htm index.php;
# ...
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
Voorbeeld 4: Redirect van specifiek pad (met location
en return
/rewrite
)
Redirect van het oude /old-path
naar het nieuwe /new-path
:
nginx
server {
# ... overige serverconfiguratie ...
location = /old-path {
# Matcht exact /old-path, permanent redirect naar /new-path
return 301 /new-path;
}
location /deprecated/ {
# Alle verzoeken onder /deprecated/ tijdelijk redirecten naar /archive/
rewrite ^/deprecated/(.*)$ /archive/$1 temporary;
}
# ... overige location blocks ...
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
2
3
4
5
6
7
8
9
10
11
12
13
14
15
Nginx redirect types
301
: Permanente redirect.302
: Tijdelijke redirect.redirect
: Gelijk aan 302.permanent
: Gelijk aan 301.
Na het aanpassen van het Nginx .conf
bestand slaat u het bestand op; ServBay zal de Nginx configuratie automatisch of na bevestiging herladen.
Tips en aandachtspunten
- Maak altijd een back-up: Maak altijd een back-up voordat u een configuratiebestand aanpast, zodat u kunt terugdraaien bij fouten.
- Controleer syntaxis: Check na aanpassen altijd even de configuratiesyntax. ServBay doet dit vaak automatisch, maar handmatig controleren geeft extra zekerheid. Voor Nginx kunt u bijvoorbeeld
nginx -t
(indien toegankelijk via PATH of via een ServBay-terminal) uitvoeren. - Test uw redirects: Test na het instellen uitvoerig in de browser, inclusief variaties als met/zonder
www
, HTTP/HTTPS en aangepaste paden, om zeker te weten dat alles werkt. - Browsercache: Browsers cachen 301 (permanente) redirects. Wijzigt u de redirect-regel regelmatig, kunt u cacheproblemen ondervinden. Gebruik incognitomodus, leeg de cache of schakel caching uit via devtools bij het testen. Voor tijdelijk testen is een 302 redirect handiger; schakel over naar 301 bij definitieve livegang.
- ServBay herladen: Controleer of ServBay het serverbestand correct heeft herladen na aanpassen. Dit gebeurt meestal automatisch of via een melding of knop in de UI.
Veelgestelde Vragen (FAQ)
Vraag: Ik heb een redirect ingesteld, maar de browser redirect niet. Hoe kan dit?
Antwoord: Mogelijke oorzaken zijn:
- Fout in configuratiebestand: Controleer de syntax en of de wijzigingen zijn opgeslagen.
- ServBay heeft de configuratie nog niet herladen: Controleer of de wijzigingen actief zijn gemaakt.
- Browsercache: Wis uw cache of gebruik incognitomodus voor testen.
- URL-matchprobleem: Controleer of de source-URL/route in uw redirect-regel daadwerkelijk overeenkomt met de URL die u bezoekt.
Vraag: Wat is het verschil tussen 301 en 302 redirects, en welke gebruik ik voor lokale ontwikkeling?
Antwoord: 301 is een permanente redirect (geschikt voor zoekmachines en SEO), 302 is tijdelijk (het origineel blijft bestaan). Bij lokaal testen of debuggen gebruikt u het best 302 (deze wordt niet gecachet). Voor het simuleren van blijvende redirects, bijvoorbeeld domeinmigratie, kiest u 301.
Vraag: Ik heb het configuratiebestand aangepast, maar ServBay meldt een fout of de webserver start niet. Wat nu?
Antwoord: Dit duidt vaak op een syntaxfout in de configuratie. Controleer de zojuist aangepaste regels ook volgens de Caddyfile- of Nginx-syntaxis. Raadpleeg eventueel de ServBay-logbestanden voor meer details over de fout.
Samenvatting
Website redirects instellen in ServBay is een standaard taak voor lokale ontwikkeling. Door het rechtstreeks aanpassen van uw Caddy- of Nginx-configuratie regelt u eenvoudig alles van productie-simulatie tot tests met HTTPS en het doorsturen bij gewijzigde URL-structuur. Kennis van de basale redirect-syntaxis (redir
voor Caddy, return
/rewrite
voor Nginx) maakt u productiever in ServBay. Test altijd grondig en let op het effect van browsercache bij het doorvoeren van deze instellingen.