Naar de hoofdinhoud
Gidsen Laatst bijgewerkt: oktober 2026 11 min leestijd

Een captive portal instellen op UniFi: e-mailadressen vastleggen met CaptiFi

C
Redactie van CaptiFi
CaptiFi · sep. 2024
Een captive portal instellen op UniFi: e-mailadressen vastleggen met CaptiFi
15 min
Insteltijd via de route met de API-sleutel
1 adres
CaptiFi maakt alleen verbinding vanaf 46.62.168.7
3 routes
API-sleutel, Remote Tunnel, of gebruikersnaam en wachtwoord
£49/mnd
Prijzen van CaptiFi, in je eigen valuta

Waarom een captive portal toevoegen aan je UniFi-netwerk

Gasten maken verbinding met je wifi en daar houdt de relatie op. Je weet niet wie ze waren, of ze zijn teruggekomen en hoe je ze kunt bereiken. Een captive portal zet een inlogpagina in je eigen huisstijl voor de verbinding, zodat elke gast die online gaat je een e-mailadres geeft, met een marketing-opt-in die los staat van de wifi zelf. Daarna loopt de opvolging vanzelf via de wifi-marketingsoftware van CaptiFi: een welkomstmail, een Google-reviewverzoek na het bezoek, en een win-backmail als een gast al een tijd niet is geweest.

UniFi heeft zelf een hotspotportal. Het helpcentrum van Ubiquiti noemt een wachtwoord, vouchers, Facebook, RADIUS, betaling via Stripe en een optie External Portal Server voor portals van derden. Een aanmeldformulier met e-mailadres, marketingmails, toestemmingsregistratie of reviewverzoeken staan er niet bij. CaptiFi sluit aan op de optie External Portal Server van de UniFi-installatie die je al hebt en voegt die laag toe. Omdat het portal op de controller wordt ingesteld, verandert er niets aan je access points.

Consoles en access points die werken

CaptiFi maakt verbinding met de UniFi-controller, dus het type access point maakt niet uit. U7, U6 en de oudere UAP-AC-modellen tonen allemaal dezelfde inlogpagina. Wat wel telt is de console waarop de controller draait, en CaptiFi ondersteunt ze allemaal:

  • UniFi Dream Machine: UDM, UDM Pro en UDM SE
  • UniFi Cloud Gateway: UCG Ultra en UCG Max
  • Dream Router en UniFi Express
  • Cloud Key en Cloud Key Gen2 (ook de Gen2 Plus)
  • Een zelf gehoste UniFi Network-applicatie op je eigen computer, VM of server, ook UniFi OS Server op Windows

De controller heeft UniFi Network 6 of hoger nodig. Kom je liever helemaal niet aan de controller, dan is het alternatief het plug-and-play-apparaat dat CaptiFi je toestuurt tegen een borg die je terugkrijgt, en dat naast je UniFi-wifi een eigen gastennetwerk uitzendt. Beide routes komen in hetzelfde dashboard uit.

Voordat je begint

Je hebt vier dingen nodig: beheerderstoegang tot de UniFi-controller, een CaptiFi-account (de proefperiode van 30 dagen is genoeg; je voegt een kaart toe om te starten), een paar minuten in je zaak of toegang op afstand tot de console, en twee waarden die je exact overneemt. Het verbindingsadres van CaptiFi is 46.62.168.7 en het portaldomein is site.app.captifi.io. Eén verkeerd teken en de inlogpagina verschijnt niet, zonder foutmelding, dus kopieer en plak ze.

Heb je je vandaag aangemeld, dan loopt de onboardingwizard op my.captifi.io dezelfde stappen met je door en stopt hij bij elke stap. Deze handleiding is de lange versie, met elke hardwarevariant en alles wat er mis kan gaan. In de klantdocumentatie staat dezelfde handleiding met screenshots van elk scherm.

Stap 1: kies hoe CaptiFi je controller bereikt

CaptiFi moet met je controller kunnen praten om de portalinstellingen weg te schrijven en om elke gast te autoriseren die de inlogpagina invult. Je kunt die toegang op drie manieren geven. Kies de rij die bij jouw situatie past.

Jouw situatieJouw route
Je console heeft een openbaar IP-adres, of je kunt een firewallregel of port forward toevoegenRoute A, API-sleutel. De eenvoudigste en veiligste route, en de route die deze handleiding volgt.
Je console staat achter een andere router, je provider gebruikt CGNAT, of je kunt geen port forward instellenRoute B, Remote Tunnel. Je console maakt zelf een uitgaande verbinding met CaptiFi, dus er zijn helemaal geen inkomende poorten nodig.
Je versie van UniFi Network is te oud voor API-sleutels, en de console is bereikbaar vanaf internetRoute C, gebruikersnaam en wachtwoord. Een lokaal beheerdersaccount op de controller.

Weet je niet of je console API-sleutels kan aanmaken? Open de UniFi Network-applicatie, ga naar Settings, dan Control Plane, en zoek naar Integrations. In nieuwere versies staat Integrations in het linkermenu, dus kijk op beide plekken. Staat het op geen van beide, werk UniFi Network dan eerst bij en val alleen terug op route C als bijwerken niet kan.

Route B herken je aan de banner "Upstream NAT detected on WAN1" in de UniFi-app, een WAN-adres dat begint met 10., 192.168. of 172.16. tot en met 172.31., een modem-routercombinatie van je provider vóór je gateway, of een verbinding via 4G, 5G of glasvezel met CGNAT. Geldt een van die dingen, sla dan stap 3 over en lees de aantekeningen over de Remote Tunnel in stap 4.

Stap 2: maak de UniFi-API-sleutel aan

  1. Ga in de UniFi Network-applicatie naar Settings, dan Control Plane, dan Integrations
  2. Typ een naam die je later herkent, bijvoorbeeld CaptiFi
  3. Zet de rol of het toegangsniveau op Full Control
  4. Zet de vervaldatum op Never expires, tenzij je eigen beleid iets anders voorschrijft
  5. Klik op Create API Key en kopieer de sleutel meteen

UniFi toont de sleutel precies één keer. Sluit je het venster zonder hem te kopiëren, verwijder die sleutel dan en maak een nieuwe aan; een bestaande sleutel kun je niet meer uitlezen. Full Control is nodig omdat CaptiFi apparaten van gasten moet autoriseren en je wifinetwerken moet uitlezen. Een sleutel met alleen leesrechten maakt wel verbinding, maar het gaat mis zodra de eerste gast probeert in te loggen.

Een API-sleutel is op twee punten beter dan een controllerlogin. Je kunt hem op elk moment in UniFi intrekken zonder een wachtwoord te wijzigen, en de multifactorauthenticatie op je Ubiquiti-account zit niet in de weg. Eén sleutel dekt bovendien elke site op de controller.

Stap 3: laat CaptiFi je console bereiken

CaptiFi maakt vanaf maar één adres verbinding met je controller: 46.62.168.7. Hoe je dat toelaat, hangt af van de hardware.

Dream Machine, Cloud Gateway, Dream Router of UniFi Express

Op deze consoles draait de controller op de gateway zelf, dus je hebt een firewallregel nodig en geen port forward (een port forward stuurt verkeer naar een apparaat achter de gateway, en daar staat de controller niet).

  1. Ga naar Settings, dan Policy Engine (Firewall & Security op oudere firmware), open Object Manager en maak een poortgroep met de naam Captifi aan met de poorten 80 en 443
  2. Open, nog steeds in Policy Engine, Firewall Rules, klik op Create Entry en zet het type regel op Advanced
  3. Zet het type op Internet Local, de actie op Accept en het protocol op All, vink Before Predefined aan, zet de bron op Any en kies de Captifi-groep als poortobject voor de bestemming
  4. Sla de regel op

Internet Local is het onderdeel dat vaak wordt gemist. UniFi splitst inkomend verkeer in Internet In (naar apparaten op je LAN) en Internet Local (naar de gateway zelf). Je controller staat op de gateway, dus het verkeer van CaptiFi is Internet Local. Door de regel te beperken tot de poortgroep gaan alleen de poorten 80 en 443 open, en alleen naar de gateway. Op oudere firmware met zones is dezelfde regel: bronzone External, bestemmingszone Gateway, bestemmingspoort de Captifi-groep, actie Allow. De regel geldt voor IPv4; draait je site ook op IPv6, voeg dan een overeenkomende IPv6-regel toe of zorg dat de controller via IPv4 wordt bereikt.

Cloud Key of Cloud Key Gen2

Een Cloud Key is een apart apparaat op je LAN, dus dit is een gewone port forward op de router die ervoor staat: externe poort 8443 naar het IP-adres van de Cloud Key op interne poort 8443, protocol TCP. Staat er een router van je provider voor waar je geen controle over hebt, gebruik dan de Remote Tunnel; de meeste Cloud Keys kunnen die nu draaien, en het installatieprogramma meldt het als die van jou dat niet kan.

Zelf gehoste controller

Zorg dat poort 8443 (of de poort waarop je controller luistert) bereikbaar is vanaf internet, en beperk de inkomende toegang op die poort daarna tot alleen 46.62.168.7. Je hoeft de controller niet voor het hele internet open te zetten, en dat moet je ook niet doen. Vul de controller in als IPv4-adres of als hostnaam met alleen een A-record. Je kunt ook een willekeurige vrije externe poort doorsturen, bijvoorbeeld 7443, en CaptiFi het adres met die poort geven, zoals unifi.example.com:7443. De Remote Tunnel is niet beschikbaar voor zelf gehoste controllers, dus deze beperking tot één adres is de manier om zo'n controller privé te houden.

Controleer of het werkt

Doe dit van buiten je netwerk, bijvoorbeeld op je telefoon met de wifi uit. Zoek het openbare IP-adres van je zaak op en ga dan naar https://YOUR_PUBLIC_IP voor een Dream Machine of UCG, of naar https://YOUR_PUBLIC_IP:8443 voor een Cloud Key of een zelf gehoste controller. Je hoort de inlogpagina van UniFi te zien; een certificaatwaarschuwing van de browser is hier normaal, omdat de controller een zelfondertekend certificaat gebruikt. Laadt er niets en is het WAN-adres van de gateway een privé-IP-adres, dan zit je achter dubbele NAT: gebruik de Remote Tunnel.

Stap 4: verbind de controller in CaptiFi

Zit je nog in de onboarding, dan vraagt de wizard om drie dingen: een naam voor de controller voor je eigen overzicht, de controller-URL (het openbare adres of de hostnaam die je in stap 3 hebt getest; CaptiFi zet er https:// voor en zoekt de poort, dus je typt alleen een poort als je een eigen poort hebt doorgestuurd) en de API-sleutel uit stap 2. Klik op Connect controller. CaptiFi controleert het adres, logt in met de sleutel en vindt je UniFi-sites.

Is je account al ingesteld, log dan in op my.captifi.io, ga naar My Venues en klik op Add venue. Kies Ubiquiti UniFi, geef de locatie een naam, stel het type en de tijdzone in, kies daarna Direct connection voor route A of Remote Tunnel voor route B en klik op Add venue. De wizard verbindt vervolgens de controller: Remote Tunnel vraagt om je API-sleutel, en Direct connection vraagt om het controlleradres en de gebruikersnaam en het wachtwoord van een lokale beheerder. Wil je een locatie met Direct connection overzetten op de sleutel die je in stap 2 hebt aangemaakt, open dan Connection status op de locatiekaart, kies Update connection en daarna Use an API key instead.

In elk abonnement zit één locatie, en vanaf Essentials betaal je voor elke extra locatie het tarief voor een extra locatie, £25 per maand in GBP, vanaf de dag dat je hem toevoegt en naar rato tot je factuurdatum. Host de controller meerdere UniFi-sites, kies dan de juiste in de keuzelijst Controller site voordat je verdergaat: het is één CaptiFi-locatie per UniFi-site, en CaptiFi kan niet voor je kiezen. Eén API-sleutel dekt elke site op de controller, dus die locaties delen één verbinding, en als je de sleutel vervangt, verandert de verbinding voor allemaal.

Als je voor de Remote Tunnel hebt gekozen

Het installatiecommando is uniek voor je locatie en staat in de wizard bij de stap Install the Tunnel; staat de locatie al in CaptiFi, mail dan naar hello@captifi.io en we sturen je het commando voor je locatie. Zet SSH aan in UniFi OS onder Settings, Control Plane, Console, stel een SSH-wachtwoord in, maak verbinding met ssh root@YOUR-CONSOLE-IP, plak het commando en wacht ongeveer 30 seconden. De verbinding is alleen uitgaand, dus die werkt achter elk aantal routers en maakt na een herstart of een stroomstoring vanzelf opnieuw verbinding. Consoles die via de tunnel zijn verbonden, authenticeren alleen met de API-sleutel. De banner "Upstream NAT detected" blijft in de UniFi-app staan, en dat is prima; zet de router van je provider niet in bridgemodus om hem weg te krijgen. Behandel het commando als een wachtwoord: er zit een token in dat aan die ene locatie is gekoppeld.

Als je de route met gebruikersnaam en wachtwoord volgt

Maak een apart lokaal account aan op de controller (Local Access Only op UniFi OS; Local admin only op een Cloud Key of een zelf gehoste controller) met de rol Administrator, die CaptiFi nodig heeft om gasten te autoriseren. Je cloudlogin van Ubiquiti werkt niet, omdat multifactorauthenticatie op een ui.com-account altijd verplicht is en CaptiFi die controle niet kan afronden. Een lokaal account met tweefactorauthenticatie werkt wel: vink het 2FA-vakje aan als je inlogt en CaptiFi vraagt om de zescijferige code.

Stap 5: kies het gastenwifinetwerk

CaptiFi toont nu elk wifinetwerk op je controller, met het aantal apparaten op elk netwerk, zodat je kunt aangeven bij welk netwerk de inlogpagina hoort. Het scherm heet Go live in de wizard en WiFi network als je er later via de locatiekaart naar teruggaat.

  1. Kies je gastennetwerk, niet een privénetwerk of een netwerk voor personeel. Elk apparaat op het gekozen netwerk moet de inlogpagina invullen, en aan de apparaataantallen zie je op welk netwerk je eigen apparatuur zit
  2. Of kies Create a new guest network, typ een naam, en CaptiFi voegt een open gastennetwerk toe op al je access points
  3. Klik op Go live (of Apply)

CaptiFi zet de inlogpagina voor het netwerk dat je kiest en haalt die weg van elk ander netwerk waar die op stond, zodat een privénetwerk nooit per ongeluk afgeschermd blijft. Heb je een bestaand netwerk gekozen, dan schermt CaptiFi dat netwerk af zoals het is, en blijven je sessieduur en eventuele snelheidslimieten zoals je ze had ingesteld. Je kunt het afgeschermde netwerk later op elk moment wisselen.

Op gateways met een zonegebaseerde firewall (nieuwere Dream Machines, UCG en EFG) volgt de inlogpagina de Hotspot-zone. Ga naar Settings, dan Policy Engine, dan Zones, en zorg dat het netwerk dat je gastenwifi gebruikt in de Hotspot-zone zit en dat er verder niets in die zone zit. Na het toepassen meldt CaptiFi het als de zone aandacht nodig heeft, en noemt het de instelling die je moet wijzigen.

Stap 6: stel het hotspotportal handmatig in (alleen als het nodig is)

Sla deze stap over als CaptiFi via een API-sleutel of de Remote Tunnel is verbonden. Het schrijft deze instellingen dan voor je weg, en doet dat opnieuw telkens als je Re-apply settings gebruikt. Je hebt dit alleen nodig als CaptiFi niet naar je controller kan schrijven, wat voorkomt bij sommige oudere firmware en sommige streng beveiligde zelf gehoste installaties.

  1. Ga in UniFi naar Settings, dan WiFi, en maak je gastennetwerk aan of open het. Zet de beveiliging op Open zonder wachtwoord en wijs het toe aan je gastennetwerk
  2. Zet op hetzelfde wifinetwerk Hotspot Portal aan en zet Authentication op External Portal Server
  3. Vul het portal van CaptiFi in: IPv4-adres 46.62.168.7, domein site.app.captifi.io
  4. Voeg onder Pre-Authorization Access (de walled garden) site.app.captifi.io, app.captifi.io, fonts.googleapis.com en fonts.gstatic.com toe, plus *.captifi.io als je firmware wildcards accepteert. Vergeet je er een, dan laadt de pagina half kapot, of op iPhones helemaal niet
  5. Voeg onder Post-Authorization Restrictions 192.168.0.0/16, 172.16.0.0/12 en 10.0.0.0/8 toe, zodat gasten niet bij je eigen netwerk kunnen als ze online zijn
  6. 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
  7. Zet Password, Voucher, Facebook, Payment en RADIUS uit op het hotspotportal, zodat alleen CaptiFi gasten autoriseert, en laat de eigen portalaanpassing van UniFi met rust
  8. Klik op Apply Changes

Verkoop je wifitoegang via CaptiFi, dan moeten je betaaldomeinen voor Stripe en wallets ook in de pre-autorisatielijst staan. Neem contact op met support om de actuele lijst te laten bevestigen.

Stap 7: test het met een telefoon

Regel eerst de apparaten die niet kunnen inloggen. Bonprinters, pinapparaten, iPads in de backoffice, muziekspelers en digitale schermen kunnen geen inlogpagina tonen, dus zodra het portal live is, verliezen ze hun internetverbinding bij de eerstvolgende keer dat ze opnieuw verbinden. Verplaats ze naar een privénetwerk voor personeel met een wachtwoord, dat is de netste oplossing, of voeg hun MAC-adressen toe onder Pre-authorized devices op de locatiekaart.

  1. Zet op een telefoon de wifi uit en weer aan, en maak verbinding met het gastennetwerk
  2. Je CaptiFi-pagina hoort binnen een paar seconden vanzelf te verschijnen. Gebeurt dat niet, open dan een browser en ga naar een willekeurige http://-site, bijvoorbeeld http://neverssl.com
  3. Vul het formulier in en controleer of de telefoon normaal kan internetten
  4. Open Guest Visits in je CaptiFi-dashboard: het bezoek hoort binnen een minuut in de lijst te staan

Het portal wordt geleidelijk actief. Apparaten die al verbonden zijn, blijven werken tot ze opnieuw verbinden, en de inlogpagina verschijnt voor elk apparaat zodra het opnieuw verbinding maakt, dus een volledige overgang kan een dag duren.

Na het instellen: de verbinding gezond houden

Alles staat op de locatiekaart onder My Venues op my.captifi.io. Connection status toont drie dingen en ververst zolang het open staat: Online betekent dat CaptiFi een geverifieerde route naar de controller heeft; Controller sending RADIUS traffic wordt oranje en toont STALE als er 15 minuten niets is binnengekomen, wat normaal is bij een zaak die dicht is of waar geen gasten verbonden zijn; en Guests connecting through the splash page telt de logins. Een locatie met gasten en een rij op STALE is een supportticket waard, en als je de exacte melding erbij zet (daar staat het eigen antwoord van de controller in, bijvoorbeeld een api.err-code), is het meestal in één stap opgelost.

Controller verplaatst, de poort gewijzigd of de API-sleutel vervangen? Klik op Update connection. Je huidige verbinding blijft werken tot de nieuwe is geverifieerd, dus de gastenwifi wordt nooit onderbroken. Is de controller teruggezet naar de fabrieksinstellingen of zien gasten ineens de eigen pagina van UniFi in plaats van die van jou, klik dan op Re-apply settings: dat zet het captive portal van CaptiFi, de pre-autorisatielijst en eventuele snelheidslimieten opnieuw op de controller, maakt het gastennetwerk alleen opnieuw aan als het ontbreekt, en verbreekt de verbinding van gasten die al online zijn niet. Het vervangt de hele portalconfiguratie, dus elke walled-gardenvermelding die je rechtstreeks in UniFi hebt toegevoegd, wordt teruggezet. Wil je de inlogpagina naar een ander netwerk verplaatsen, klik dan op WiFi network en kies opnieuw. Pre-authorized devices neemt een MAC-adres en een optioneel label aan, autoriseert het apparaat meteen op de controller, ververst de autorisatie elke nacht zodat die een herstart van de controller overleeft, en trekt die in als je het apparaat verwijdert.

Wat CaptiFi aan UniFi toevoegt

MogelijkheidAlleen het hotspotportal van UniFiUniFi met CaptiFi
Hoe gasten inloggenWachtwoord, vouchers, Facebook, RADIUS, betaling via Stripe of een extern portalInlogformulier met e-mailadres op de pagina van CaptiFi, via de optie External Portal Server van UniFi
E-mailadressen van gasten vastleggenGeen aanmeldformulier met e-mailadres vermeld in de hotspothulp van UbiquitiElke login vastgelegd met toestemming, te exporteren als CSV
Inlogpagina in je eigen huisstijlDe eigen portalaanpassing van UniFiEditor voor inlogpagina's met slepen en neerzetten, één ontwerp per locatie
WelkomstmailKomt niet aan bod in de hotspothulp van UbiquitiVanaf Essentials, verstuurd bij het verbinden, vanuit een voorinstelling of je eigen automatisering
Google-reviewverzoekenKomt niet aan bod in de hotspothulp van UbiquitiGetimed na het bezoek, vanaf Essentials
Win-backcampagnesKomt niet aan bod in de hotspothulp van UbiquitiAutomatiseringen voor gasten die niet zijn teruggekomen
Bezoeken bijhoudenKomt niet aan bod in de hotspothulp van UbiquitiBezoekgeschiedenis en terugkeerpercentage per gast
Meerdere locatiesPer site in de controllerEén dashboard, één API-sleutel per controller, een inlogpagina-ontwerp per locatie
Toestemming en audittrailKomt niet aan bod in de hotspothulp van UbiquitiAparte marketing-opt-in, link naar de privacyverklaring en een registratie van de toestemming

In de gegevens die CaptiFi over zijn locaties heeft, logde 55% van de nieuwe apparaten die in september 2026 verbinding maakten met gastenwifi van CaptiFi in, en een doorsnee locatie kreeg er van april tot en met september rond de 50 nieuwe e-mailadressen van gasten per maand bij (350 of meer bij de drukste één op de tien). Essentials begint bij £49/mnd, in je eigen valuta op de prijzenpagina, met het CaptiFi-apparaat beschikbaar tegen een borg die je terugkrijgt, en elk abonnement begint met een proefperiode van 30 dagen (je voegt een kaart toe om te starten). Wil je alleen gasten vastleggen en CSV-export op de apparatuur die je al hebt, dan kost Lite £19.99/mnd voor één locatie. Hetzelfde patroon met een extern portal werkt op TP-Link Omada, Cisco Meraki, Aruba Instant On, MikroTik en Ruckus, dus een groep met gemengde hardware beheert alles vanuit één account.

Problemen oplossen

ProbleemWat je doet
Inlogpagina verschijnt nooitControleer of het hotspotportal aan staat en of het adres van het externe portal exact 46.62.168.7 is. Controleer op nieuwere consoles ook de Hotspot-zone
Geen inlogpagina en geen internet op het gastennetwerkOp consoles met een zonegebaseerde firewall volgt de inlogpagina de Hotspot-zone. Ga naar Settings, Policy Engine, Zones en zet het gastennetwerk in de Hotspot-zone
Inlogpagina verschijnt op een privénetwerk met een wachtwoordDat netwerk zit in de Hotspot-zone of heeft het netwerktype Guest. Zet het terug in de Internal-zone
"Portal unreachable"Voeg site.app.captifi.io toe aan Pre-Authorization Access
Gasten loggen in maar krijgen geen internetControleer of het domein in de instellingen van de landingspagina op site.app.captifi.io staat
Pagina laadt zonder lettertypen of afbeeldingen, of blijft leeg op een iPhoneEr ontbreekt een pre-autorisatievermelding. Controleer elke vermelding uit stap 6, ook de twee fontdomeinen
Browser waarschuwt voor het certificaat op de inlogpaginaZet HTTPS Redirection Support en Secure Portal aan in de instellingen van de landingspagina
Controller maakt geen verbindingTest van buiten je netwerk via mobiele data. Is het WAN-adres privé, dan zit je achter dubbele NAT: gebruik de Remote Tunnel
"Invalid credentials", of "Could not sign in to your UniFi controller. Check the username and password and try again." terwijl de gegevens kloppenJe gebruikt een cloudlogin van Ubiquiti, en de verplichte multifactorauthenticatie daarvan kan CaptiFi niet afronden. Gebruik een API-sleutel of een lokaal controlleraccount
API-sleutel geweigerdControleer de versie van UniFi Network, of de rol van de sleutel Full Control is en of hij niet is verlopen. Sleutels worden één keer getoond, dus maak bij twijfel een nieuwe aan
Firewallregel lijkt niets te doen op een UDMDe bestemming moet de gateway zelf zijn: regeltype Internet Local of bestemmingszone Gateway, met een poortgroep waarin 80 en 443 staan
iPhone toont "Cannot Verify Server Identity"Het apparaat zit nog achter het portal. Open de wifi-inlogpagina en vul die in, of maak opnieuw verbinding met het netwerk

UniFi-installaties verschillen per hardware en firmwareversie. Ziet een scherm er anders uit dan hier beschreven, mail dan naar hello@captifi.io met het model van de console en de versie van UniFi Network, dan wijzen we je de juiste instelling.

Bronnen: Ubiquiti, UniFi hotspot portal and guest WiFi, geraadpleegd op 28 oktober 2026, voor de inlogopties die het eigen portal van UniFi biedt. De CaptiFi-stappen volgen de UniFi-installatiehandleiding. Ubiquiti, UniFi en de andere productnamen hier zijn handelsmerken van hun respectieve eigenaren; CaptiFi is niet aan hen verbonden en is niet door hen goedgekeurd.

Leg e-mailadressen van gasten vast via je UniFi-wifi

Proefperiode van 30 dagen; je voegt een kaart toe om te starten. Werkt met elke UniFi-console en elk UniFi-access point, of met het plug-and-play-apparaat tegen een borg die je terugkrijgt, op elk abonnement.

Gratis proberen

CaptiFi is een platform voor gastenwifimarketing en captive portals voor restaurants, bars, pubs, koffiebars, hotels, sportscholen, salons, winkels en vakantieverhuur, gemaakt door CaptiFi Ltd in het Verenigd Koninkrijk en verkocht in GBP, USD, EUR, CAD, AUD en NZD aan zaken over de hele wereld.

Veelgestelde vragen

Korte antwoorden op de meest gestelde vragen over dit onderwerp.

Wat kan het eigen hotspotportal van UniFi zonder CaptiFi?
Het helpcentrum van Ubiquiti noemt voor het hotspotportal van UniFi inloggen met wachtwoord, voucher, Facebook, RADIUS en betaling via Stripe, plus een optie External Portal Server voor portals van derden. Een aanmeldformulier met e-mailadres of marketingtools staan er niet bij. CaptiFi gebruikt de optie External Portal Server en voegt daar op elk abonnement een gastenlijst aan toe waarin de marketingtoestemming van elke gast is vastgelegd, en geautomatiseerde opvolging zoals welkomstmails, reviewverzoeken en win-backaanbiedingen, die bij CaptiFi beginnen bij het abonnement Essentials.
Hoe lang duurt het instellen van een captive portal op UniFi met CaptiFi?
De aanbevolen route met de API-sleutel heeft vier stappen. Je maakt in UniFi een API-sleutel met Full Control aan, laat het ene adres van CaptiFi, 46.62.168.7, door naar de controller, verbindt de controller vanuit je CaptiFi-dashboard en kiest het gastennetwerk. CaptiFi schrijft de instellingen van het hotspotportal zelf weg. Apparaten die al verbonden zijn, zien de inlogpagina zodra ze opnieuw verbinden, dus een volledige overgang kan een dag duren.
Welke UniFi-controllers en access points werken met CaptiFi?
Elke huidige console: UDM, UDM Pro en UDM SE, UCG Ultra en UCG Max, Dream Router, UniFi Express, Cloud Key en Cloud Key Gen2, en een zelf gehoste UniFi Network-applicatie, ook UniFi OS Server op Windows, met UniFi Network 6 of hoger. Het portal wordt op de controller ingesteld, dus U7, U6 en oudere UAP-AC-access points tonen allemaal dezelfde inlogpagina.
Heb ik een RADIUS-server nodig voor een captive portal op UniFi?
Nee. CaptiFi autoriseert gasten via de API van de UniFi-controller, met een API-sleutel, de Remote Tunnel of een lokaal beheerdersaccount. Op het hotspotportal staan de methoden Password, Voucher, Facebook, Payment en RADIUS uit, zodat alleen CaptiFi gasten autoriseert, en er is geen shared secret om te beheren.
Wat als mijn UniFi-console achter een andere router of achter CGNAT zit?
Gebruik de Remote Tunnel. Je console maakt zelf een uitgaande verbinding met CaptiFi, dus er gaat geen inkomende poort open. Zet SSH aan onder Settings, Control Plane, Console, plak het installatiecommando dat CaptiFi voor je locatie toont en wacht ongeveer 30 seconden. De tunnel maakt na een herstart of een stroomstoring vanzelf opnieuw verbinding. Hij draait op UniFi OS-consoles en de meeste Cloud Keys, en is niet beschikbaar voor zelf gehoste controllers.
Wat vul ik in als ik het hotspotportal van UniFi handmatig instel?
Alleen nodig als CaptiFi niet naar de controller kan schrijven. Zet Authentication op External Portal Server met IPv4-adres 46.62.168.7 en domein site.app.captifi.io, voeg site.app.captifi.io, app.captifi.io, fonts.googleapis.com en fonts.gstatic.com toe aan Pre-Authorization Access, voeg de privébereiken toe aan Post-Authorization Restrictions, vink Show Landing Page, HTTPS Redirection Support, Encrypted URL en Secure Portal aan, en zet de andere authenticatiemethoden uit.
Verliezen pinapparaten en printers hun internetverbinding als het portal live is?
Alles wat geen inlogpagina kan tonen, zoals bonprinters, pinapparaten, iPads in de backoffice, muziekspelers en digitale schermen, verliest zijn internetverbinding bij de eerstvolgende keer dat het opnieuw verbindt met het afgeschermde netwerk. Verplaats die apparaten naar een privénetwerk voor personeel met een wachtwoord, of voeg hun MAC-adressen toe onder Pre-authorized devices op de locatiekaart. CaptiFi autoriseert ze meteen en ververst de autorisatie elke nacht.
Kan ik meerdere UniFi-sites op één CaptiFi-account beheren?
Ja. Het is één CaptiFi-locatie per UniFi-site, gekozen in de keuzelijst Controller site als je verbindt, en één API-sleutel dekt elke site op de controller. Elke locatie krijgt een eigen ontwerp voor de inlogpagina. In elk abonnement zit één locatie, en vanaf Essentials betaal je voor elke extra locatie het tarief voor een extra locatie, £25 per maand.
C
Geschreven door
Redactie van CaptiFi

De redactie van CaptiFi schrijft over gastenwifimarketing, captive portals, het vastleggen van gegevens volgens de AVG en lokale SEO voor ondernemers met een zaak. Als we CaptiFi met een ander platform vergelijken, gebruiken we de eigen website van dat bedrijf, met de datum waarop we die hebben geraadpleegd.

Klaar om van je gastenwifi een marketingmachine te maken?

CaptiFi legt bij elke wifi-login klantgegevens vast, automatiseert Google-reviews en opvolgmails, en sluit aan op de tools die je al gebruikt. Het CaptiFi-apparaat zit bij elk abonnement, tegen een borg die je terugkrijgt, de prijzen staan op de prijzenpagina en elk abonnement heeft een gratis proefperiode van 30 dagen.

Verder lezen