Zum Hauptinhalt springen
Setup-Leitfaden

Ruckus Captive Portal
Einrichtungsanleitung

Richten Sie Ihre Ruckus Unleashed Access Points mit einem Hotspot-Dienst (WISPr) plus RADIUS auf CaptiFi aus: Erfassen Sie Gäste-E-Mail-Adressen, automatisieren Sie Google-Bewertungen und lassen Sie Ihr Marketing auf Autopilot laufen. Sie nutzen SmartZone, ZoneDirector oder RUCKUS One? Diese werden nach Absprache eingerichtet, schreiben Sie also eine E-Mail an hello@captifi.io, bevor Sie beginnen.

📋 Bevor Sie beginnen, stellen Sie sicher, dass Sie Folgendes haben:
• Ruckus-Access-Points mit Unleashed und Administratorzugriff auf die Unleashed-Weboberfläche
• Einen Computer im selben Netzwerk, der eine SSH-Sitzung zu Ihrem Unleashed-Master-Access-Point öffnen kann (Terminal auf einem Mac, PowerShell oder PuTTY unter Windows)
• Ein CaptiFi-Konto mit einem Ruckus-Standort: hier erstellen
• Ihre Site-ID, Ihr RADIUS Shared Secret und Ihre NAS-Kennung von CaptiFi (angezeigt im Einrichtungsassistenten und unter den Controller-Einstellungen auf der Karte Ihres Standorts)

1 Einrichtung in 6 Schritten im Überblick

Stand Oktober 2026 funktioniert CaptiFi ohne Zusatzaufwand mit Ruckus Unleashed, über einen Hotspot-Dienst (WISPr) plus RADIUS-Authentifizierung. Gäste, die sich mit Ihrem Gäste-WLAN verbinden, werden auf Ihre CaptiFi-Splash-Seite geleitet. Wenn sie diese abgeschlossen haben, meldet die Seite sie in Ihrem Unleashed-Netzwerk an, und Unleashed fragt beim RADIUS-Server von CaptiFi nach, bevor das Gerät online gehen darf. Alles geschieht in der Unleashed-Weboberfläche, abgesehen von einem kurzen Befehl über SSH.

💡 Dieser Leitfaden behandelt Ruckus Unleashed. Wenn Ihre Access Points von SmartZone, ZoneDirector oder RUCKUS One verwaltet werden, werden diese nach Absprache eingerichtet: Schreiben Sie eine E-Mail an hello@captifi.io oder nutzen Sie die Kontaktseite, bevor Sie beginnen.
Schritt 1 Erstellen Sie den Ruckus-Standort in CaptiFi, um Ihre Portal-URL, RADIUS-Werte und NAS-Kennung zu erhalten.
Schritt 2 Fügen Sie die RADIUS-Server von CaptiFi in Unleashed hinzu, einen für die Authentifizierung und einen für das Accounting.
Schritt 3 Erstellen Sie den Hotspot-Dienst, der Gäste auf Ihre CaptiFi-Splash-Seite leitet, samt Walled Garden.
Schritt 4 Erstellen Sie das Gäste-WLAN auf diesem Hotspot-Dienst.
Schritt 5 Legen Sie die NAS-ID des Gäste-WLANs über SSH fest, damit CaptiFi weiß, in welchem Betrieb sich jeder Gast befindet.
Schritt 6 Testen Sie alles von Anfang bis Ende mit einem Smartphone.
⚠️ Die Portal-URL, die RADIUS-Angaben und das Shared Secret müssen exakt so eingegeben werden, wie in Ihrem CaptiFi-Dashboard angezeigt. Falsche Werte verhindern, dass das Captive Portal funktioniert.

2 Legen Sie den Standort in CaptiFi an

Melden Sie sich bei my.captifi.io an, gehen Sie zu Meine Standorte → Standort hinzufügen (oder wählen Sie Ihre Hardware im Einrichtungsassistenten) und wählen Sie Ruckus aus. Geben Sie dem Controller einen Namen und schließen Sie den Assistenten ab. Dessen Schritt WLAN aktivieren zeigt als kopierbares Konfigurationspaket, was Unleashed benötigt: Ihre Portal-URL, den RADIUS-Server und die Ports, das Shared Secret, Ihre NAS-Kennung, die Start-Page-URL und die NAS-ID-Befehle für den SSH-Schritt, jeweils mit den Werten Ihres Standorts ausgefüllt. Das Secret bleibt verborgen, bis Sie auf Anzeigen klicken. Später finden Sie dieselben Werte auf der Karte des Standorts unter Meine Standorte (öffnen Sie Mehr und wählen Sie Controller-Einstellungen).

Der WLAN-Schritt listet die Verbindungsprüfungen unter der Portaladresse auf: ob der Controller RADIUS-Datenverkehr sendet, ob ein Gastgerät die Splash-Seite erreicht hat und ob Gäste sie abschließen. Sobald die folgenden Schritte erledigt sind, verbinden Sie sich mit einem Smartphone mit dem Gäste-WLAN, und die Prüfungen werden grün.

Ihre Portal-URL hat diese Form (ersetzen Sie YOUR_SITE_ID durch die Standort-ID aus Ihrem Dashboard):

Portal-URL https://app.captifi.io/guest/ruckus?site_id=YOUR_SITE_ID
⚠️ Ihr Access Point hängt die MAC-Adresse des Gastes, die SSID und weitere Angaben automatisch an diese URL an, fügen Sie daher nach site_id nichts hinzu.

3 Die RADIUS-Server von CaptiFi hinzufügen

Ruckus bringt Gäste über RADIUS online. Nachdem ein Gast das Splash-Formular abgeschickt hat, fragt Unleashed den RADIUS-Server von CaptiFi, ob dieses Gerät zugelassen werden soll. Ohne diesen Schritt sehen Gäste die Splash-Seite, kommen aber nie ins Internet.

Gehen Sie in Unleashed zu Admin & Services → Services → AAA Servers und klicken Sie zweimal auf Create, einmal für jeden der Server unten. Unleashed erwartet hier eine IP-Adresse, und 46.62.168.7 ist der RADIUS-Server von CaptiFi (radius.captifi.io).

Authentifizierungsserver

Name Frei wählbar, zum Beispiel CaptiFi-Auth
Typ RADIUS
Auth-Methode PAP
IP-Adresse 46.62.168.7
Port 1812
Shared Secret Angezeigt in Ihrem CaptiFi-Dashboard

Accounting-Server

Name Frei wählbar, zum Beispiel CaptiFi-Acct
Typ RADIUS Accounting
IP-Adresse 46.62.168.7
Port 1813
Shared Secret Dasselbe Shared Secret

4 Den Hotspot-Dienst erstellen

Gehen Sie zu Admin & Services → Services → Hotspot Services und klicken Sie auf Create. Sie können ihn auch im nächsten Schritt vom Gäste-WLAN aus anlegen, mit dem + neben Hotspot Services.

Registerkarte Allgemein

Name CaptiFi
WISPr Smart Client Support Keine
Anmeldeseite Ihre CaptiFi-Portal-URL aus Schritt 2
Startseite Weiterleitung auf die folgende URL: https://app.captifi.io/site/YOUR_SITE_ID/connected

Verwenden Sie dieselbe Site-ID wie in Ihrer Portal-URL. Gäste landen auf dieser Verbunden-Seite, sobald sie online sind, und sie leitet sie zur Weiterleitungs-URL weiter, die für Ihren Standort festgelegt ist. Wir haben die andere Start-Page-Option (die URL, die der Nutzer aufrufen wollte) ausprobiert: iPhones kamen online, landeten aber auf einem leeren Bildschirm, wählen Sie also die Weiterleitung.

Registerkarte Authentifizierung

Wählen Sie für Authentication den CaptiFi-Authentifizierungsserver aus Schritt 3 und für Accounting den CaptiFi-Accounting-Server.

Tab Walled Garden

Der Walled Garden ermöglicht es Gästen, die Server von CaptiFi zu erreichen, bevor sie sich anmelden. Ohne diese Einträge kann die Splash-Seite nicht geladen werden. Fügen Sie alle drei hinzu:

  • app.captifi.io
  • captifi.io
  • 46.62.168.7
Klicken Sie auf OK, um den Hotspot-Dienst zu speichern.
💡 Es gibt keine separate Rückleitungs-URL zur Konfiguration. Die Splash-Seite meldet den Gast selbst bei Unleashed an, und Unleashed fragt dann den RADIUS-Server von CaptiFi.

5 Das Gäste-WLAN erstellen

Gehen Sie zu Wi-Fi Networks und klicken Sie auf Create, oder bearbeiten Sie Ihr bestehendes Gästenetzwerk:

Name Name Ihres Gastnetzwerks, zum Beispiel The Anchor Guest WiFi
Nutzungsart Hotspot-Dienst
Authentifizierungsmethode Offen
Verschlüsselungsmethode Keine
Hotspot-Dienste CaptiFi (der Dienst aus Schritt 4)
Klicken Sie auf OK, um zu speichern.
💡 Der Netzwerkname wird auf Ihrem Ruckus-Controller verwaltet. Wenn Sie den WLAN-Netzwerknamen in CaptiFi ändern, wird das Netzwerk in Unleashed nicht umbenannt, nehmen Sie Namensänderungen daher hier vor.

6 Die NAS-ID über SSH festlegen

Unleashed sendet mit jeder RADIUS-Anfrage eine NAS-ID, und CaptiFi erkennt daran Ihren Standort. Ohne Anpassung sendet das WLAN stattdessen seine eigene BSSID, die CaptiFi keinem Standort zuordnen kann, sodass Gäste die Splash-Seite sehen, aber nie online kommen würden. Die Weboberfläche von Unleashed hat dafür kein Feld, weshalb diese eine Einstellung über SSH vorgenommen wird.

Öffnen Sie eine SSH-Sitzung zu Ihrem Master-Access-Point, mit der IP-Adresse, unter der Sie die Unleashed-Weboberfläche öffnen. Auf einem Mac oder unter Linux:

ssh -o HostKeyAlgorithms=+ssh-rsa admin@UNLEASHED_IP

Unleashed bietet einen älteren Schlüsseltyp an, den aktuelle SSH-Clients ablehnen, sofern man ihn nicht ausdrücklich anfordert, daher die zusätzliche Option. PuTTY unter Windows verbindet sich auch ohne sie. Geben Sie bei Please login: Ihren Unleashed-Admin-Benutzernamen und Ihr Passwort ein und öffnen Sie dann das Gäste-WLAN mit diesen Zeilen, eine nach der anderen, unter Verwendung des genauen Namens Ihres Gäste-WLANs aus Schritt 5:

enable config wlan "YOUR GUEST WLAN NAME"

Unleashed sollte antworten, dass der WLAN-Dienst has been loaded. Wenn stattdessen has been created erscheint, passt der Name zu keinem Ihrer WLANs, und Unleashed hat ein neues angelegt. Geben Sie abort ein, was nichts speichert, und öffnen Sie das WLAN erneut mit seinem exakten Namen, einschließlich Großbuchstaben und Leerzeichen. Sobald es geladen ist, setzen Sie die NAS-ID auf die NAS-Kennung aus Ihrem CaptiFi-Dashboard und speichern Sie:

nasid-type user-define YOUR_NAS_IDENTIFIER end exit exit

Ihr CaptiFi-Dashboard zeigt beide Zeilensätze mit den eigenen Werten Ihres Standorts bereits ausgefüllt und fertig zum Kopieren. Nach end antwortet Unleashed, dass der WLAN-Dienst aktualisiert und gespeichert wurde.

7 Lösung testen

Verbinden Sie sich mit einem Smartphone mit dem Gäste-WLAN. Die CaptiFi-Splash-Seite sollte sich von selbst öffnen; falls nicht, öffnen Sie einen Browser und rufen Sie eine beliebige HTTP-Seite auf (zum Beispiel http://example.com). Füllen Sie das Anmeldeformular aus. Innerhalb weniger Sekunden ist das Smartphone online und zeigt Ihre Verbunden-Seite und anschließend die Weiterleitungs-URL Ihres Betriebs.

Prüfen Sie in Ihrem CaptiFi-Dashboard unter Gästebesuche, ob die Erfassung angekommen ist. Wenn der Gast in Ihren Protokollen erscheint, sind Sie live.

✅ Ihr Captive Portal von CaptiFi läuft jetzt in Ihrem Ruckus-Netzwerk. Jeder Gast, der sich verbindet, sieht Ihre Anmeldeseite in Ihrem Design, und seine E-Mail-Adresse wird automatisch erfasst.

Funktioniert mit Ihrer vorhandenen Ruckus-Hardware, oder Sie nutzen unser mitgeliefertes Gerät

CaptiFi ist da ehrlich: Sie müssen nichts Neues kaufen. Es gibt zwei Wege: Ihre vorhandene Hardware funktioniert in jedem Tarif, und das Plug-and-Play-Gerät ist in jedem Tarif enthalten.

Nutzen Sie Ihre vorhandene Ruckus-Hardware Wenn Sie bereits Ruckus-Access-Points mit Unleashed betreiben, folgen Sie den obigen Schritten. CaptiFi wird als WISPr-Portal und RADIUS-Server vorgeschaltet, ohne zusätzliche Hardware. Bei SmartZone, ZoneDirector oder RUCKUS One schreiben Sie vor der Einrichtung eine E-Mail an hello@captifi.io.
Nutzen Sie unser mitgeliefertes Plug-and-Play-Gerät Kein Ruckus Controller, oder möchten Sie ihn lieber nicht anfassen? Wir schicken Ihnen ein vorkonfiguriertes CaptiFi-Gerät per Post. Schließen Sie es per Ethernet an Ihr bestehendes Netzwerk an, geben Sie die 8-stellige Aktivierungs-PIN über Ihr Smartphone ein, und es holt sich seine Konfiguration aus der Cloud. Das Gäste-WLAN ist in etwa fünf Minuten startklar, von Anfang bis Ende, ohne Controller, statische IP oder Firewall-Änderung.
💡 Das Plug-and-Play-Gerät ist die Alternative ganz ohne Konfiguration. Es ist in beiden Fällen dieselbe Marketingplattform, sodass Sie mit unserem Gerät starten und später auf Ihre Ruckus-Hardware umsteigen können, oder auch nie.

Lite: £19.99 pro Monat in Ihrem eigenen Netzwerk

Sie nutzen bereits Ruckus? Lite bietet Gästeerfassung und CSV-Export auf Ihren vorhandenen Access Points, 500 neue Gäste pro Monat, für einen Standort. Die Splash-Seite behält das CaptiFi-Branding.

Verwandte Leitfäden und Seiten

FAQ zum Ruckus Captive Portal

Welche Ruckus-Plattformen unterstützt CaptiFi?

Stand Oktober 2026 funktioniert CaptiFi ohne Zusatzaufwand mit Ruckus Unleashed, eingerichtet wie in diesem Leitfaden beschrieben. SmartZone, ZoneDirector und RUCKUS One gibt es nach Absprache: Schreiben Sie eine E-Mail an hello@captifi.io oder nutzen Sie die Kontaktseite, bevor Sie die Einrichtung auf einem dieser Systeme vornehmen.

Warum erscheint meine Ruckus Splash-Seite nicht?

Prüfen Sie, ob der Usage Type des Gäste-WLANs Hotspot Service ist und der CaptiFi-Hotspot-Dienst ausgewählt ist und ob die Login Page des Dienstes exakt mit Ihrer Portal-URL übereinstimmt. Wenn die Seite ohne ihr Styling oder gar nicht lädt, prüfen Sie, ob der Walled Garden alle drei Einträge enthält: app.captifi.io, captifi.io und 46.62.168.7.

Gäste sehen die Splash-Seite, kommen aber nie online. Warum?

Prüfen Sie zuerst die NAS-ID. Ohne den SSH-Schritt sendet das WLAN seine BSSID als NAS-ID, CaptiFi kann diese nicht Ihrem Standort zuordnen, und Gäste kommen nie online. Prüfen Sie als Nächstes den Authentifizierungsserver in Unleashed: IP 46.62.168.7, Port 1812, Authentifizierungsmethode PAP und im Tab Authentication des Hotspot-Dienstes ausgewählt. Wenn Gäste nach der Splash-Seite abgewiesen werden, stimmt das Shared Secret nicht überein; kopieren Sie es daher erneut aus Ihrem CaptiFi-Dashboard in beide AAA-Server.

Warum erscheinen keine Gäste in meinem CaptiFi Dashboard?

Wählen Sie im Tab Authentication des Hotspot-Dienstes den CaptiFi-Accounting-Server für Accounting sowie den Authentifizierungsserver für Authentication aus; ohne ihn erhält CaptiFi keine Sitzungsdaten. Wenn Gäste ganz fehlen, gehen Sie die obige Antwort zu NAS-ID und RADIUS durch. Warten Sie nach jeder Änderung 1-2 Minuten, bis die Einstellungen übernommen sind.

Warum wird das Portal auf HTTPS-Seiten nicht ausgelöst?

Gäste müssen möglicherweise zuerst eine HTTP-Seite besuchen (zum Beispiel http://example.com), um die Portal-Weiterleitung auszulösen. Dies ist das übliche Verhalten eines Captive Portals und kein Fehler von Ruckus oder CaptiFi: HTTPS-Datenverkehr kann nicht transparent umgeleitet werden.

Kann ich CaptiFi an mehreren Ruckus-Standorten einsetzen?

Ja. Jeder Standort kann sein eigenes Splash-Seiten-Design haben, und jeder hat seine eigene Portal-URL und NAS-Kennung, sodass jedes Unleashed-Netzwerk seinen eigenen Hotspot-Dienst und seine eigene NAS-ID benötigt. Sie verwalten sie unter „Meine Standorte“ in Ihrem CaptiFi-Dashboard. Jeder zusätzliche CaptiFi-Standort über den in Ihrem Tarif enthaltenen hinaus wird zum Zusatzstandort-Preis Ihrer Währung berechnet.

Funktionieren Geschwindigkeitsbegrenzungen und Sitzungsdauer bei Ruckus Unleashed?

Ja. Die Geschwindigkeitsbegrenzungen, die Sie unter „Standort bearbeiten“ festlegen, und die Sitzungsdauer gelten beide für Gäste in Unleashed.

Kann ich mit Ruckus WLAN-Gutscheine oder bezahltes WLAN verkaufen?

Nein. WLAN-Gutscheine und kostenpflichtiges WLAN sind in Ruckus-Netzwerken nicht verfügbar. Wenn Sie versuchen, eines von beiden für einen Ruckus-Standort einzuschalten, teilt my.captifi.io Ihnen mit, dass es nicht verfügbar ist, und Gäste nutzen immer die Standard-Anmeldeseite.

Für MSPs und Installateure

Richten Sie dies für einen Kunden ein?

CaptiFi-Partner kaufen in jedem Tarif zu einem Großhandelspreis unter dem Endkundenpreis ein, und White Label gibt es zu denselben Preisen. Sie legen Ihren eigenen Preis fest und rechnen direkt mit Ihren Kunden ab. Die vollständige Preisliste in Ihrer Währung steht im Partner-Dashboard, sobald Ihr Konto freigegeben ist, und Sie können sie bei der Bewerbung anfragen.

  • ✓ Preislisten in GBP, USD, EUR, CAD, AUD und NZD
  • ✓ Kostenlose 6-monatige interne Demo-Lizenz für einen internen Teststandort (nur Tests und Demos)
  • ✓ Partner-Dashboard ab Ihrer ersten Anmeldung nach der Freigabe sowie Schritt-für-Schritt-Checklisten für die Bereitstellung

Verwandeln Sie Ihr Ruckus Gäste-WLAN in eine Marketingmaschine

Starten Sie eine kostenlose 30-tägige Testphase oder sehen Sie sich zuerst eine Live-Demo an.