← Alle Docs
Captive Portal

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.

Note

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.

Der Dialog «Add Client» in der UniFi Network Application mit Feldern für MAC-Adresse und Geräte-Alias

2. Gäste-WLAN erstellen

Gehen Sie zu Settings → WiFi → Create New:

Der Bildschirm «Settings → WiFi» in der UniFi Network Application mit der WLAN-Liste und der Aktion «Create New»
  • Name – die SSID, die Ihre Gäste sehen.
  • NetworkNative Network.
  • Broadcasting APsAll, oder auf bestimmte Access Points beschränken.
  • ApplicationHotspot.
  • Hotspot TypeCaptive Portal.
Das WLAN-Bearbeitungsfenster mit Application auf Hotspot und Hotspot Type auf Captive Portal gesetzt

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.ai

Aktivieren Sie anschliessend alle drei:

  • HTTPS Redirection Support
  • Encrypted URL
  • Domain – und tragen Sie p.heidifi.ai als Domain ein
Warning

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.ai
api.heidifi.ai
askheidi.b-cdn.net

Fügen Sie ausserdem die IP-Adresse oder den Hostnamen Ihres Controllers hinzu, damit der Access Point ihn während des Anmeldevorgangs erreichen kann.

Warning

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/16
172.16.0.0/12
10.0.0.0/8

5. Prüfen

  1. Verbinden Sie ein Smartphone mit der neuen SSID.
  2. Die HeidiFi-Splash-Seite sollte sich automatisch öffnen.
  3. Füllen Sie das Anmeldeformular aus.
  4. 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