CaptiFi für Ihre Kunden bereitstellen
Schritt-für-Schritt-Checklisten für die Bereitstellung mit UniFi, Omada, Meraki und mehr. Bringen Sie Ihren ersten Kundenstandort in weniger als einer Stunde online.
Drei Bereitstellungswege
Bestehender Controller
Konfigurieren Sie CaptiFi als externes Captive Portal auf Ihrem bestehenden UniFi-, Omada-, Meraki- oder Aruba-Controller.
CaptiFi-Hardware
Schließen Sie unser vorkonfiguriertes Gerät an. Es verbindet sich mit jedem bestehenden Netzwerk. Kein Controller nötig. Mit dem CaptiFi-Gerät in etwa 5 Minuten live.
Partner-Hardware
Verwenden Sie Ihren eigenen kompatiblen Router oder AP. Konfigurieren Sie die externe Portal-Weiterleitung so, dass sie auf CaptiFi zeigt.
Master-Checkliste für die Bereitstellung
Schließen Sie jeden Punkt ab, bevor Sie den Standort als live markieren. Diese Checkliste gilt für alle Bereitstellungswege.
Firmenname, Adresse, Kontaktperson, E-Mail, Telefon
PNG, JPG oder WebP, mindestens 200×200px; ein PNG oder WebP mit transparentem Hintergrund funktioniert am besten.
Branding, Farben, Anmeldemethode, Links zu Nutzungsbedingungen/Datenschutz
UniFi, Omada, Meraki, Aruba, MikroTik, DrayTek oder CaptiFi Hardware
Nur dort, wo CaptiFi mit einem von Ihnen gehosteten Controller kommuniziert. UniFi über den Weg mit API-Schlüssel oder mit Benutzername und Passwort sowie ein Omada Controller vor Ort benötigen eine öffentliche IP oder einen Hostnamen sowie eine Firewall-Regel oder Portweiterleitung für HTTPS von CaptiFi. Bei einem Cisco Catalyst 9800 oder AireOS-Controller muss UDP 1700 (9800) oder 3799 (AireOS) für eingehende Verbindungen von CaptiFi geöffnet sein. Der UniFi Remote Tunnel, der kostenpflichtige Cloud-Based Controller von Omada und Meraki benötigen keinen eingehenden Zugriff, und das CaptiFi-Gerät benötigt weder eine statische IP noch eine Firewall-Änderung.
Separate SSID für Gäste, VLAN-Isolation vom Geschäftsnetzwerk
Externe Portal-Weiterleitung, die auf CaptiFi Splash-URL verweist
Verbinden Sie ein Smartphone/Tablet mit der Gast-SSID und prüfen Sie, ob die Splash-Seite lädt
Füllen Sie das Splash-Formular aus und prüfen Sie, ob E-Mail/Name im CaptiFi-Dashboard erscheinen
Nach dem Login sollte der Gast das Internet oder eine benutzerdefinierte Landingpage erreichen
Kunde zu Dashboard-Zugriff, Datenerfassung und Supportprozess eingewiesen
Plattformspezifische Leitfäden
Voraussetzungen
- UniFi Netzwerkanwendung läuft (selbstgehostet oder Cloud-Gateway)
- CaptiFi kann den Controller erreichen: über eine öffentliche IP mit Firewall-Regel oder Portweiterleitung oder über den Remote Tunnel auf einer UniFi-OS-Konsole, der keine eingehenden Ports benötigt
- Gastnetzwerk/SSID bereits erstellt
Konfigurationsschritte
- Öffnen Sie unter Settings → WiFi das Gästenetzwerk und scrollen Sie zu Hotspot Portal (ältere Versionen nennen dies Settings → Guest Hotspot)
- Setzen Sie Hotspot Portal auf Aktiviert und den Portaltyp auf External Portal Server
- Tragen Sie das Portal von CaptiFi ein: IPv4-Adresse 46.62.168.7 und Domain site.app.captifi.io. Bei Verbindungen über API-Schlüssel und Remote Tunnel schreibt CaptiFi diese Einstellungen für Sie
- Pre-Authorization Access konfigurieren - CaptiFi-Domains zum Walled Garden hinzufügen
- Aktivieren Sie in den Landingpage-Einstellungen Show Landing Page, HTTPS Redirection Support, Encrypted URL und Secure Portal
- Schalten Sie im Hotspot-Portal die UniFi-eigenen Methoden Passwort, Gutschein, Facebook, Zahlung und RADIUS aus: CaptiFi autorisiert Gäste über die UniFi-Controller-API, RADIUS ist also nicht nötig
- Speichern und anwenden. Verbinden Sie ein Testgerät zur Verifizierung.
Walled-Garden-Domains
Fügen Sie diese zum Vorautorisierungszugriff hinzu:
site.app.captifi.io
app.captifi.io
fonts.googleapis.com
fonts.gstatic.com
*.captifi.io
Die ersten vier sind erforderlich; der Wildcard-Eintrag deckt alles ab, was CaptiFi später hinzufügt, falls Ihre Firmware Wildcards akzeptiert.
Fehlerbehebung
- Splash-Seite lädt nicht: Prüfen Sie, ob der Walled Garden die CaptiFi-Domains enthält
- Weiterleitungsschleife: Stellen Sie sicher, dass nur ein Portal aktiv ist (deaktivieren Sie das integrierte UniFi-Portal)
- Gast kann nach dem Login kein Internet erreichen: Überprüfen Sie VLAN-Routing und Firewall-Regeln
Konfigurationsschritte
- Erstellen Sie eine offene Gast-SSID, bei der die Omada-Option Guest Network ausgeschaltet ist, und verwenden Sie ein separates VLAN, um Gäste von Ihren eigenen Geräten fernzuhalten
- Öffnen Sie Network Config → Authentication → Portal (Omada 5: Settings → Authentication → Portal), klicken Sie auf Create New Portal, aktivieren Sie es für die Gäste-SSID und setzen Sie Landing Page auf Original URL
- Setzen Sie auf dem Tab Authentication den Authentication Type auf External Portal Server mit einem benutzerdefinierten Portalserver per URL: Wählen Sie
https://und geben Sieapp.captifi.io/guest/omada?site_id=YOUR_SITE_IDein - Aktivieren Sie auf der Registerkarte Access Control die Option Pre-Authentication Access und fügen Sie
app.captifi.io,46.62.168.7(IP-Bereich, Maske 32),fonts.googleapis.comundfonts.gstatic.comhinzu. Omada akzeptiert keine Wildcards - Fügen Sie unter Hotspot → Operators ein Operator-Konto für CaptiFi hinzu und geben Sie dann auf my.captifi.io die Controller-URL, die 32-stellige Controller-ID und den Operator-Login für den Standort ein
- Speichern Sie und testen Sie mit einem Gästegerät. Mit einer Open-API-App mit Admin-Rolle kann CaptiFi das Portal und die Vorauthentifizierungsliste auf dem Controller für Sie einrichten
Konfigurationsschritte
- Öffnen Sie im Meraki Dashboard → Wireless → Configure → Splash page, wählen Sie die Gast-SSID aus und geben Sie die CaptiFi-Splash-URL unter Custom splash URL ein, wobei Include the client MAC address in the splash URL eingeschaltet ist
- Stellen Sie unter Wireless → Configure → Access control die Option Splash page auf Click-through und die Option Captive portal strength auf Block all access until sign-on is complete
- Aktivieren Sie unter Advanced splash settings den Walled Garden und fügen Sie
app.captifi.io,site.app.captifi.io,*.captifi.io,network-auth.com,*.network-auth.com,fonts.googleapis.comundfonts.gstatic.comhinzu. Ohne die beiden network-auth.com-Einträge gewährt Meraki niemals Zugriff - Änderungen speichern. Testen Sie mit einem Gastgerät auf der konfigurierten SSID.
Einrichtungsschritte
- Verbinden Sie das CaptiFi-Gerät per Ethernet mit dem bestehenden Netzwerk des Standorts und schalten Sie es ein
- Die Leuchte blinkt beim Hochfahren gelb (30 bis 60 Sekunden) und leuchtet dann dauerhaft lila: Das Gerät wartet auf die Aktivierung
- Verbinden Sie sich mit einem Smartphone mit dem Netzwerk „CaptiFi Setup“ und geben Sie die 8-stellige Aktivierungs-PIN des Betriebs ein
- Die Leuchte pulsiert blau, während das Gerät seine Konfiguration aus der CaptiFi-Cloud abruft, und leuchtet dann dauerhaft grün
- Verbinden Sie ein Smartphone mit der Gäste-SSID, und die Splash-Seite wird automatisch geladen
- Die gesamte Einrichtung dauert von Anfang bis Ende etwa fünf Minuten, ohne Controller, statische IP oder Firewall-Änderung
Bedeutung der Leuchte: Gelb blinkend heißt, das Gerät startet, dauerhaft violett heißt, es wartet auf die Aktivierungs-PIN, blau pulsierend heißt, es wird konfiguriert, dauerhaft grün heißt, es ist live. Rot bedeutet kein Internet, prüfen Sie also das Kabel zum Router.
Brauchen Sie Hilfe?
Partner-Support
Sie leisten den First-Level-Support für Ihre Kunden. Schreiben Sie eine E-Mail an partners@captifi.io, um ein technisches Problem an CaptiFi als Second-Level-Support zu eskalieren, und geben Sie an, wenn ein Betrieb ausgefallen ist, damit wir wissen, dass es dringend ist.
Vor der Eskalation
- Bestätigen Sie, dass es kein Problem im lokalen Netzwerk ist
- Überprüfen Sie die Controller-Konnektivität
- Testen mit einem sauberen Gerät (kein zwischengespeichertes Portal)
- Fügen Sie Screenshots und Protokolle hinzu
Noch kein Partner?
Bewerben Sie sich für das MSP-Partnerprogramm, um Zugang zu Großhandelspreisen, Bereitstellungstools und einer 6-monatigen internen Demo-Lizenz für einen internen Teststandort (nur für Tests und Demos) zu erhalten.
Als Partner bewerben