Een domeinnaam koppelen en configureren op een ISPConfig VPS

Procédure

Deze handleiding legt uit hoe u een domeinnaam aan uw ISPConfig VPS-server koppelt. Het domein kan geregistreerd zijn bij LWS of bij een andere provider.

U kunt de automatische tool van LWS gebruiken, alleen de website laten verwijzen naar het IP-adres van de VPS, of het volledige beheer van de DNS-zone aan ISPConfig toevertrouwen.

Welke methode kiezen?

De keuze hangt vooral af van waar u de DNS-zone en de e-mails van het domein wilt beheren.

De automatische configuratie gebruiken

Deze methode wordt aanbevolen als u op zoek bent naar de eenvoudigste oplossing.

De tool in het LWS Panel voegt het domein automatisch toe in ISPConfig en maakt de belangrijkste bijbehorende diensten aan, waaronder een e-mailbox, een FTP-account en een database.

Wanneer het domein bij LWS wordt beheerd, worden de DNS-servers ook automatisch aangepast zodat het naar de VPS verwijst.

Alleen de website naar de VPS laten verwijzen

Kies deze methode als u het volgende wilt:

• de website op de VPS hosten;
• de DNS-zone bij LWS of bij uw huidige provider behouden;
• eventueel de e-mails bij een andere provider behouden.

U wijzigt alleen de DNS-records die door de website worden gebruikt, meestal de records voor het hoofddomein en www.

De volledige DNS-zone beheren in ISPConfig

Met deze methode kunt u vanuit ISPConfig beheren:

• de website;
• de e-mails;
• de subdomeinen;
• de DNS-records;
• de benodigde validaties voor externe diensten.

Deze methode vereist meer controles, omdat het wijzigen van de DNS-servers alle diensten van het domein verplaatst naar de zone die op de VPS is aangemaakt.

Voor u begint

Controleer of u beschikt over:

• een actieve VPS met ISPConfig;
• de inloggegevens voor ISPConfig;
• het IPv4-adres en de hostnaam van uw VPS;
• toegang tot de DNS-zone of de DNS-servers van het domein.

Het IPv4-adres en de hostnaam van de VPS zijn beschikbaar in uw LWS-klantenruimte, in de rubriek Servers, nadat u op Beheren voor de betreffende server hebt geklikt.

Als het domein al in gebruik is, bewaar dan een kopie van de huidige DNS-zone voordat u deze wijzigt. Noteer vooral de records voor e-mails, subdomeinen en externe diensten.

Het domein automatisch configureren vanuit het LWS Panel

Deze methode wordt aanbevolen als u snel de belangrijkste diensten van het domein in ISPConfig wilt aanmaken. U kunt hiermee onder andere de website toevoegen en automatisch de bijbehorende middelen voorbereiden, zoals een e-mailadres, een FTP-account en een database.

Noodzakelijke voorwaarden voor de automatische configuratie

Het domein mag op de VPS nog niet geconfigureerd zijn, zelfs niet gedeeltelijk.

Controleer voordat u de tool start of er in ISPConfig nog geen website, maildomein, DNS-zone of andere configuratie voor dit domein aanwezig is. Een bestaande of onvolledige configuratie kan verhinderen dat de tool de bewerking correct afrondt.

Het LWS Panel moet ook automatisch verbinding kunnen maken met de VPS om de verschillende handelingen uit te voeren.

Deze verbinding werkt wanneer:

• het beheerderswachtwoord sinds de levering van de VPS nooit is gewijzigd;
• het wachtwoord is gewijzigd of opnieuw toegewezen via het LWS Panel.

Als het wachtwoord rechtstreeks vanuit ISPConfig is gewijzigd, kent het LWS Panel de gegevens die nodig zijn om automatisch met de server te verbinden niet meer. De domeinconfiguratie mislukt dan.

Stel in dat geval het wachtwoord opnieuw in via het VPS-beheer in het LWS Panel. U kunt een nieuw wachtwoord kiezen of hetzelfde opnieuw toewijzen. Het belangrijkste is dat u de handeling via het LWS Panel uitvoert, zodat het opnieuw de automatische verbinding kan gebruiken.

Opdat de tool ook automatisch de domeinnaamconfiguratie kan wijzigen, moet deze aan beide voorwaarden voldoen:

• beheerd worden door LWS;
• gekoppeld zijn aan dezelfde klantenruimte als de VPS van waaruit de configuratie wordt gestart.

De automatische configuratie starten

1. Log in op uw LWS-klantenruimte.
2. Ga naar het beheer van uw VPS
3. Klik op "Een domein configureren" in de rubriek "Beheer van uw server".
   
4. Geef aan waar het domein is geregistreerd:
   • als het domein bij LWS wordt beheerd, selecteert u het in de aangeboden lijst;
     
   • als het domein bij een andere provider wordt beheerd, voert u de naam in zonder www, http:// of https://.
     
5. Controleer het opgegeven domein en bevestig vervolgens de configuratie.

De tool voegt het domein toe in ISPConfig en maakt automatisch een e-mailbox, een FTP-account en een database aan.

Als het domein bij LWS in dezelfde klantenruimte wordt beheerd

Het LWS Panel treedt dan op zowel op de VPS als op het domein. De DNS-servers worden automatisch aangepast om het domein naar de server te laten verwijzen.

Nadat de DNS-propagatie is voltooid, kunt u doorgaan naar de sectie Controleren of het domein werkt.

Als het domein extern is of in een andere LWS-klantenruimte wordt beheerd

De tool kan de benodigde diensten op de VPS configureren, maar kan het domein niet automatisch wijzigen.

U moet de koppeling afronden vanuit de klantenruimte of het paneel dat het domein beheert, door een van de volgende methoden te kiezen:

• de DNS-records van de website wijzigen zodat ze naar het IP-adres van de VPS verwijzen;
• de huidige DNS-servers vervangen door die welke met ISPConfig zijn geconfigureerd.

Het domein zit bij LWS, maar de DNS-servers zijn niet gewijzigd

Controleer of het domein en de VPS aan dezelfde LWS-klantenruimte zijn gekoppeld.

Een domein dat bij LWS in een andere klantenruimte wordt beheerd, wordt voor het LWS Panel van waaruit de VPS-configuratie wordt gestart als extern beschouwd. Het paneel kan daarom de DNS-servers niet automatisch wijzigen.

Log in op de klantenruimte waarin het domein staat en laat de verwijzing dan handmatig naar de VPS uitvoeren. U kunt het domein ook overzetten naar dezelfde klantenruimte als de server als die indeling beter bij uw behoefte past.

Het domein handmatig configureren op de VPS

De website toevoegen in ISPConfig

Het domein moet in ISPConfig worden aangemaakt zodat de server weet welke website moet worden weergegeven wanneer er een bezoek binnenkomt.

1. Via het LWS Panel, opent u de rubriek Servers en klikt u vervolgens op Beheren voor uw VPS.
2. Klik op Beheerpaneel om toegang te krijgen tot ISPConfig.
   
3. Log in met uw ISPConfig-inloggegevens als de autologin niet werkt
4. Open het tabblad Sites (1).
5. Klik in het gedeelte Websites (2) op Een nieuwe website toevoegen.
   

6. Voer in het veld Domein (1) alleen de domeinnaam in, bijvoorbeeld:

   mijnsite.com

   Voeg geen www, http:// of https:// toe.
   
   

7. Selecteer in het veld Auto-Subdomain (2) www. als u wilt dat de website ook bereikbaar is via het adres www.mijndomein.nl.
8. Als uw site PHP gebruikt, wat het geval is voor de meeste CMS'en zoals WordPress of PrestaShop, selecteer dan PHP-FPM (3) in het veld PHP.
9. Kies in het veld PHP-versie (4) een versie die compatibel is met de site of toepassing die u wilt installeren.

10. Activeer Let’s Encrypt SSL (5) alleen als het domein al naar het IP-adres van de VPS verwijst en de DNS-propagatie voltooid is.

Wanneer u Let’s Encrypt SSL aanvinkt, vinkt ISPConfig automatisch de optie SSL aan.

11. Controleer of de optie Actief is aangevinkt en klik vervolgens op Opslaan (6).

Het domein verschijnt nu in de lijst met door ISPConfig beheerde websites. Deze actie wijzigt de DNS-zone niet.

Het domein laten verwijzen naar het IP-adres van de VPS

Deze methode behoudt de DNS-zone bij de huidige beheerder. Hiermee kunt u onder meer de website op de VPS hosten zonder de e-mails of andere diensten van het domein te verplaatsen.

Gebruik deze methode:

• na het handmatig toevoegen van de website in ISPConfig;
• na een automatische configuratie als het domein extern is;
• na een automatische configuratie als het LWS-domein zich in een andere klantenruimte dan de VPS bevindt.

Wanneer het domein en de VPS in dezelfde LWS-klantenruimte worden beheerd, voert de automatische tool deze verwijzing al uit.

Uit te voeren instellingen

De waarden zijn identiek, ongeacht of de DNS-zone bij LWS of bij een andere provider wordt beheerd.

Voor het hoofddomein wijzigt of maakt u een record met de volgende waarden aan:

Voor het adres met www gebruikt u een van de volgende configuraties:

of :

Voorbeeld met het domein mondomein.fr :

• het A-record van @ verwijst naar het IPv4-adres van de VPS (bijv.: 8.8.8.8) ;
• het CNAME-record van www verwijst naar mondomein.fr.

Als de DNS-zone bij LWS wordt beheerd

Log in op de klantenruimte waarin het domein staat en wijzig vervolgens de DNS-zone met de hierboven aangegeven waarden.

Voor de volledige procedure raadpleegt u de handleiding: Hoe laat ik mijn domein naar een extern IP-adres verwijzen?

Als het domein in een andere klantenruimte staat dan de VPS, moet de wijziging worden uitgevoerd vanuit de klantenruimte waarin het domein zich bevindt.

Als de DNS-zone bij een andere provider wordt beheerd

Voer dezelfde instellingen uit via de interface van de provider die de DNS-servers voor het domein levert.

Als u niet weet hoe u de DNS-zone moet wijzigen, neem dan contact op met de ondersteuning en geef de volgende instructies door:

• laat het hoofddomein verwijzen naar het IPv4-adres van de VPS met een A-record;
• laat www verwijzen naar het hoofddomein met een CNAME-record of naar hetzelfde IPv4-adres met een A-record;
• behoud de bestaande mailrecords.

Een eventueel IPv6-record controleren

Als de DNS-zone een AAAA-record bevat, kunnen bezoekers die IPv6 gebruiken daarmee de website bereiken.

Controleer of dit overeenkomt met het IPv6-adres van uw VPS. Een oud IPv6-adres kan een deel van de bezoekers naar de verkeerde server sturen.

Verwijder of wijzig dit record alleen als u de te gebruiken IPv6-configuratie kent.

De DNS-zone van het domein beheren in ISPConfig

Gebruik deze methode als u wilt dat de volledige DNS-zone van het domein vanaf uw VPS wordt beheerd.

ISPConfig fungeert dan als primaire DNS. De dienst dns2.lws-hosting.com wordt gebruikt als secundaire DNS.

De DNS-zone aanmaken in ISPConfig

1. Log in op ISPConfig.
2. Open het tabblad DNS (1).
   
3. Klik in het gedeelte Zones op Add new DNS Zone with Wizard (2).
4. Vul de velden in:
   • Domein : uw domeinnaam zonder www;
   • IP-adres : het IPv4-adres van uw VPS;
   • NS 1 : de hostnaam van uw VPS, in de vorm vpsXXXXX.serveur-vps.net (identiek aan de waarde Server);
   • NS 2 : dns2.lws-hosting.com;
   • E-mail : het e-mailadres van de zonebeheerder (uw e-mailadres).
     
5. Klik op Create new DNS Zone (2).

De nieuwe zone verschijnt in ISPConfig.

De aangemaakte records controleren

Open de DNS-zone door op de recordregel te klikken en controleer of de records overeenkomen met de diensten die u zult gebruiken.

De zone moet in elk geval bevatten:

• een webrecord voor het hoofddomein (Type A);
• een record voor www (Type CNAME);
• de MX-records als de e-mails op de VPS worden gehost;
• het SPF-record dat nodig is voor e-mail (Type TXT);
• de gebruikte subdomeinen;
• eventuele validatievermeldingen die door externe diensten worden gevraagd.

De wizard maakt een basisconfiguratie aan, maar kan niet alle eerder aan uw domein gekoppelde diensten kennen.

De overdracht naar de secundaire DNS toestaan

De secundaire DNS moet een kopie van de zone die op de VPS is aangemaakt, kunnen ophalen.

1. Open in ISPConfig de DNS-zone van het domein.
2. Ga naar het tabblad Zone settings (1).
   

3. Voeg het volgende IP-adres toe in de velden Zone-overdrachten toestaan naar deze IP's en Ook melden aan (2):

   185.98.131.49

4. Sla de wijzigingen op (3).

Deze toestemming laat de secundaire LWS-DNS-server toe de zone op te halen en bij te werken.

Het domein op de secundaire LWS-DNS registreren

1. Ga terug naar uw LWS-klantenruimte en ga naar het beheer van uw VPS.
2. Klik in de rubriek Geavanceerd beheer op Secundaire DNS.
   
3. Voer de domeinnaam in (1).
   
4. Klik op Verzenden (2).

De secundaire DNS kan nu de zone van uw VPS ophalen.

De DNS-servers van een LWS-domein wijzigen

Als uw domein door LWS wordt beheerd, volg dan deze procedure:

1. Ga naar het DNS-beheer van uw domeinnaam.
2. Activeer de aangepaste DNS-configuratie.
3. Geef de volgende servers op:
   • DNS-server 1 : de hostnaam van uw VPS (in de vorm vpsXXXXX.serveur-vps.net );
   • DNS-server 2 : dns2.lws-hosting.com.
4. Controleer de ingevoerde waarden en bevestig vervolgens.

De aanvraag kan worden geweigerd als de zone nog niet bestaat, als de secundaire server niet correct is opgegeven of als de opgegeven servers niet voor het domein antwoorden.

De DNS-servers van een extern domein wijzigen

Als uw domeinnaam niet door LWS wordt beheerd, volg dan deze procedure:

Log in op het paneel van de provider waar het domein is geregistreerd.

Open het onderdeel waarmee u de DNS-servers, nameservers of nameservers kunt wijzigen, en geef vervolgens op:

• de hostnaam van uw VPS: vpsXXXXX.serveur-vps.net;
• de secundaire DNS-server: dns2.lws-hosting.com.

Bevestig daarna de wijziging in het paneel van de provider.

DNS-propagatietijd

Een wijziging van een record of een verandering van DNS-servers kan tot 24 uur nodig hebben om overal zichtbaar te zijn. In sommige gevallen kunnen caches van providers of apparaten de oude configuratie langer bewaren.

Tijdens deze periode:

• kunnen sommige bezoekers nog steeds de oude server bereiken;
• kunnen anderen al de VPS gebruiken;
• kan het gedrag variëren afhankelijk van de gebruikte internetverbinding.

Vermijd meerdere wijzigingen zolang de propagatie nog niet is voltooid.

Controleren of het domein werkt

Na de propagatie en de activering van het Let’s Encrypt-certificaat, voert u de volgende controles uit:

1. Open het hoofddomein in een browser:

   https://mijndomein.ext

2. Test ook het adres met www:

   https://www.mijndomein.ext

3. Controleer of de juiste website wordt weergegeven en niet de oude site of een pagina van een ander domein.
4. Als het domein e-mails gebruikt, stuur dan een bericht naar een extern adres en antwoord vervolgens op dat bericht om verzenden en ontvangen te controleren.
5. Als u de DNS-servers hebt vervangen, controleer dan of het domein werkelijk gebruikt maakt van:
   • de hostnaam van uw VPS als primaire DNS;
   • dns2.lws-hosting.com als secundaire DNS.

Veelvoorkomende problemen

De automatische configuratie van het domein mislukt

Controleer eerst of het domein niet al, zelfs gedeeltelijk, in ISPConfig is geconfigureerd.

Zoek naar een configuratie met dit domein in de volgende rubrieken:

• Sites;
• E-mail;
• DNS;
• FTP-accounts;
• databases.

Als het domein aanwezig is, maak dan een back-up van de bestanden, databases, e-mails en instellingen die u wilt behouden. Verwijder vervolgens de aan het domein gekoppelde onderdelen en start de automatische tool opnieuw vanuit het LWS Panel.

Een eerdere poging kan slechts een deel van de diensten hebben aangemaakt. Controleer daarom alle rubrieken van ISPConfig, zelfs als er geen website geconfigureerd lijkt te zijn.

De configuratie mislukt na het wijzigen van het wachtwoord

Het LWS Panel moet de benodigde gegevens kennen om automatisch met de VPS te verbinden.

Als het beheerderswachtwoord rechtstreeks vanuit ISPConfig is gewijzigd, kan het LWS Panel deze verbinding niet meer maken en mislukt de automatische tool.

Gebruik vanuit het LWS Panel de procedure voor het wijzigen van het VPS-wachtwoord. U kunt een nieuw wachtwoord instellen of het huidige wachtwoord opnieuw toewijzen.

Start na deze handeling vanuit het LWS Panel de automatische domeinconfiguratie opnieuw.

Ik krijg een oude configuratie niet volledig verwijderd

Controleer of alle onderdelen die aan het domein zijn gekoppeld zijn verwijderd in de rubrieken Sites, E-mail en DNS, evenals in de FTP-accounts en databases.

Als de VPS geen andere domeinen, websites, e-mails, bestanden of databases bevat die u wilt behouden, kunt u deze opnieuw installeren met de ISPConfig-template om met een schone configuratie te beginnen.

Nadat de VPS opnieuw is geïnstalleerd, controleert u of u toegang hebt tot ISPConfig en start u vervolgens de automatische configuratie opnieuw vanuit het LWS Panel.

Mijn domein toont nog steeds de oude website

De DNS-propagatie is mogelijk nog niet voltooid.

Controleer of het A-record inderdaad het IPv4-adres van de VPS gebruikt of dat de nieuwe DNS-servers actief zijn. Test het domein ook via een andere verbinding, bijvoorbeeld met het mobiele netwerk van uw telefoon.

Als de wijziging net is doorgevoerd, wacht dan tot 24 uur voordat u deze opnieuw probeert.

Er wordt een standaardpagina weergegeven in plaats van mijn website

Waarschijnlijk bereikt het domein wel de VPS, maar koppelt ISPConfig het nog niet aan de juiste website.

Open in ISPConfig Sites, vervolgens Websites en controleer:

• of de website correct is aangemaakt;
• of het domein is ingevoerd zonder www, http:// of https://;
• of er niet twee websites met hetzelfde domein zijn geconfigureerd;
• of de websitebestanden in de juiste map zijn geplaatst.

De website werkt zonder www, maar niet met www

Het DNS-record voor www ontbreekt waarschijnlijk of is onjuist.

Voeg in de actieve DNS-zone naar keuze toe:

• een CNAME-record voor www dat naar het hoofddomein verwijst;
• een A-record voor www dat het IPv4-adres van de VPS gebruikt.

Controleer ook de waarde van het veld Auto-subdomein in de ISPConfig-siteconfiguratie als die optie aanwezig is.

Het externe domein werkt niet na de automatische configuratie

De LWS-tool kan de diensten in ISPConfig aanmaken, maar kan de DNS-servers die bij een andere provider worden beheerd of wanneer het domein in een andere LWS-klantenruimte dan die van de VPS staat, niet wijzigen.

Log in op het paneel van die provider (of op de LWS-klantenruimte die het domein beheert) en voer vervolgens een van de volgende handelingen uit:

• het domein laten verwijzen naar het IP-adres van de VPS;
• de DNS-servers wijzigen naar die welke met ISPConfig zijn geconfigureerd.

Mijn e-mails werken niet meer na het wijzigen van de DNS-servers

De nieuwe ISPConfig-zone bevat waarschijnlijk niet alle benodigde mailrecords.

Controleer vooral:

• de MX-records;
• de hostnaam van de mailserver;
• de SPF-, DKIM- en DMARC-records;
• de aanmaak van domeinen en e-mailboxen in ISPConfig.

Als de e-mail bij de oude provider moet blijven, kopieer dan de records die die provider levert naar ISPConfig.

De nieuwe DNS-servers worden geweigerd

Controleer de volgende punten:

• de domeinzone is correct aangemaakt in ISPConfig;
• de hostnaam van de VPS is correct ingevoerd;
• dns2.lws-hosting.com is ingevuld als secundaire DNS;
• de zone-overdracht naar 185.98.131.49 is toegestaan;
• het domein is toegevoegd in de rubriek Secundaire DNS van het LWS Panel;
• de zone bevat consistente NS-records met de opgegeven servers.

Sommige registrars passen ook controles toe die specifiek zijn voor de domeinextensie.

Het Let’s Encrypt SSL-certificaat wordt niet geactiveerd

Controleer vóór u het certificaat aanvraagt of:

• het hoofddomein naar de VPS verwijst;
• www ook naar de VPS verwijst als u het in het certificaat wilt opnemen;
• geen oud AAAA-record het domein nog naar een andere server leidt;
• de DNS-propagatie is voltooid.

Zodra deze punten zijn gecorrigeerd, start u de activering van het certificaat in ISPConfig opnieuw.