Naar de hoofdinhoud
Installatiehandleiding

Captive portal voor Ubiquiti UniFi
Installatiehandleiding

Voeg met CaptiFi een captive portal in je eigen huisstijl toe aan je UniFi-gastenwifi: leg bij het inloggen e-mailadressen van gasten vast, automatiseer Google-reviews en laat je marketing automatisch lopen. Werkt met elk UniFi-access point.

📋 Zorg voordat je begint dat je het volgende hebt:
• Een werkende UniFi Network Application (UDM, UDM Pro, Cloud Key of zelf gehost)
• Een CaptiFi-account, maak er hier een aan
• Beheerderstoegang tot die controller, met UniFi Network 6 of nieuwer
🔍 Weet je niet welke UniFi-apparatuur er al op locatie is? Onze gratis UniFi-apparaatscanner vindt elk Ubiquiti-apparaat in het netwerk en adopteert het met een paar klikken in je controller (Mac en Windows).

Instellen in de wizard

Kies UniFi in de installatiewizard op je CaptiFi-dashboard op my.captifi.io. De wizard biedt drie manieren om een UniFi-console te koppelen: inloggen op de controller, een API-sleutel, of de Remote Tunnel voor consoles achter een andere router. Als CaptiFi geen verbinding krijgt, noemt de wizard de oorzaak en biedt direct onder de melding de Remote Tunnel of een CaptiFi-apparaat aan. Er zijn drie mogelijke oorzaken: de console was niet bereikbaar vanaf internet, hij antwoordde wel maar niet als een UniFi-console met de Integration API, of hij weigerde de API-sleutel. Voor de Remote Tunnel toont de wizard het installatiecommando van één regel voor je console, meldt hij wanneer de tunnel werkt, neemt hij je lokale API-sleutel aan en laat hij je het wifinetwerk kiezen waarop de inlogpagina komt.

1 Overzicht van de installatie in 3 stappen

Als CaptiFi verbinding maakt via een API-sleutel of de Remote Tunnel, schrijft het de captive-portalinstellingen hieronder voor je naar je controller, en opnieuw wanneer je Instellingen opnieuw toepassen gebruikt. Je hoeft ze alleen met de hand in te stellen als CaptiFi niet naar je controller kan schrijven, wat voorkomt bij sommige oudere firmware en sommige afgeschermde zelf gehoste installaties. Met de hand zijn er drie taken:

Stap 1 Maak een open gastenwifinetwerk aan in de UniFi Network Application.
Stap 2 Schakel het hotspotportal in, zet het op External Portal Server en vul het portaladres 46.62.168.7 en het domein site.app.captifi.io van CaptiFi in.
Stap 3 Voeg de CaptiFi-domeinen toe aan de pre-autorisatietoegang, zodat de inlogpagina laadt voordat de gast inlogt.
💡 UniFi blijft je wifi verzorgen. CaptiFi voegt alleen het volgende toe: de inlogpagina in je eigen huisstijl, het vastleggen van e-mailadressen, de AVG-toestemming en de marketingautomatisering die daarop volgt.

Drie manieren om een UniFi-console te koppelen

CaptiFi moet met je UniFi-controller kunnen communiceren om je sites uit te lezen en gasten online te laten. Kies de route die past bij waar je console staat; de UniFi-installatiehandleiding op docs.captifi.io loopt elke route klik voor klik door.

API-sleutel Voor een console die CaptiFi kan bereiken: hij heeft een openbaar IP-adres, of je kunt een firewallregel of port forward toevoegen. CaptiFi authenticeert met een sleutel die je op elk moment in UniFi kunt intrekken, en multifactorauthenticatie op je Ubiquiti-account zit niet in de weg.
Remote Tunnel Voor een console achter een andere router, een internetprovider die CGNAT gebruikt of een router van je provider die je niet zelf beheert. De console legt zelf een uitgaande verbinding met CaptiFi via een beveiligde tunnel, dus er zijn geen inkomende poorten en geen wijzigingen aan je router nodig. Cloud Key Gen2 en Gen2 Plus worden ondersteund. Je plakt via SSH een installatiecommando van één regel, wacht ongeveer 30 seconden, en na een herstart of stroomstoring maakt de tunnel vanzelf weer verbinding.
Inloggen op de controller Een lokale gebruikersnaam en een lokaal wachtwoord, voor een UniFi Network-versie die te oud is voor API-sleutels terwijl de console nog wel vanaf internet bereikbaar is.
💡 De banner "Upstream NAT detected" in de UniFi-app kan geen kwaad zodra de tunnel werkt. Laat de router van je provider zoals hij is.

2 Een gastenwifinetwerk aanmaken

Ga in de UniFi Network Application naar Settings → WiFi en klik op Create New:

Naam Iets wat gasten herkennen, bijvoorbeeld Free WiFi
Beveiliging Open (het captive portal regelt het inloggen)
Netwerk / VLAN Wijs toe aan een gasten-VLAN om het verkeer te isoleren (aanbevolen)

3 Het externe hotspotportal inschakelen

Scrol, nog steeds in de instellingen van je wifinetwerk, naar Hotspot Portal (in oudere versies heet dit Settings → Guest Hotspot):

Hotspot Portal Ingeschakeld
Portaltype External Portal Server
IPv4-adres 46.62.168.7
Domein site.app.captifi.io
⚠️ Kopieer en plak beide waarden. Eén verkeerd teken zorgt ervoor dat de inlogpagina nooit verschijnt, en dat gaat mis zonder foutmelding.

Vink in de instellingen van de landingspagina Show Landing Page, HTTPS Redirection Support, Encrypted URL en Secure Portal aan en zet het domein op site.app.captifi.io. Alleen CaptiFi hoort gasten te autoriseren, dus schakel op het hotspotportal de eigen methoden van UniFi uit: Password, Voucher, Facebook, Payment en RADIUS.

💡 CaptiFi autoriseert gasten via de UniFi Controller API nadat ze de inlogpagina hebben afgerond, dus er is geen RADIUS-configuratie nodig.
Klik op Apply Changes om op te slaan.

4 De pre-autorisatiedomeinen toevoegen

Voeg CaptiFi toe aan Pre-Authorization Access (de walled garden van UniFi), zodat de inlogpagina kan laden voordat een gast inlogt:

  • site.app.captifi.io
  • app.captifi.io
  • fonts.googleapis.com
  • fonts.gstatic.com
💡 Voeg elk domein toe aan de pre-autorisatie en pas daarna de wijzigingen toe.

5 De oplossing testen

Verbind een telefoon met je nieuwe gastenwifi. Als het goed is, word je doorgestuurd naar je CaptiFi-inlogpagina in je eigen huisstijl. Vul een test-e-mailadres in, rond het inloggen af en controleer of je internet hebt.

Controleer de registratie in je CaptiFi-dashboard onder Gastbezoeken.

✅ Je captive portal van CaptiFi is nu live op je UniFi-netwerk. Elke gast die verbinding maakt, ziet je inlogpagina in je eigen huisstijl en het e-mailadres wordt automatisch vastgelegd.
🧭 Wil je de volledige uitleg? De twee gidsen hieronder bevatten schermafbeeldingen en behandelen in detail de koppeling met de UniFi Controller API en de verschillen tussen UDM, Cloud Key en zelf gehoste controllers.

Werkt met je bestaande UniFi-apparatuur, of gebruik ons inbegrepen apparaat

Je hoeft niets nieuws te kopen. Er zijn twee routes: je bestaande apparatuur werkt met elk abonnement, en het plug-and-play-apparaat is bij elk abonnement inbegrepen.

Gebruik je bestaande UniFi-apparatuur Gebruik je al UniFi-access points en een UniFi Network Application, volg dan de stappen hierboven. CaptiFi zit ervoor als extern portal. Geen extra hardware.
Gebruik ons inbegrepen plug-and-play-apparaat Geen UniFi-controller, of kom je er liever niet aan? We sturen je een vooraf geconfigureerd CaptiFi-apparaat. Sluit het met een ethernetkabel aan op je bestaande netwerk, vul op je telefoon de activatiepincode van 8 cijfers in, en het haalt zijn configuratie uit de cloud. De gastenwifi is van begin tot eind in ongeveer vijf minuten live, zonder controller, vast IP-adres of aanpassing aan de firewall.
💡 Het plug-and-play-apparaat is het alternatief zonder configuratie. In beide gevallen hetzelfde marketingplatform.

Lite: £19.99 per maand op je eigen netwerk

Heb je al UniFi? Met Lite leg je gasten vast en exporteer je naar CSV op de access points die je al hebt, 500 nieuwe gasten per maand, voor één locatie. Op de inlogpagina blijft de CaptiFi-branding staan.

Verwante handleidingen en pagina's

FAQ over het captive portal op UniFi

Werkt CaptiFi met de UniFi Dream Machine?

Ja. CaptiFi werkt met UDM, UDM Pro, UDM SE, Cloud Key Gen2 en een zelf gehoste UniFi Network Server, en met elk UniFi-access point, ook de U6- en U7-series.

Werkt CaptiFi met UniFi achter CGNAT of dubbele NAT?

Ja. Staat je console achter een andere router, gebruikt je internetprovider CGNAT of krijg je van je provider een router die je niet zelf beheert, gebruik dan de Remote Tunnel. De console legt zelf een uitgaande verbinding met CaptiFi via een beveiligde tunnel, dus inkomende poorten of port forwards zijn niet nodig, en Cloud Key Gen2 en Gen2 Plus kunnen hem draaien. De installatiewizard biedt hem aan zodra CaptiFi je console niet kan bereiken.

Heb ik RADIUS nodig om CaptiFi met UniFi te gebruiken?

Nee. CaptiFi autoriseert gasten via de UniFi Controller API nadat ze de inlogpagina hebben afgerond, dus je hoeft geen RADIUS-server in te stellen.

Waarom laadt mijn UniFi-inlogpagina niet?

Bijna altijd ontbreekt er een CaptiFi-domein in de pre-autorisatielijst, of is het ingebouwde UniFi-portal nog actief en veroorzaakt dat een redirectlus. Controleer of alle vier de domeinen zijn toegevoegd en of alleen het externe portal van CaptiFi is ingeschakeld.

Maakt CaptiFi mijn UniFi-wifi trager?

Nee. CaptiFi is een externe dienst die de inlogpagina verzorgt. Zodra een gast is ingelogd, loopt het verkeer rechtstreeks over je UniFi-netwerk en niet via CaptiFi.

Moet ik mijn bestaande UniFi-netwerk opnieuw opbouwen?

Nee. Je voegt één open gastennetwerk toe en schakelt daarop het externe portal in. Je bestaande bedrijfs- en personeelsnetwerken blijven ongemoeid.

Voldoet het vastleggen van e-mailadressen via UniFi-gastenwifi met CaptiFi aan de AVG?

CaptiFi vraagt marketingtoestemming los van het online gaan en legt het antwoord van elke gast vast, en gasten die weigeren, komen toch op je UniFi-wifi. Elke marketingmail bevat een afmeldlink, Verwijderen (AVG) en Anonimiseren (AVG) op de pagina Gastbezoeken handelen verzoeken om gegevens te wissen af, en de verwerkersovereenkomst van CaptiFi is gepubliceerd. Je zaak is de verwerkingsverantwoordelijke, dus de naleving zelf blijft bij jou liggen.

Maak van je UniFi-gastenwifi een marketingmachine

Start een gratis proefperiode van 30 dagen, of bekijk eerst een live demo.

Voor MSP's en installateurs

Stel je dit in voor een klant?

Partners van CaptiFi kopen bij elk abonnement in tegen een groothandelstarief onder de verkoopprijs, en white label is er tegen dezelfde tarieven. Je bepaalt je eigen prijs en factureert je klanten rechtstreeks. De volledige tarievenlijst in je eigen valuta staat in het partnerdashboard zodra je account is goedgekeurd, en je kunt ernaar vragen bij je aanmelding.

  • ✓ Tarievenlijsten in GBP, USD, EUR, CAD, AUD en NZD
  • ✓ Gratis interne demolicentie van 6 maanden voor één interne testlocatie (alleen voor tests en demo's)
  • ✓ Partnerdashboard vanaf je eerste login na goedkeuring, plus stapsgewijze checklists voor de installatie