Zum Hauptinhalt springen
Setup-Leitfaden

Ubiquiti UniFi Captive Portal
Einrichtungsanleitung

Ergänzen Sie Ihr UniFi-Gäste-WLAN mit CaptiFi um ein gebrandetes Captive Portal: Erfassen Sie die E-Mail-Adressen Ihrer Gäste bei der Anmeldung, automatisieren Sie Google-Bewertungen und lassen Sie Ihr Marketing automatisch laufen. Funktioniert mit jedem UniFi-Access-Point.

📋 Bevor Sie beginnen, stellen Sie sicher, dass Sie Folgendes haben:
• Eine laufende UniFi Network Application (UDM, UDM Pro, Cloud Key oder selbst gehostet)
• Ein CaptiFi-Konto - hier erstellen
• Administratorzugriff auf diesen Controller mit UniFi Network 6 oder neuer
🔍 Sie sind nicht sicher, welche UniFi-Hardware bereits vor Ort ist? Unser kostenloser UniFi Device Scanner findet jedes Ubiquiti-Gerät im Netzwerk und adoptiert es mit wenigen Klicks in Ihren Controller (Mac & Windows).

Einrichten im Assistenten

Wählen Sie UniFi im Einrichtungsassistenten in Ihrem CaptiFi-Dashboard unter my.captifi.io. Der Assistent bietet drei Möglichkeiten, eine UniFi-Konsole zu verbinden: Controller-Anmeldung, einen API-Schlüssel oder den Remote Tunnel für Konsolen hinter einem anderen Router. Wenn CaptiFi keine Verbindung herstellen kann, nennt der Assistent die Ursache und bietet direkt unter der Meldung den Remote Tunnel oder ein CaptiFi-Gerät an. Die Ursache ist eine von dreien: Die Konsole war aus dem Internet nicht erreichbar, sie antwortete, aber nicht als UniFi-Konsole mit der Integration API, oder sie lehnte den API-Schlüssel ab. Für den Remote Tunnel zeigt er den einzeiligen Installationsbefehl für Ihre Konsole, teilt Ihnen mit, wann der Tunnel steht, nimmt Ihren lokalen API-Schlüssel entgegen und lässt Sie das WLAN-Netzwerk auswählen, auf dem die Anmeldeseite erscheinen soll.

1 Einrichtung in 3 Schritten im Überblick

Wenn sich CaptiFi über einen API-Schlüssel oder den Remote Tunnel verbindet, schreibt es die unten stehenden Captive-Portal-Einstellungen für Sie auf Ihren Controller und schreibt sie erneut, wann immer Sie Einstellungen erneut anwenden verwenden. Sie müssen sie nur von Hand vornehmen, wenn CaptiFi nicht auf Ihren Controller schreiben kann, was bei mancher älteren Firmware und einigen abgeschotteten selbst gehosteten Installationen vorkommt. Von Hand sind es drei Aufgaben:

Schritt 1 Erstellen Sie ein offenes Gäste-WLAN-Netzwerk in der UniFi Network Application.
Schritt 2 Aktivieren Sie das Hotspot-Portal, stellen Sie es auf External Portal Server und geben Sie die Portaladresse 46.62.168.7 und die Domain site.app.captifi.io von CaptiFi ein.
Schritt 3 Fügen Sie die CaptiFi-Domains zum Vorautorisierungszugriff hinzu, damit die Splash-Seite vor der Anmeldung lädt.
💡 UniFi betreibt weiterhin Ihr WLAN. CaptiFi ergänzt lediglich die gebrandete Splash-Seite, die E-Mail-Erfassung, die DSGVO-Einwilligung und die anschließende Marketing-Automatisierung.

Drei Möglichkeiten, eine UniFi-Konsole zu verbinden

CaptiFi muss mit Ihrem UniFi Controller kommunizieren, um Ihre Sites auszulesen und Gäste ins Internet zu lassen. Wählen Sie den Weg, der dazu passt, wo Ihre Konsole steht; die UniFi-Einrichtungsanleitung auf docs.captifi.io führt Klick für Klick durch jeden davon.

API-Schlüssel Für eine Konsole, die CaptiFi erreichen kann: Sie hat eine öffentliche IP, oder Sie können eine Firewall-Regel oder Portweiterleitung hinzufügen. CaptiFi authentifiziert sich mit einem Schlüssel, den Sie jederzeit in UniFi widerrufen können, und die Multi-Faktor-Authentifizierung Ihres Ubiquiti-Kontos steht dem nicht im Weg.
Remote Tunnel Für eine Konsole hinter einem anderen Router, bei einem Internetanbieter mit CGNAT oder hinter einem Router des Internetanbieters, den Sie nicht verwalten. Die Konsole baut über einen sicheren Tunnel eine ausgehende Verbindung zu CaptiFi auf, sodass es keine eingehenden Ports und keine Änderungen an Ihrem Router gibt. Cloud Key Gen2 und Gen2 Plus werden unterstützt. Sie fügen per SSH einen einzeiligen Installationsbefehl ein, warten etwa 30 Sekunden, und der Tunnel verbindet sich nach einem Neustart oder Stromausfall von selbst wieder.
Controller-Anmeldung Ein lokaler Benutzername mit Passwort, für eine UniFi Network-Version, die für API-Schlüssel zu alt ist, sofern die Konsole noch aus dem Internet erreichbar ist.
💡 Das Banner „Upstream NAT erkannt“ in der UniFi-App ist harmlos, sobald der Tunnel eingerichtet ist. Lassen Sie Ihren ISP-Router so, wie er ist.

2 Ein Gäste-WLAN-Netzwerk erstellen

Gehen Sie in der UniFi Network Application zu Einstellungen → WLAN und klicken Sie auf Neu erstellen:

Name Etwas, das Gäste wiedererkennen, zum Beispiel Free WiFi
Sicherheit Offen (das Captive Portal übernimmt die Anmeldung)
Netzwerk / VLAN Einem Gast-VLAN zuweisen, um den Datenverkehr zu isolieren (empfohlen)

3 Aktivieren Sie das externe Hotspot-Portal

Scrollen Sie, weiterhin in Ihren WLAN-Netzwerkeinstellungen, zu Hotspot Portal (in älteren Versionen heißt dies Settings → Guest Hotspot):

Hotspot-Portal Aktiviert
Portaltyp External Portal Server
IPv4-Adresse 46.62.168.7
Domäne site.app.captifi.io
⚠️ Übernehmen Sie beide Werte per Kopieren und Einfügen. Ein einziges falsches Zeichen verhindert, dass die Anmeldeseite jemals erscheint, und es gibt dabei keine Fehlermeldung.

Aktivieren Sie in den Einstellungen der Landingpage Landingpage anzeigen, HTTPS-Weiterleitungsunterstützung, Verschlüsselte URL und Sicheres Portal und setzen Sie die Domain auf site.app.captifi.io. Nur CaptiFi soll Gäste autorisieren, schalten Sie daher im Hotspot-Portal die UniFi-eigenen Methoden Passwort, Gutschein, Facebook, Zahlung und RADIUS aus.

💡 CaptiFi autorisiert Gäste über die UniFi Controller-API, nachdem sie die Splash-Seite abgeschlossen haben, sodass keine RADIUS-Konfiguration erforderlich ist.
Klicken Sie auf Änderungen anwenden, um zu speichern.

4 Die Vorautorisierungsdomänen hinzufügen

Fügen Sie CaptiFi zum Vorautorisierungszugriff (dem Walled Garden von UniFi) hinzu, damit die Splash-Seite geladen werden kann, bevor sich ein Gast anmeldet:

  • site.app.captifi.io
  • app.captifi.io
  • fonts.googleapis.com
  • fonts.gstatic.com
💡 Fügen Sie jede Domain zur Vorautorisierung hinzu und wenden Sie dann die Änderungen an.

5 Lösung testen

Verbinden Sie ein Smartphone mit Ihrem neuen Gäste-WLAN. Sie sollten auf Ihre gebrandete CaptiFi-Splash-Seite weitergeleitet werden. Geben Sie eine Test-E-Mail-Adresse ein, schließen Sie die Anmeldung ab und prüfen Sie, ob Sie ins Internet gelangen.

Prüfen Sie die Erfassung in Ihrem CaptiFi-Dashboard unter Gästebesuche.

✅ Ihr CaptiFi Captive Portal ist jetzt in Ihrem UniFi-Netzwerk live. Jeder Gast, der sich verbindet, sieht Ihre Anmeldeseite in Ihrem Design, und seine E-Mail-Adresse wird automatisch erfasst.
🧭 Möchten Sie die vollständige Anleitung? Die beiden folgenden Anleitungen behandeln Screenshots, die Verbindung über die UniFi-Controller-API und die Unterschiede zwischen UDM, Cloud Key und selbst gehosteten Controllern im Detail.

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

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 UniFi-Hardware Wenn Sie bereits UniFi-Access-Points und eine UniFi Network Application betreiben, folgen Sie den oben genannten Schritten. CaptiFi wird als externes Portal vorgeschaltet. Keine zusätzliche Hardware.
Nutzen Sie unser mitgeliefertes Plug-and-Play-Gerät Kein UniFi 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 ohne Konfiguration. Dieselbe Marketingplattform in beiden Fällen.

Lite: £19.99 pro Monat in Ihrem eigenen Netzwerk

Sie nutzen bereits UniFi? 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 UniFi Captive Portal

Funktioniert CaptiFi mit der UniFi Dream Machine?

Ja. CaptiFi funktioniert mit UDM, UDM Pro, UDM SE, Cloud Key Gen2 und selbst gehostetem UniFi Network Server sowie mit jedem UniFi-Access-Point, einschließlich der Serien U6 und U7.

Funktioniert CaptiFi mit UniFi hinter CGNAT oder Double NAT?

Ja. Wenn Ihre Konsole hinter einem anderen Router steht oder Ihr Internetanbieter CGNAT nutzt oder Ihnen einen Router stellt, den Sie nicht selbst verwalten, verwenden Sie den Remote Tunnel. Die Konsole baut über einen sicheren Tunnel eine ausgehende Verbindung zu CaptiFi auf, sodass keine eingehenden Ports oder Portweiterleitungen nötig sind, und Cloud Key Gen2 und Gen2 Plus können ihn ausführen. Der Einrichtungsassistent bietet ihn immer dann an, wenn CaptiFi Ihre Konsole nicht erreichen kann.

Brauche ich RADIUS, um CaptiFi mit UniFi zu verwenden?

Nein. CaptiFi autorisiert Gäste über die UniFi-Controller-API, nachdem sie die Splash-Seite abgeschlossen haben, sodass kein RADIUS-Server eingerichtet werden muss.

Warum lädt meine UniFi Splash-Seite nicht?

Fast immer fehlt in der Vorautorisierungsliste eine CaptiFi-Domain, oder das integrierte UniFi-Portal ist noch aktiv und verursacht eine Weiterleitungsschleife. Prüfen Sie, ob alle vier Domains hinzugefügt sind und nur das externe CaptiFi-Portal aktiviert ist.

Wird CaptiFi mein UniFi WLAN verlangsamen?

Nein. CaptiFi ist ein externer Dienst, der die Anmeldeseite betreibt. Sobald ein Gast angemeldet ist, läuft sein Datenverkehr direkt über Ihr UniFi-Netzwerk und nicht über CaptiFi.

Muss ich mein bestehendes UniFi-Netzwerk neu aufbauen?

Nein. Sie fügen ein offenes Gästenetzwerk hinzu und aktivieren das externe Portal darauf. Ihre bestehenden Geschäfts- und Mitarbeiternetzwerke bleiben unberührt.

Ist die E-Mail-Erfassung über das UniFi Gäste-WLAN mit CaptiFi DSGVO-konform?

CaptiFi fragt die Marketing-Einwilligung getrennt vom Internetzugang ab und speichert die Antwort jedes Gastes, und Gäste, die ablehnen, gelangen trotzdem in Ihr UniFi-WLAN. Jede Marketing-E-Mail enthält einen Abmeldelink, „Löschen (DSGVO)“ und „Anonymisieren (DSGVO)“ auf der Seite „Gästebesuche“ erledigen Löschanfragen, und die Auftragsverarbeitungsvereinbarung von CaptiFi ist veröffentlicht. Ihr Betrieb ist der Verantwortliche für die Daten, die Einhaltung der Vorschriften selbst bleibt daher bei Ihnen.

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

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

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