UniFi-Controller-Referenz (fortgeschritten)
Sie betreiben Ihren eigenen UniFi-Controller? Richten Sie dessen Gäste-Hotspot auf das HeidiFi Captive Portal aus – Netzwerk, externer Portal-Server und Walled-Garden-Einstellungen.
Zuletzt aktualisiert am 13. August 2026
Diese Anleitung richtet sich an Standorte, die ihren eigenen UniFi Network Controller betreiben und deren Gäste-WLAN das HeidiFi Captive Portal nutzen soll.
Die meisten Standorte brauchen diese Seite nicht. Wenn Sie einen UniFi Access Point für HeidiFi gekauft haben, folgen Sie stattdessen Ihren UniFi Access Point einrichten – HeidiFi betreibt den Controller für Sie, und nichts von dem, was unten steht, muss konfiguriert werden.
Sie brauchen Administratorzugriff auf Ihren Controller (UniFi Network 7 oder neuer) und etwa 15 Minuten.
1. Access Point adoptieren
Ist der Access Point neu in Ihrem Controller, adoptieren Sie ihn wie gewohnt: Er erscheint nach dem Einschalten unter Devices als Pending Adoption – klicken Sie auf Adopt.
Sie können auch seine MAC-Adresse vorregistrieren, damit er leichter zu erkennen ist: Gehen Sie zu Network → Clients, klicken Sie auf Add Client, fügen Sie die MAC-Adresse ein und geben Sie ihm einen erkennbaren Namen.
2. Gäste-WLAN erstellen
Gehen Sie zu Settings → WiFi → Create New:
- Name – die SSID, die Ihre Gäste sehen.
- Network – Native Network.
- Broadcasting APs – All, oder auf bestimmte Access Points beschränken.
- Application – Hotspot.
- Hotspot Type – Captive Portal.
Speichern Sie das Netzwerk – der Controller bestätigt, dass ein Hotspot Portal darauf angewendet wurde.
3. Hotspot auf HeidiFi ausrichten
Öffnen Sie den soeben erstellten Hotspot (in der Regel unter Clients → Hotspot oder über den Link Hotspot Portal in den WLAN-Einstellungen). Aktivieren Sie unter One Way Methods die Option External Portal Server, klicken Sie auf Edit und tragen Sie die Portal-Adresse ein:
Externer Portal-Server
p.heidifi.aiAktivieren Sie anschliessend alle drei:
- HTTPS Redirection Support
- Encrypted URL
- Domain – und tragen Sie
p.heidifi.aials Domain ein
Ohne HTTPS Redirection Support sehen Gäste auf modernen Smartphones nur die native Aufforderung «Beim Netzwerk anmelden» statt der HeidiFi-Splash-Seite.
4. Walled Garden einrichten
Scrollen Sie im Hotspot-Editor zu Authorization Access. Gäste müssen diese Adressen vor der Anmeldung erreichen können – fügen Sie jede unter Pre-Authorization Allowances hinzu:
p.heidifi.aiapi.heidifi.aiaskheidi.b-cdn.netFügen Sie ausserdem die IP-Adresse oder den Hostnamen Ihres Controllers hinzu, damit der Access Point ihn während des Anmeldevorgangs erreichen kann.
askheidi.b-cdn.net liefert Ihr Logo und die Splash-Bilder aus. Lassen Sie es weg, öffnet sich die Splash-Seite zwar trotzdem – aber alle Bilder sind kaputt.
Damit Gäste nach der Anmeldung nicht in Ihr internes Netzwerk gelangen, fügen Sie die privaten Adressbereiche unter Post-Authorization Restrictions hinzu:
192.168.0.0/16172.16.0.0/1210.0.0.0/85. Prüfen
- Verbinden Sie ein Smartphone mit der neuen SSID.
- Die HeidiFi-Splash-Seite sollte sich automatisch öffnen.
- Füllen Sie das Anmeldeformular aus.
- Sie sollten Internetzugang haben.
Sehen Sie nur die native Aufforderung «Beim Netzwerk anmelden», prüfen Sie erneut HTTPS Redirection Support in Schritt 3 und die Pre-Authorization Allowances in Schritt 4.
Controller bei HeidiFi registrieren
Damit HeidiFi Gäste autorisieren und den Status Ihrer Access Points anzeigen kann, muss Ihr Controller mit Ihrem HeidiFi-Konto verknüpft sein. Dieser Teil erfolgt gemeinsam mit unserem Team – kontaktieren Sie uns mit dem Namen Ihres Standorts, und wir schliessen die Verbindung mit Ihnen ab.
Bereit loszulegen?
Starten Sie Ihre 14-tägige kostenlose Testphase — Karte hinterlegen, jederzeit vor Ablauf kündigen, und es wird nichts belastet.
14 Tage kostenlos testen