UniFi: Leitfaden zur Einrichtung des Captive Portals mit E-Mail-Erfassung über CaptiFi
Warum Sie Ihr UniFi-Netzwerk um ein Captive Portal ergänzen sollten
Gäste verbinden sich mit Ihrem WLAN, und damit endet die Beziehung. Sie wissen nicht, wer sie waren, ob sie wiedergekommen sind oder wie Sie sie erreichen. Ein Captive Portal schaltet der Verbindung eine Anmeldeseite in Ihrem Design vor, sodass jeder Gast, der online geht, Ihnen eine E-Mail-Adresse gibt, mit einem Marketing-Opt-in, das vom WLAN selbst getrennt bleibt. Von da an laufen die Folgekontakte von selbst über die WLAN-Marketing-Software von CaptiFi: eine Willkommens-E-Mail, eine Google-Bewertungsanfrage nach dem Besuch und eine Rückgewinnungs-E-Mail, wenn ein Gast länger nicht mehr da war.
UniFi hat ein eigenes Hotspot-Portal. Das Hilfecenter von Ubiquiti nennt ein Passwort, Voucher, Facebook, RADIUS, Zahlung über Stripe und eine Option External Portal Server für Portale von Drittanbietern. Ein Formular zur E-Mail-Anmeldung, Marketing-E-Mails, Einwilligungsnachweise oder Bewertungsanfragen nennt es nicht. CaptiFi dockt an die Option External Portal Server der UniFi-Installation an, die Sie bereits besitzen, und ergänzt diese Ebene. Da das Portal auf dem Controller konfiguriert wird, ändert sich an Ihren Access Points nichts.
Konsolen und Access Points, die funktionieren
CaptiFi verbindet sich mit dem UniFi-Controller, das Modell des Access Points spielt also keine Rolle. U7, U6 und die älteren UAP-AC-Modelle liefern alle dieselbe Anmeldeseite aus. Worauf es ankommt, ist die Konsole, auf der der Controller läuft, und CaptiFi unterstützt sie alle:
- UniFi Dream Machine: UDM, UDM Pro und UDM SE
- UniFi Cloud Gateway: UCG Ultra und UCG Max
- Dream Router und UniFi Express
- Cloud Key und Cloud Key Gen2 (einschließlich Gen2 Plus)
- Eine selbst gehostete UniFi-Network-Anwendung auf Ihrem eigenen Rechner, Ihrer VM oder Ihrem Server, einschließlich UniFi OS Server unter Windows
Der Controller braucht UniFi Network 6 oder neuer. Wenn Sie den Controller lieber gar nicht anfassen möchten, ist die Alternative das Plug-and-Play-Gerät, das CaptiFi Ihnen gegen eine erstattungsfähige Kaution zuschickt und das neben Ihrem UniFi-WLAN ein eigenes Gästenetzwerk ausstrahlt. Beide Wege führen in dasselbe Dashboard.
Bevor Sie beginnen
Sie brauchen vier Dinge: Administratorzugriff auf den UniFi-Controller, ein CaptiFi-Konto (die 30-tägige Testphase genügt, zum Start hinterlegen Sie eine Karte), ein paar Minuten vor Ort oder Fernzugriff auf die Konsole und zwei Werte, die exakt wie angegeben eingegeben werden. Die Verbindungsadresse von CaptiFi lautet 46.62.168.7 und die Portal-Domain site.app.captifi.io. Ein einziges falsches Zeichen verhindert, dass die Anmeldeseite erscheint, und der Fehler bleibt ohne Meldung, kopieren Sie die Werte also und fügen Sie sie ein.
Wenn Sie sich heute registriert haben, führt Sie der Onboarding-Assistent auf my.captifi.io durch dieselben Schritte und hält bei jedem an. Diese Anleitung ist die ausführliche Fassung, mit jeder Hardware-Variante und allem, was schiefgehen kann. In der Kundendokumentation finden Sie dieselbe Anleitung mit Screenshots jedes Bildschirms.
Schritt 1: Wählen, wie CaptiFi Ihren Controller erreicht
CaptiFi muss mit Ihrem Controller kommunizieren, um die Portal-Einstellungen zu schreiben und jeden Gast zu autorisieren, der die Anmeldeseite abschließt. Diesen Zugriff können Sie auf drei Wegen geben. Wählen Sie die Zeile, die zu Ihrer Situation passt.
| Ihre Situation | Ihr Weg |
|---|---|
| Ihre Konsole hat eine öffentliche IP, oder Sie können eine Firewall-Regel oder eine Portweiterleitung einrichten | Weg A, API-Schlüssel. Der einfachste und sicherste Weg, und der, dem diese Anleitung folgt. |
| Ihre Konsole sitzt hinter einem anderen Router, Ihr Internetanbieter nutzt CGNAT, oder Sie können keine Portweiterleitung einrichten | Weg B, Remote Tunnel. Ihre Konsole baut die Verbindung zu CaptiFi von sich aus auf, es sind also gar keine eingehenden Ports nötig. |
| Ihre UniFi Network-Version ist zu alt für API-Schlüssel, und die Konsole ist aus dem Internet erreichbar | Weg C, Benutzername und Passwort. Ein lokales Administratorkonto auf dem Controller. |
Sie sind nicht sicher, ob Ihre Konsole API-Schlüssel erstellen kann? Öffnen Sie die UniFi Network-Anwendung, gehen Sie zu Settings, dann Control Plane, und suchen Sie nach Integrations. Neuere Versionen verlegen Integrations in das linke Menü, prüfen Sie also beide Stellen. Wenn es an keiner davon steht, aktualisieren Sie zuerst UniFi Network und weichen Sie nur dann auf Weg C aus, wenn das Update nicht möglich ist.
Für Weg B sind die typischen Anzeichen ein Banner „Upstream NAT detected on WAN1“ in der UniFi-App, eine WAN-Adresse, die mit 10., 192.168. oder 172.16. bis 172.31. beginnt, ein Modem-Router-Kombigerät Ihres Internetanbieters vor Ihrem Gateway oder ein 4G-, 5G- oder CGNAT-Glasfaseranschluss. Wenn eines davon zutrifft, überspringen Sie Schritt 3 und lesen Sie die Hinweise zum Remote Tunnel in Schritt 4.
Schritt 2: UniFi-API-Schlüssel erstellen
- Gehen Sie in der UniFi Network-Anwendung zu Settings, dann Control Plane, dann Integrations
- Geben Sie einen Namen ein, den Sie später wiedererkennen, zum Beispiel
CaptiFi - Stellen Sie die Rolle oder Zugriffsstufe auf Full Control
- Stellen Sie den Ablauf auf Never expires, sofern Ihre eigenen Richtlinien nichts anderes vorgeben
- Klicken Sie auf Create API Key und kopieren Sie den Schlüssel sofort
UniFi zeigt den Schlüssel genau einmal an. Wenn Sie den Dialog schließen, ohne ihn zu kopieren, löschen Sie diesen Schlüssel und erstellen Sie einen neuen. Ein bestehender Schlüssel lässt sich nicht wieder auslesen. Full Control ist erforderlich, weil CaptiFi Gästegeräte autorisieren und Ihre WLAN-Netzwerke auslesen muss. Ein Schlüssel mit reinem Lesezugriff verbindet sich und scheitert dann in dem Moment, in dem der erste Gast sich anmelden will.
Ein API-Schlüssel ist einem Controller-Login in zwei Punkten überlegen. Sie können ihn jederzeit in UniFi widerrufen, ohne ein Passwort zu ändern, und die Multi-Faktor-Authentifizierung Ihres Ubiquiti-Kontos steht nicht im Weg. Ein Schlüssel deckt außerdem jede Site auf dem Controller ab.
Schritt 3: CaptiFi den Zugriff auf Ihre Konsole erlauben
CaptiFi verbindet sich nur von einer Adresse aus mit Ihrem Controller, 46.62.168.7. Wie Sie das freigeben, hängt von der Hardware ab.
Dream Machine, Cloud Gateway, Dream Router oder UniFi Express
Auf diesen Konsolen läuft der Controller auf dem Gateway selbst, Sie brauchen also eine Firewall-Regel und keine Portweiterleitung (eine Portweiterleitung schickt den Verkehr an ein Gerät hinter dem Gateway, und dort sitzt der Controller nicht).
- Gehen Sie zu Settings, dann Policy Engine (Firewall & Security bei älterer Firmware), öffnen Sie den Object Manager und erstellen Sie eine Portgruppe namens
Captifimit den Ports 80 und 443 - Öffnen Sie, weiterhin in der Policy Engine, Firewall Rules, klicken Sie auf Create Entry und stellen Sie den Regeltyp auf Advanced
- Stellen Sie den Typ auf Internet Local, die Aktion auf Accept und das Protokoll auf All, setzen Sie das Häkchen bei Before Predefined, stellen Sie die Quelle auf Any und das Zielport-Objekt auf die Gruppe Captifi
- Speichern Sie die Regel
Internet Local ist der Teil, der oft übersehen wird. UniFi teilt eingehenden Verkehr in Internet In (an Geräte in Ihrem LAN) und Internet Local (an das Gateway selbst). Ihr Controller sitzt auf dem Gateway, der Verkehr von CaptiFi ist also Internet Local. Die Beschränkung auf die Portgruppe öffnet nur die Ports 80 und 443, und nur zum Gateway. Bei älterer Firmware mit Zonen lautet dieselbe Regel: Quellzone External, Zielzone Gateway, Zielport die Gruppe Captifi, Aktion Allow. Die Regel gilt für IPv4. Wenn Ihr Standort auch IPv6 nutzt, fügen Sie eine entsprechende IPv6-Regel hinzu oder stellen Sie sicher, dass der Controller über IPv4 erreicht wird.
Cloud Key oder Cloud Key Gen2
Ein Cloud Key ist ein eigenes Gerät in Ihrem LAN, hier handelt es sich also um eine normale Portweiterleitung auf dem Router, der davor sitzt: externer Port 8443 auf die IP des Cloud Key, interner Port 8443, Protokoll TCP. Wenn ein Router Ihres Internetanbieters davor sitzt, den Sie nicht verwalten, nutzen Sie stattdessen den Remote Tunnel. Die meisten Cloud Keys können ihn inzwischen ausführen, und das Installationsprogramm meldet, wenn Ihrer es nicht kann.
Selbst gehosteter Controller
Stellen Sie sicher, dass Port 8443 (oder der Port, auf dem Ihr Controller lauscht) aus dem Internet erreichbar ist, und beschränken Sie dann den eingehenden Zugriff auf diesem Port ausschließlich auf 46.62.168.7. Sie müssen den Controller nicht für das gesamte Internet öffnen und sollten es auch nicht tun. Geben Sie den Controller als IPv4-Adresse ein oder als Hostnamen, der nur einen A-Record hat. Sie können auch einen beliebigen freien externen Port weiterleiten, zum Beispiel 7443, und CaptiFi die Adresse mit diesem Port nennen, etwa unifi.example.com:7443. Der Remote Tunnel steht für selbst gehostete Controller nicht zur Verfügung, deshalb ist diese Beschränkung auf eine einzige Adresse der Weg, einen solchen Controller privat zu halten.
Prüfen, ob es funktioniert hat
Tun Sie das von außerhalb Ihres Netzwerks, zum Beispiel auf Ihrem Smartphone mit ausgeschaltetem WLAN. Ermitteln Sie die öffentliche IP des Standorts und rufen Sie dann https://YOUR_PUBLIC_IP für eine Dream Machine oder ein UCG auf, oder https://YOUR_PUBLIC_IP:8443 für einen Cloud Key oder einen selbst gehosteten Controller. Sie sollten die UniFi-Anmeldeseite sehen. Eine Zertifikatswarnung des Browsers ist hier normal, weil der Controller ein selbstsigniertes Zertifikat verwendet. Wenn nichts lädt und die WAN-Adresse des Gateways eine private IP ist, befinden Sie sich hinter doppeltem NAT: Nutzen Sie den Remote Tunnel.
Schritt 4: Controller in CaptiFi verbinden
Wenn Sie noch im Onboarding sind, fragt der Assistent nach drei Dingen: einem Controller-Namen für Ihre eigene Übersicht, der Controller-URL (die öffentliche Adresse oder der Hostname, den Sie in Schritt 3 getestet haben; CaptiFi ergänzt https:// und findet den Port, Sie geben also nur dann einen Port ein, wenn Sie einen eigenen weitergeleitet haben) und dem API-Schlüssel aus Schritt 2. Klicken Sie auf Controller verbinden. CaptiFi prüft die Adresse, meldet sich mit dem Schlüssel an und erkennt Ihre UniFi-Sites.
Wenn Ihr Konto bereits eingerichtet ist, melden Sie sich bei my.captifi.io an, gehen Sie zu Meine Standorte und klicken Sie auf Standort hinzufügen. Wählen Sie Ubiquiti UniFi, benennen Sie den Standort, legen Sie Typ und Zeitzone fest, wählen Sie dann Direkte Verbindung für Weg A oder Remote Tunnel für Weg B und klicken Sie auf Standort hinzufügen. Der Assistent verbindet anschließend den Controller: Beim Remote Tunnel fragt er nach Ihrem API-Schlüssel, bei der direkten Verbindung nach der Controller-Adresse sowie Benutzername und Passwort eines lokalen Administrators. Um einen Standort mit direkter Verbindung auf den Schlüssel aus Schritt 2 umzustellen, öffnen Sie auf der Standortkarte den Verbindungsstatus, wählen Sie Verbindung aktualisieren und dann Stattdessen einen API-Schlüssel verwenden.
Jeder Tarif enthält einen Standort, und ab Essentials wird jeder zusätzliche Standort zum Preis für zusätzliche Standorte berechnet, £25 pro Monat in GBP, ab dem Tag, an dem Sie ihn hinzufügen, und anteilig bis zu Ihrem Abrechnungsdatum. Wenn der Controller mehrere UniFi-Sites hostet, wählen Sie im Dropdown Controller-Site die richtige aus, bevor Sie fortfahren: Jede UniFi-Site entspricht einem CaptiFi-Standort, und CaptiFi kann die Wahl nicht für Sie treffen. Ein API-Schlüssel deckt jede Site auf dem Controller ab, diese Standorte teilen sich also eine einzige Verbindung, und ein Wechsel des Schlüssels ändert die Verbindung für alle.
Wenn Sie den Remote Tunnel gewählt haben
Der Installationsbefehl gilt nur für Ihren Standort und erscheint im Assistenten im Schritt Tunnel installieren. Für einen Standort, der bereits in CaptiFi angelegt ist, schreiben Sie an hello@captifi.io, und wir senden Ihnen den Befehl für Ihren Standort. Schalten Sie SSH in UniFi OS unter Settings, Control Plane, Console ein, legen Sie ein SSH-Passwort fest, verbinden Sie sich mit ssh root@YOUR-CONSOLE-IP, fügen Sie den Befehl ein und warten Sie etwa 30 Sekunden. Die Verbindung ist ausschließlich ausgehend, sie funktioniert also hinter beliebig vielen Routern und baut sich nach einem Neustart oder einem Stromausfall von selbst wieder auf. Über den Tunnel verbundene Konsolen authentifizieren sich allein mit dem API-Schlüssel. Das Banner „Upstream NAT detected“ bleibt in der UniFi-App stehen, und das ist in Ordnung. Stellen Sie den Router Ihres Internetanbieters nicht auf Bridge-Modus um, nur damit es verschwindet. Behandeln Sie den Befehl wie ein Passwort: Er enthält ein Token, das an genau diesen einen Standort gebunden ist.
Wenn Sie den Weg über Benutzername und Passwort nutzen
Erstellen Sie auf dem Controller ein eigenes lokales Konto (Local Access Only unter UniFi OS, Local admin only auf einem Cloud Key oder einem selbst gehosteten Controller) mit der Rolle Administrator, die CaptiFi braucht, um Gäste zu autorisieren. Ihr Ubiquiti-Cloud-Login funktioniert nicht, weil für ein ui.com-Konto immer Multi-Faktor-Authentifizierung erzwungen wird und CaptiFi diese Abfrage nicht abschließen kann. Ein lokales Konto mit Zwei-Faktor-Authentifizierung funktioniert dagegen: Setzen Sie bei der Anmeldung das Häkchen bei 2FA, und CaptiFi fragt nach dem sechsstelligen Code.
Schritt 5: Gäste-WLAN auswählen
CaptiFi listet nun jedes WLAN auf Ihrem Controller auf, jeweils mit der Zahl der Geräte darin, damit Sie angeben können, zu welchem die Anmeldeseite gehört. Der Bildschirm heißt im Assistenten „Live gehen“ und „WLAN-Netzwerk“, wenn Sie später über die Standortkarte dorthin zurückkehren.
- Wählen Sie Ihr Gästenetzwerk, kein privates Netzwerk und keines für Mitarbeiter. Jedes Gerät im gewählten Netzwerk muss die Anmeldeseite abschließen, und die Gerätezahlen helfen Ihnen zu erkennen, in welchem Netzwerk Ihre eigenen Geräte hängen
- Oder wählen Sie Neues Gästenetzwerk erstellen, geben Sie einen Namen ein, und CaptiFi legt auf allen Ihren Access Points ein offenes Gästenetzwerk an
- Klicken Sie auf Live gehen (oder Anwenden)
CaptiFi schaltet die Anmeldeseite vor das gewählte Netzwerk und entfernt sie von jedem anderen Netzwerk, in dem sie aktiv war, damit ein privates Netzwerk nie versehentlich hinter dem Portal bleibt. Wenn Sie ein bestehendes Netzwerk gewählt haben, schaltet CaptiFi die Anmeldeseite vor dieses Netzwerk, so wie es ist, und Ihre Sitzungsdauer und etwaige Geschwindigkeitslimits bleiben wie konfiguriert. Das Netzwerk mit Anmeldeseite können Sie später jederzeit wechseln.
Auf Gateways mit zonenbasierter Firewall (neuere Dream Machines, UCG und EFG) folgt die Anmeldeseite der Hotspot-Zone. Gehen Sie zu Settings, dann Policy Engine, dann Zones, und stellen Sie sicher, dass das Netzwerk, das Ihr Gäste-WLAN nutzt, in der Hotspot-Zone liegt und sonst nichts. CaptiFi meldet nach dem Anwenden, ob die Zone Ihre Aufmerksamkeit braucht, und nennt die Einstellung, die zu ändern ist.
Schritt 6: Hotspot-Portal von Hand konfigurieren (nur bei Bedarf)
Überspringen Sie diesen Schritt, wenn CaptiFi über einen API-Schlüssel oder den Remote Tunnel verbunden ist. Es schreibt diese Einstellungen für Sie und schreibt sie erneut, wann immer Sie Einstellungen erneut anwenden nutzen. Sie brauchen diesen Schritt nur, wenn CaptiFi nicht auf Ihren Controller schreiben kann, was bei mancher älteren Firmware und manchen stark abgesicherten, selbst gehosteten Installationen vorkommt.
- Gehen Sie in UniFi zu Settings, dann WiFi, und erstellen oder öffnen Sie Ihr Gäste-WLAN. Stellen Sie die Sicherheit auf Open ohne Passwort und weisen Sie es Ihrem Gästenetzwerk zu
- Schalten Sie im selben WLAN Hotspot Portal ein und stellen Sie Authentication auf External Portal Server
- Tragen Sie das Portal von CaptiFi ein: IPv4-Adresse
46.62.168.7, Domainsite.app.captifi.io - Fügen Sie unter Pre-Authorization Access (dem Walled Garden)
site.app.captifi.io,app.captifi.io,fonts.googleapis.comundfonts.gstatic.comhinzu, dazu*.captifi.io, wenn Ihre Firmware Wildcards akzeptiert. Fehlt einer, lädt die Seite nur halb oder auf iPhones gar nicht - Fügen Sie unter Post-Authorization Restrictions
192.168.0.0/16,172.16.0.0/12und10.0.0.0/8hinzu, damit Gäste Ihr eigenes Netzwerk nicht erreichen, sobald sie online sind - Setzen Sie in den Einstellungen der Landing Page die Häkchen bei Show Landing Page, HTTPS Redirection Support, Encrypted URL und Secure Portal und stellen Sie die Domain auf
site.app.captifi.io - Schalten Sie im Hotspot-Portal Password, Voucher, Facebook, Payment und RADIUS aus, damit allein CaptiFi Gäste autorisiert, und lassen Sie die eigene Portal-Anpassung von UniFi unangetastet
- Klicken Sie auf Apply Changes
Wenn Sie WLAN-Zugang über CaptiFi verkaufen, müssen auch Ihre Stripe- und Wallet-Zahlungsdomains in der Vorautorisierungsliste stehen. Wenden Sie sich an den Support, um die aktuelle Liste zu bestätigen.
Schritt 7: Mit einem Smartphone testen
Kümmern Sie sich zuerst um die Geräte, die sich nicht anmelden können. Bondrucker, Kartenterminals, iPads im Backoffice, Musikplayer und Digital Signage können keine Anmeldeseite anzeigen und verlieren deshalb, sobald das Portal live ist, beim nächsten Neuverbinden den Internetzugang. Verlegen Sie sie entweder in ein privates, passwortgeschütztes Mitarbeiternetzwerk, das ist die sauberste Lösung, oder tragen Sie ihre MAC-Adressen auf der Standortkarte unter Vorautorisierte Geräte ein.
- Schalten Sie auf einem Smartphone das WLAN aus und wieder ein und verbinden Sie sich dann mit dem Gästenetzwerk
- Ihre CaptiFi-Seite sollte innerhalb weniger Sekunden von selbst erscheinen. Wenn nicht, öffnen Sie einen Browser und rufen Sie eine beliebige http://-Seite auf, zum Beispiel
http://neverssl.com - Füllen Sie das Formular aus und prüfen Sie, ob das Smartphone normal surfen kann
- Öffnen Sie Gästebesuche in Ihrem CaptiFi-Dashboard: Der Besuch sollte innerhalb einer Minute aufgeführt sein
Das Portal greift nach und nach. Bereits verbundene Geräte funktionieren weiter, bis sie sich neu verbinden, und die Anmeldeseite erscheint für jedes Gerät, sobald es dem Netzwerk wieder beitritt. Eine vollständige Umstellung kann deshalb einen Tag dauern.
Nach der Einrichtung: die Verbindung stabil halten
Alles befindet sich auf der Standortkarte unter Meine Standorte auf my.captifi.io. Der Verbindungsstatus zeigt drei Dinge und aktualisiert sich, solange er geöffnet ist: Online bedeutet, dass CaptiFi eine verifizierte Route zum Controller hat. Controller sendet RADIUS-Verkehr wird gelb und zeigt STALE, wenn 15 Minuten lang nichts eingegangen ist, was bei einem Standort, der geschlossen ist oder an dem keine Gäste verbunden sind, normal ist. Und Gäste verbinden sich über die Splash-Seite zählt die Anmeldungen. Ein Standort mit Gästen und einer Zeile mit STALE ist ein Support-Ticket wert, und wenn Sie die genaue Meldung angeben (sie enthält die eigene Antwort des Controllers, zum Beispiel einen api.err-Code), ist das Problem meist in einem Schritt gelöst.
Controller umgezogen, Port geändert oder API-Schlüssel ersetzt? Klicken Sie auf Verbindung aktualisieren. Ihre aktuelle Verbindung funktioniert weiter, bis die neue verifiziert ist, das Gäste-WLAN wird also nie unterbrochen. Wenn der Controller auf Werkseinstellungen zurückgesetzt wurde oder Gäste plötzlich die eigene Seite von UniFi statt Ihrer sehen, klicken Sie auf Einstellungen erneut anwenden: Das überträgt das Captive Portal von CaptiFi, die Vorautorisierungsliste und etwaige Geschwindigkeitslimits erneut, legt das Gästenetzwerk nur dann neu an, wenn es fehlt, und trennt keine Gäste, die bereits online sind. Es ersetzt die gesamte Portal-Konfiguration, jeder Walled-Garden-Eintrag, den Sie direkt in UniFi hinzugefügt haben, wird also zurückgesetzt. Um die Anmeldeseite in ein anderes Netzwerk zu verlegen, klicken Sie auf WLAN-Netzwerk und wählen Sie erneut. Vorautorisierte Geräte nimmt eine MAC-Adresse und eine optionale Bezeichnung entgegen, autorisiert das Gerät sofort auf dem Controller, erneuert die Autorisierung jede Nacht, damit sie Neustarts des Controllers übersteht, und hebt sie auf, wenn das Gerät entfernt wird.
Was CaptiFi bei UniFi ergänzt
| Funktion | UniFi-Hotspot-Portal allein | UniFi mit CaptiFi |
|---|---|---|
| So melden sich Gäste an | Passwort, Voucher, Facebook, RADIUS, Stripe-Zahlung oder ein externes Portal | E-Mail-Anmeldeformular auf der Seite von CaptiFi, über die UniFi-Option External Portal Server |
| Gast-E-Mail-Erfassung | In der Hotspot-Hilfe von Ubiquiti ist kein Formular zur E-Mail-Anmeldung aufgeführt | Jede Anmeldung mit Einwilligung erfasst, als CSV exportierbar |
| Anmeldeseite im eigenen Design | Die eigene Portal-Anpassung von UniFi | Splash-Seiten-Editor mit Drag-and-drop, ein Design pro Standort |
| Willkommens-E-Mail | In der Hotspot-Hilfe von Ubiquiti nicht behandelt | Ab Essentials, Versand beim Verbinden, aus einer Vorlage oder Ihrer eigenen Automatisierung |
| Google-Bewertungsanfragen | In der Hotspot-Hilfe von Ubiquiti nicht behandelt | Zeitlich abgestimmt nach dem Besuch, ab Essentials |
| Rückgewinnungskampagnen | In der Hotspot-Hilfe von Ubiquiti nicht behandelt | Automatisierungen für Gäste, die nicht wiedergekommen sind |
| Besuchserfassung | In der Hotspot-Hilfe von Ubiquiti nicht behandelt | Besuchsverlauf und Wiederkehrrate je Gast |
| Mehrere Standorte | Je Site im Controller | Ein Dashboard, ein API-Schlüssel pro Controller, Splash-Designs je Standort |
| Einwilligung und Prüfpfad | In der Hotspot-Hilfe von Ubiquiti nicht behandelt | Separates Marketing-Opt-in, Link zum Datenschutzhinweis und ein Nachweis der Einwilligung |
In den Daten der CaptiFi-Betriebe haben sich 55% der neuen Geräte, die sich im September 2026 mit einem CaptiFi-Gäste-WLAN verbunden haben, angemeldet, und ein typischer Betrieb gewann von April bis September rund 50 neue Gäste-E-Mail-Adressen pro Monat (350 oder mehr beim meistbesuchten Zehntel der Betriebe). Essentials gibt es ab £49/Monat, angezeigt in Ihrer Währung auf der Preisseite, das CaptiFi-Gerät ist gegen eine erstattungsfähige Kaution erhältlich, und jeder Tarif beginnt mit einer 30-tägigen Testphase (zum Start hinterlegen Sie eine Karte). Wenn Sie auf der Hardware, die Sie bereits betreiben, nur Gästeerfassung und CSV-Export möchten, kostet Lite £19.99/Monat für einen Standort. Dasselbe Muster mit externem Portal funktioniert auf TP-Link Omada, Cisco Meraki, Aruba Instant On, MikroTik und Ruckus, eine Gruppe mit gemischter Hardware steuert also alles über ein Konto.
Fehlerbehebung
| Problem | Was zu tun ist |
|---|---|
| Anmeldeseite erscheint nie | Prüfen Sie, ob das Hotspot-Portal eingeschaltet ist und die Adresse des externen Portals exakt 46.62.168.7 lautet. Prüfen Sie auf neueren Konsolen auch die Hotspot-Zone |
| Keine Anmeldeseite und kein Internet im Gästenetzwerk | Auf Konsolen mit zonenbasierter Firewall folgt die Anmeldeseite der Hotspot-Zone. Gehen Sie zu Settings, Policy Engine, Zones und legen Sie das Gästenetzwerk in die Hotspot-Zone |
| Anmeldeseite erscheint in einem privaten, passwortgeschützten Netzwerk | Dieses Netzwerk liegt in der Hotspot-Zone oder ist auf den Netzwerktyp Guest gestellt. Verschieben Sie es zurück in die Zone Internal |
| „Portal unreachable“ | Fügen Sie site.app.captifi.io zu Pre-Authorization Access hinzu |
| Gäste melden sich an, bekommen aber kein Internet | Prüfen Sie, ob die Domain in den Einstellungen der Landing Page auf site.app.captifi.io steht |
| Seite lädt ohne Schriftarten oder Bilder oder bleibt auf dem iPhone leer | Ein Vorautorisierungseintrag fehlt. Prüfen Sie jeden Eintrag in Schritt 6, einschließlich der beiden Schriftarten-Domains |
| Browser warnt auf der Anmeldeseite vor dem Zertifikat | Aktivieren Sie HTTPS Redirection Support und Secure Portal in den Einstellungen der Landing Page |
| Controller verbindet sich nicht | Testen Sie von außerhalb Ihres Netzwerks über mobile Daten. Ist die WAN-Adresse privat, befinden Sie sich hinter doppeltem NAT: Nutzen Sie den Remote Tunnel |
| „Invalid credentials“ oder „Could not sign in to your UniFi controller. Check the username and password and try again.“, obwohl die Angaben stimmen | Sie verwenden einen Ubiquiti-Cloud-Login, dessen erzwungene Multi-Faktor-Authentifizierung CaptiFi nicht abschließen kann. Verwenden Sie einen API-Schlüssel oder ein lokales Controller-Konto |
| API-Schlüssel abgelehnt | Prüfen Sie die UniFi Network-Version, ob die Rolle des Schlüssels Full Control ist und ob er nicht abgelaufen ist. Schlüssel werden nur einmal angezeigt, erstellen Sie im Zweifel also einen neuen |
| Firewall-Regel scheint auf einer UDM nichts zu bewirken | Das Ziel muss das Gateway selbst sein: Regeltyp Internet Local oder Zielzone Gateway, mit einer Portgruppe, die 80 und 443 enthält |
| iPhone zeigt „Cannot Verify Server Identity“ | Das Gerät befindet sich noch hinter dem Portal. Öffnen Sie die WLAN-Anmeldeseite und schließen Sie sie ab, oder verbinden Sie sich erneut mit dem Netzwerk |
UniFi-Installationen unterscheiden sich je nach Hardware und Firmware-Version. Wenn ein Bildschirm nicht so aussieht wie hier beschrieben, schreiben Sie an hello@captifi.io und nennen Sie das Konsolenmodell und die UniFi Network-Version, dann zeigen wir Ihnen die richtige Einstellung.
Quellen: Ubiquiti, UniFi-Hotspot-Portal und Gäste-WLAN, gelesen am 28. Oktober 2026, für die Anmeldeoptionen, die das eigene Portal von UniFi bietet. Die CaptiFi-Schritte folgen der UniFi-Einrichtungsanleitung. Ubiquiti, UniFi und die anderen hier genannten Produktnamen sind Marken ihrer Inhaber. CaptiFi ist weder mit ihnen verbunden noch wird es von ihnen empfohlen.
Erfassen Sie ab sofort Gäste-E-Mail-Adressen über Ihr UniFi-WLAN
30-tägige Testphase, zum Start hinterlegen Sie eine Karte. Funktioniert mit jeder UniFi-Konsole und jedem UniFi-Access-Point oder mit dem Plug-and-Play-Gerät gegen eine erstattungsfähige Kaution, in jedem Tarif.
Kostenlos testenCaptiFi ist eine Plattform für Gäste-WLAN-Marketing und Captive Portal für Restaurants, Bars, Pubs, Cafés, Hotels, Fitnessstudios, Salons, den Einzelhandel und Kurzzeitvermietungen, entwickelt von CaptiFi Ltd im Vereinigten Königreich und in GBP, USD, EUR, CAD, AUD und NZD an Betriebe weltweit verkauft.
Häufig gestellte Fragen
Schnelle Antworten auf die häufigsten Fragen zu diesem Thema.
Was kann das eigene Hotspot-Portal von UniFi ohne CaptiFi?
Wie lange dauert die Einrichtung eines UniFi-Captive-Portals mit CaptiFi?
Welche UniFi-Controller und Access Points funktionieren mit CaptiFi?
Brauche ich einen RADIUS-Server für ein UniFi-Captive-Portal?
Was, wenn meine UniFi-Konsole hinter einem anderen Router oder an einem CGNAT-Anschluss hängt?
Was trage ich ein, wenn ich das UniFi-Hotspot-Portal von Hand konfiguriere?
Verlieren Kartenterminals und Drucker den Internetzugang, sobald das Portal live ist?
Kann ich mehrere UniFi-Sites mit einem CaptiFi-Konto betreiben?
Das CaptiFi-Redaktionsteam schreibt über Gäste-WLAN-Marketing, Captive Portals, DSGVO-konforme Datenerfassung und lokale SEO für Betreiber gastorientierter Betriebe. Wenn wir CaptiFi mit einer anderen Plattform vergleichen, nutzen wir die eigene Website dieses Unternehmens und nennen das Datum, an dem wir sie geprüft haben.
Bereit, Ihr Gäste-WLAN in einen Marketingmotor zu verwandeln?
CaptiFi erfasst Kundendaten bei jeder WLAN-Anmeldung, automatisiert Google-Bewertungen und Follow-up-E-Mails und lässt sich mit den Tools verbinden, die Sie bereits nutzen. Das CaptiFi-Gerät ist in jedem Tarif gegen eine erstattungsfähige Kaution enthalten, die Preise stehen auf der Preisseite, und jeder Tarif hat eine 30-tägige kostenlose Testphase.