Captive portal op Ruckus
Installatiehandleiding
Laat je Ruckus Unleashed-access points naar CaptiFi verwijzen met een Hotspot (WISPr)-service plus RADIUS: leg e-mailadressen van gasten vast, automatiseer Google-reviews en laat je marketing op de automatische piloot draaien. Gebruik je SmartZone, ZoneDirector of RUCKUS One? Die stellen we in overleg in, dus mail naar hello@captifi.io voordat je begint.
• Ruckus-access points die op Unleashed draaien, met beheerderstoegang tot de webinterface van Unleashed
• Een computer op hetzelfde netwerk waarmee je een SSH-sessie naar je Unleashed master access point kunt openen (Terminal op een Mac, PowerShell of PuTTY op Windows)
• Een CaptiFi-account met een Ruckus-locatie: maak er hier een aan
• Je site-ID, RADIUS shared secret en NAS identifier van CaptiFi (te vinden in de installatiewizard, en onder Controllerinstellingen op de kaart van je locatie)
Op deze pagina
1 Overzicht van de installatie in 6 stappen
Sinds oktober 2026 werkt CaptiFi direct met Ruckus Unleashed, via een Hotspot (WISPr)-service plus RADIUS-authenticatie. Gasten die verbinding maken met je gastenwifi worden naar je CaptiFi-inlogpagina gestuurd. Zodra ze die hebben afgerond, logt de pagina ze in op je Unleashed-netwerk, en Unleashed controleert bij de RADIUS-server van CaptiFi voordat het apparaat online mag. Alles gebeurt in de webinterface van Unleashed, op één kort commando via SSH na.
| Stap 1 | Maak de Ruckus-locatie aan in CaptiFi om je portal-URL, RADIUS-waarden en NAS identifier te krijgen. |
|---|---|
| Stap 2 | Voeg de RADIUS-servers van CaptiFi toe in Unleashed, één voor authenticatie en één voor accounting. |
| Stap 3 | Maak de hotspotservice aan die gasten naar je CaptiFi-inlogpagina stuurt, met de bijbehorende walled garden. |
| Stap 4 | Maak het gast-WLAN aan op die hotspotservice. |
| Stap 5 | Stel het NAS-ID van het gast-WLAN in via SSH, zodat CaptiFi weet op welke locatie elke gast is. |
| Stap 6 | Test het geheel met een telefoon. |
2 Maak de locatie aan in CaptiFi
Log in op my.captifi.io, ga naar Mijn locaties → Locatie toevoegen (of kies je hardware in de installatiewizard) en selecteer Ruckus. Geef de controller een naam en rond de wizard af. De stap Activeer je wifi toont wat Unleashed nodig heeft als een configuratiepakket dat je kunt kopiëren: je portal-URL, de RADIUS-server en de poorten, het shared secret, je NAS identifier, de Start Page-URL en de NAS-ID-commando's voor de SSH-stap, met de waarden van je locatie al ingevuld. Het secret blijft verborgen tot je op Tonen klikt. Later vind je dezelfde waarden op de kaart van de locatie onder Mijn locaties (open Meer en kies Controllerinstellingen).
De wifi-stap toont onder het portaladres de verbindingscontroles: of de controller RADIUS-verkeer stuurt, of een gastapparaat de inlogpagina heeft bereikt, en of gasten die afronden. Zijn de stappen hieronder klaar, maak dan met een telefoon verbinding met de gastenwifi en de controles worden groen.
Je portal-URL heeft deze vorm (vervang YOUR_SITE_ID door het site-ID uit je dashboard):
| Portal URL | https://app.captifi.io/guest/ruckus?site_id=YOUR_SITE_ID |
|---|
site_id.3 Voeg de RADIUS-servers van CaptiFi toe
Ruckus zet gasten online via RADIUS. Nadat een gast het formulier op de inlogpagina heeft verstuurd, vraagt Unleashed aan de RADIUS-server van CaptiFi of dat apparaat online mag. Zonder deze stap zien gasten de inlogpagina wel, maar krijgen ze nooit internet.
Ga in Unleashed naar Admin & Services → Services → AAA Servers en klik twee keer op Create, één keer voor elke server hieronder. Unleashed wil hier een IP-adres, en 46.62.168.7 is de RADIUS-server van CaptiFi (radius.captifi.io).
Authenticatieserver
| Naam | Naar keuze, bijvoorbeeld CaptiFi-Auth |
|---|---|
| Type | RADIUS |
| Auth Method | PAP |
| IP Address | 46.62.168.7 |
| Port | 1812 |
| Shared Secret | Te vinden in je CaptiFi-dashboard |
Accountingserver
| Naam | Naar keuze, bijvoorbeeld CaptiFi-Acct |
|---|---|
| Type | RADIUS Accounting |
| IP Address | 46.62.168.7 |
| Port | 1813 |
| Shared Secret | Hetzelfde shared secret |
4 Maak de hotspotservice aan
Ga naar Admin & Services → Services → Hotspot Services en klik op Create. Je kunt de service ook aanmaken vanuit het gast-WLAN in de volgende stap, met de + naast Hotspot Services.
Tabblad General
| Naam | CaptiFi |
|---|---|
| WISPr Smart Client Support | Geen |
| Login Page | Je CaptiFi-portal-URL uit stap 2 |
| Start Page | Redirect to the following URL: https://app.captifi.io/site/YOUR_SITE_ID/connected |
Gebruik hetzelfde site-ID als in je portal-URL. Gasten komen op deze verbonden-pagina uit zodra ze online zijn, en die stuurt ze door naar de redirect-URL die bij je locatie is ingesteld. We hebben de andere Start Page-optie geprobeerd (de URL die de gebruiker wil bezoeken): iPhones kwamen wel online, maar bleven op een leeg scherm hangen, dus kies de redirect.
Tabblad Authentication
Kies de CaptiFi-authenticatieserver uit stap 3 bij Authentication, en de CaptiFi-accountingserver bij Accounting.
Tabblad Walled Garden
Dankzij de walled garden kunnen gasten de servers van CaptiFi bereiken voordat ze inloggen. Zonder deze regels kan de inlogpagina niet laden. Voeg ze alle drie toe:
- app.captifi.io
- captifi.io
- 46.62.168.7
5 Maak het gast-WLAN aan
Ga naar Wi-Fi Networks en klik op Create, of bewerk je bestaande gastnetwerk:
| Naam | De naam van je gastnetwerk, bijvoorbeeld The Anchor Guest WiFi |
|---|---|
| Usage Type | Hotspot Service |
| Authentication Method | Open |
| Encryption Method | Geen |
| Hotspot Services | CaptiFi (de service uit stap 4) |
6 Stel het NAS-ID in via SSH
Unleashed stuurt bij elk RADIUS-verzoek een NAS-ID mee, en CaptiFi herkent daaraan je locatie. Doe je niets, dan stuurt het WLAN zijn eigen BSSID mee, dat CaptiFi niet aan een locatie kan koppelen, waardoor gasten de inlogpagina zien maar nooit online komen. De webinterface van Unleashed heeft er geen veld voor, en daarom regel je deze ene instelling via SSH.
Open een SSH-sessie naar je master access point, met het IP-adres waarop je de webinterface van Unleashed opent. Op een Mac of Linux:
Unleashed biedt een ouder sleuteltype aan dat huidige SSH-clients alleen op verzoek accepteren, vandaar de extra optie. PuTTY op Windows maakt zonder die optie verbinding. Vul bij Please login: de gebruikersnaam en het wachtwoord van je Unleashed-beheerder in en open daarna het gast-WLAN met deze regels, één voor één, met de exacte naam van je gast-WLAN uit stap 5:
Unleashed hoort te antwoorden dat de WLAN-service has been loaded. Staat er in plaats daarvan has been created, dan komt de naam met geen van je WLAN's overeen en is Unleashed aan een nieuw WLAN begonnen. Typ abort, waarmee niets wordt opgeslagen, en open het WLAN opnieuw met de exacte naam, inclusief hoofdletters en spaties. Is het geladen, stel dan het NAS-ID in met de NAS identifier uit je CaptiFi-dashboard en sla op:
Je CaptiFi-dashboard toont beide sets regels met de waarden van je eigen locatie al ingevuld, klaar om te kopiëren. Na end antwoordt Unleashed dat de WLAN-service is bijgewerkt en opgeslagen.
7 De oplossing testen
Maak met een telefoon verbinding met de gastenwifi. De CaptiFi-inlogpagina hoort vanzelf te openen; gebeurt dat niet, open dan een browser en ga naar een willekeurige HTTP-site (bijvoorbeeld http://example.com). Vul het inlogformulier in. Binnen een paar seconden is de telefoon online en toont die je verbonden-pagina, en daarna de redirect-URL van je locatie.
Controleer in je CaptiFi-dashboard onder Gastbezoeken of de gast is vastgelegd. Staat de gast in je logs, dan ben je live.
Werkt met je bestaande Ruckus-apparatuur, of gebruik ons meegeleverde apparaat
CaptiFi is hier eerlijk over: 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 Ruckus-apparatuur | Draai je al Ruckus-access points op Unleashed, volg dan de stappen hierboven. CaptiFi staat ervoor als WISPr-portal en RADIUS-server, zonder extra hardware. Gebruik je SmartZone, ZoneDirector of RUCKUS One, mail dan naar hello@captifi.io voordat je gaat instellen. |
|---|---|
| Gebruik ons inbegrepen plug-and-play-apparaat | Geen Ruckus-controller, of kom je er liever niet aan? We sturen je per post een vooraf geconfigureerd CaptiFi-apparaat. Sluit het met een ethernetkabel aan op je bestaande netwerk, voer op je telefoon de activatiepincode van 8 cijfers in, en het haalt zijn configuratie uit de cloud. De gastenwifi is in ongeveer vijf minuten live, van begin tot eind, zonder controller, vast IP-adres of firewallwijziging. |
Lite: £19.99 per maand op je eigen netwerk
Gebruik je al Ruckus? Lite is gasten vastleggen en CSV-export op de access points die je hebt, 500 nieuwe gasten per maand, voor één locatie. De inlogpagina houdt de CaptiFi-branding.
Verwante handleidingen en pagina's
Veelgestelde vragen over een captive portal op Ruckus
Welke Ruckus-platforms ondersteunt CaptiFi?
Sinds oktober 2026 werkt CaptiFi direct met Ruckus Unleashed, ingesteld zoals deze handleiding beschrijft. SmartZone, ZoneDirector en RUCKUS One gaan in overleg: mail naar hello@captifi.io of gebruik de contactpagina voordat je op een van die platforms gaat instellen.
Waarom verschijnt mijn Ruckus-inlogpagina niet?
Controleer of het Usage Type van het gast-WLAN op Hotspot Service staat met de CaptiFi-hotspotservice geselecteerd, en of de Login Page van de service exact overeenkomt met je portal-URL. Laadt de pagina zonder opmaak, of helemaal niet, controleer dan of de walled garden alle drie de regels bevat: app.captifi.io, captifi.io en 46.62.168.7.
Gasten zien de inlogpagina maar komen nooit online. Waarom?
Controleer eerst het NAS-ID. Zonder de SSH-stap stuurt het WLAN zijn BSSID als NAS-ID mee, kan CaptiFi dat niet aan je locatie koppelen en komen gasten nooit online. Controleer daarna de authenticatieserver in Unleashed: IP 46.62.168.7, poort 1812, auth method PAP, en gekozen op het tabblad Authentication van de hotspotservice. Worden gasten na de inlogpagina geweigerd, dan komt het shared secret niet overeen, dus kopieer het opnieuw uit je CaptiFi-dashboard naar beide AAA-servers.
Waarom verschijnen er geen gasten in mijn CaptiFi-dashboard?
Kies op het tabblad Authentication van de hotspotservice de CaptiFi-accountingserver bij Accounting, naast de authenticatieserver bij Authentication; zonder die server krijgt CaptiFi geen sessiegegevens. Ontbreken gasten helemaal, loop dan het antwoord over NAS-ID en RADIUS hierboven door. Reken na elke wijziging op 1-2 minuten voordat de instellingen zijn doorgevoerd.
Waarom wordt het portal niet geactiveerd op HTTPS-sites?
Gasten moeten soms eerst een HTTP-site bezoeken (bijvoorbeeld http://example.com) om de redirect naar het portal te activeren. Dit is standaardgedrag van een captive portal en geen fout van Ruckus of CaptiFi: HTTPS-verkeer kan niet transparant worden doorgestuurd.
Kan ik CaptiFi op meerdere Ruckus-locaties gebruiken?
Ja. Elke locatie kan een eigen ontwerp voor de inlogpagina hebben, en elke locatie heeft een eigen portal-URL en NAS identifier, dus elk Unleashed-netwerk heeft een eigen hotspotservice en een eigen NAS-ID nodig. Je beheert ze onder Mijn locaties in je CaptiFi-dashboard. Voor elke extra CaptiFi-locatie boven de ene die in je abonnement zit, betaal je het tarief voor een extra locatie in je valuta.
Werken snelheidslimieten en sessieduur op Ruckus Unleashed?
Ja. De snelheidslimieten die je instelt in Locatie bewerken en de sessieduur gelden allebei voor gasten op Unleashed.
Kan ik wifi-vouchers of Betaalde wifi verkopen op Ruckus?
Nee. Wifi-vouchers en Betaalde wifi zijn niet beschikbaar op Ruckus-netwerken. Probeer je een van beide in te schakelen voor een Ruckus-locatie, dan meldt my.captifi.io dat het niet beschikbaar is, en gasten gebruiken altijd de standaard inlogpagina.
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
Maak van je Ruckus-gastenwifi een marketingmachine
Start een gratis proefperiode van 30 dagen, of bekijk eerst een live demo.