EveryCafe
EVERYCAFE / IntegrationenpfSense Community Edition
SCHRITT-FÜR-SCHRITT-ANLEITUNG

Verwalten Sie Ihr Café-Internet
mit EveryCafe.

Ordnen Sie Tarifen Internetleitungen zu, steuern Sie Platzgeschwindigkeiten und verbinden Sie bei Bedarf den WLAN-Zugang mit Mitgliedskonten. Folgen Sie 13 Schritten mit echten Konfigurationsbildern.

01

Vor der Einrichtung vorbereiten

Halten Sie folgende Informationen bereit:

  • Adminzugang zu pfSense Community Edition (CE) und Versionsnummer.
  • Zugriff vom EveryCafe-Hauptrechner auf die pfSense-Verwaltungsadresse.
  • Zuordnung Ihrer Leitungen für Spielbetrieb und allgemeines Internet.
  • Aktuelle pfSense-Sicherung und geeignetes Wartungsfenster.
  • Für WLAN: IP des Hauptrechners und Schnittstelle der WLAN-Clients.
Nur BeispieladressenpfSense: 192.168.10.1; Hauptrechner: 192.168.10.10. Verwenden Sie die echten Adressen Ihres Netzwerks, nicht die Werte aus Screenshots.
02

Netzwerkaufbau verstehen

EveryCafe bestimmt die Richtlinie für jeden Platz, pfSense setzt Gateway, Geschwindigkeit und Zugriff im Netzwerk um. Der Datenverkehr verwalteter Geräte muss deshalb über pfSense laufen.

Wichtig für WLANDas WLAN-Gerät als Access Point (AP / Bridge) nutzen. DHCP soll pfSense bereitstellen; den DHCP-Server des AP deaktivieren. Andernfalls umgehen Geräte eventuell das Portal. Ein Wechsel in den AP-Modus kann dessen Verwaltungsadresse ändern.

Wenn Sie nur PCs verwalten möchten, fahren Sie nach den Schritten 03–07 mit Schritt 12 fort.

03

REST-API-Installation prüfen

Öffnen Sie in pfSense System → REST API. Wenn der Eintrag vorhanden ist, gehen Sie direkt zu Schritt 04.

  1. Versionsnummer von pfSense CE prüfen.
  2. Ein für pfSense und Ihre EveryCafe-Version kompatibles pfrest-Paket auswählen.
  3. Bei Bedarf in der pfSense-Konsole 8 · Shell öffnen und den exakt passenden Installationsbefehl ausführen.
  4. Weboberfläche neu laden und REST API prüfen.
Nur für eine bestimmte Version: pkg-static add https://github.com/pfrest/pfSense-pkg-RESTAPI/releases/download/v2.4.3/pfSense-2.7.2-pkg-RESTAPI.pkg gilt ausschließlich für pfSense CE 2.7.2 und REST API 2.4.3. Nicht für andere Versionen verwenden.
EveryCafe-Einstellungsansicht 1 · Zum Vergrößern klicken
04

API aktivieren und Schlüssel erzeugen

Unter System → REST API → Settings API aktivieren, Allowed Interfaces auf die lokale EveryCafe-Schnittstelle (z. B. LAN) beschränken, Read Only deaktivieren und Key als Authentifizierung einschalten. Den Zugriff niemals auf WAN freigeben.

  1. Einstellungen speichern und Keys öffnen.
  2. Beschreibung wie „EveryCafe Integration“ eingeben.
  3. Speichern und den API-Schlüssel sicher kopieren.
Schlüssel geheim halten. Nicht an Gäste weitergeben oder in Screenshots zeigen.
EveryCafe-Einstellungsansicht 1 · Zum Vergrößern klicken
EveryCafe-Einstellungsansicht 2 · Zum Vergrößern klicken
05

EveryCafe mit pfSense verbinden

Öffnen Sie EveryCafe → Einstellungen → Integrationen → pfSense-Integration.

  1. Integration aktivieren.
  2. Verwaltungs-URL eingeben, z. B. https://192.168.10.1 mit Ihrem Protokoll und Port.
  3. Den API-Schlüssel aus Schritt 04 einfügen.
  4. Verbindung testen und nach Erfolg die Einstellungen speichern.

Bei Fehlern Adresse, Port, Zertifikat, API-Schlüssel und zugelassene Schnittstelle prüfen.

06

Einrichtungsassistenten abschließen

Starten Sie auf derselben Seite den Einrichtungsassistenten. Er legt EC-Aliasse, Geschwindigkeitsbegrenzer und Firewall-Einträge an.

  1. Verbindung prüfen: URL und Schlüssel kontrollieren, testen und weiter.
  2. Leitungen benennen: Gateways auswählen und beispielsweise EC_OYUN und EC_INTERNET zuweisen. Das tatsächliche WAN jeder Leitung überprüfen und Standardleitung festlegen.
  3. Spieleleitung festlegen: angezeigte Spielnetzwerke und Ports prüfen; keine unbekannten IP- oder Portwerte erfinden.
  4. Zusammenfassung prüfen: Einstellungen anwenden und auf Abschluss warten.

Die Option zum Sperren des Internets bei Sitzungsende nach Betriebsbedarf setzen. Alles zuerst an einem Testplatz überprüfen.

EveryCafe-Einstellungsansicht 1 · Zum Vergrößern klicken
EveryCafe-Einstellungsansicht 2 · Zum Vergrößern klicken
EveryCafe-Einstellungsansicht 3 · Zum Vergrößern klicken
07

Leitung dem Tarif zuordnen und Geschwindigkeit steuern

In EveryCafe → Einstellungen → Tarife einen Tarif bearbeiten.

  1. Internetleitung wie EC_INTERNET auswählen.
  2. Automatische Anwendung beim Sitzungsbeginn oder Tarifwechsel aktivieren.
  3. Speichern und andere Tarife entsprechend zuordnen.
  4. Auf dem Hauptbildschirm einen Platz auswählen und Geschwindigkeitskürzel anwenden oder entfernen.
  5. Im Sitzungsüberblick Internetleitung und Geschwindigkeitslimit prüfen.

„Unbegrenzt“ entfernt nur das EveryCafe-Geschwindigkeitslimit, nicht die Kapazitätsgrenze Ihres Internetanschlusses.

EveryCafe-Einstellungsansicht 1 · Zum Vergrößern klicken
EveryCafe-Einstellungsansicht 2 · Zum Vergrößern klicken
08

EveryCafe als Authentifizierungsserver hinzufügen

Für optionale WLAN-Mitgliedsanmeldung: pfSense → System → User Manager → Authentication Servers → Add.

  • Name: EveryCafe; Typ/Protokoll: RADIUS / PAP.
  • Server-IP: Hauptrechner, z. B. 192.168.10.10, nicht die pfSense-IP.
  • Ein starkes Shared Secret festlegen und in Schritt 10 identisch eingeben; es ist nicht der API-Schlüssel.
  • Authentication and Accounting aktivieren; UDP-Ports 1812 und 1813.

Speichern, eine feste bzw. reservierte IP verwenden und passende Zugriffe aus pfSense in der Windows-Firewall des Hauptrechners erlauben.

EveryCafe-Einstellungsansicht 1 · Zum Vergrößern klicken
09

WLAN-Anmeldeportal konfigurieren

Unter pfSense → Services → Captive Portal eine Zone wie everycafe_wifi anlegen.

  1. Portal auf der lokalen WLAN-Client-Schnittstelle aktivieren, niemals auf WAN.
  2. Eigene Portalseiten aktivieren und aus dem EveryCafe-Installationspaket portal-giris.html (Anmeldung), portal-hata.html (Fehler) und portal-cikis.html (Abmeldung) hochladen.
  3. Als Authentifizierung ein Backend wählen und EveryCafe als Authentication Server.
  4. Use RADIUS Session-Timeout attributes aktivieren.
  5. Bei Accounting Send RADIUS accounting packets mit Server EveryCafe und Interim-Updates einschalten. Input-/Output-Umkehr und Idle-Time deaktiviert lassen.

Speichern und Änderungen anwenden. Die HTML-Datei dieser Anleitung ist keine Portalseite; laden Sie die drei Dateien aus dem Installer oder beziehen Sie sie vom Support.

EveryCafe-Einstellungsansicht 1 · Zum Vergrößern klicken
EveryCafe-Einstellungsansicht 2 · Zum Vergrößern klicken
EveryCafe-Einstellungsansicht 3 · Zum Vergrößern klicken
EveryCafe-Einstellungsansicht 4 · Zum Vergrößern klicken
10

WLAN-Zugang in EveryCafe aktivieren

EveryCafe → Einstellungen → Integrationen → pfSense → Drahtlos öffnen und WLAN-Anmeldungen aktivieren.

  • Shared Secret: exakt das Passwort aus Schritt 08.
  • Gebühr: Abzug vom Mitgliedsguthaben; 0 für kostenlose Anmeldung.
  • Dauer: zulässige Verbindungsminuten.
  • Abhöradresse: von pfSense erreichbare lokale IP des Hauptrechners.
  • Sicherheitscode: separater Code für berechtigten freien Zugang.

Beispiel: 30 TRY für 60 Minuten. Dies ist keine Preisempfehlung. Nach dem Speichern den RADIUS-Dienst und mögliche Portkonflikte prüfen.

11

DNS-Abfrageprotokolle an EveryCafe senden

pfSense kann DNS-Abfragen an den EveryCafe-Hauptrechner senden. Das sind keine vollständigen URLs oder HTTPS-Inhalte; verschlüsseltes DNS, VPNs oder andere DNS-Server können Abfragen umgehen.

  1. Services → DNS Resolver → General Settings öffnen und DNS Resolver aktivieren. Unter server: in Custom Options log-queries: yes ergänzen.
  2. Speichern, übernehmen und den Dienst unbound neu starten; die DNS-Auflösung kann kurz unterbrochen werden.
  3. Unter Status → System Logs → Settings Remote Logging zum Hauptrechner, z. B. 192.168.10.10:514, per IPv4 einrichten und DNS Events aktivieren.
  4. UDP 514 von der pfSense-IP in der Firewall des Hauptrechners zulassen. Die Firewall nicht komplett deaktivieren und Protokolle im LAN halten.

Danach eine DNS-Abfrage auslösen und EveryCafe IPLog prüfen.

EveryCafe-Einstellungsansicht 1 · Zum Vergrößern klicken
EveryCafe-Einstellungsansicht 2 · Zum Vergrößern klicken
EveryCafe-Einstellungsansicht 3 · Zum Vergrößern klicken
12

Mit einem PC und einem Telefon testen

Alle Funktionen vor Kundenfreigabe an Testgeräten prüfen.

PC-Kontrolle

  • EveryCafe-Verbindungstest erfolgreich.
  • Internet- und Spieletarif wählen das erwartete Gateway.
  • Geschwindigkeitslimit lässt sich anwenden und entfernen.
  • Wenn aktiviert, endet der Internetzugriff nach Sitzungsende.

WLAN-Kontrolle

  • Mobile Daten ausschalten, Café-WLAN verbinden und Portal öffnen.
  • Testmitglied anmelden und Guthabenabbuchung prüfen.
  • Internetzugriff und automatisches Ende nach Ablauf testen.
  • Bei aktivierter Protokollierung DNS-Ereignis in IPLog prüfen.
Vor dem KundenstartGebühren und Dauer deutlich kommunizieren und nur geprüfte Funktionen freigeben.
EveryCafe-Einstellungsansicht 1 · Zum Vergrößern klicken
EveryCafe-Einstellungsansicht 2 · Zum Vergrößern klicken
13

Fehlerbehebung

REST API fehlt
Kompatibilität von Paket und pfSense-Version prüfen.
Verbindungstest fehlgeschlagen
URL, Port, TLS-Zertifikat, Enabled, Key und Allowed Interfaces kontrollieren.
Tarif ändert sich, Leitung nicht
Tarifzuordnung, automatische Anwendung, Platz-IP und Assistent prüfen.
Telefon umgeht die Anmeldung
Mobile Daten, AP-DHCP und pfSense-Schnittstelle kontrollieren.
Mitgliedsanmeldung wird abgelehnt
RADIUS-Dienst, PAP, Shared Secret, Hauptrechner-IP, UDP 1812/1813, Mitgliedsstatus und Guthaben überprüfen.
Sitzungsdauer falsch
Session-Timeout, Accounting, Interim und UDP 1813 prüfen.
DNS-Protokolle fehlen
DNS Resolver, unbound, DNS Events, Serveradresse und UDP 514 kontrollieren.

Für den Support Versionsnummern, Fehler und Bilder ohne sichtbare Schlüssel oder Passwörter bereithalten.

A–Z

Kurzes Technikglossar

WAN / Gateway
Internetleitung und das zugehörige Gateway.
LAN / Interface
Lokales Netzwerk bzw. pfSense-Schnittstelle.
Alias
Benannte Liste von IP-Adressen oder Netzwerken.
Limiter
Regel zur Begrenzung der Verbindungsgeschwindigkeit.
API-Schlüssel
Geheimes Zugriffsmittel für die pfSense-Einstellungen.
RADIUS / PAP
Mitgliedsauthentifizierung und das verwendete Protokoll.
Accounting / Interim
Sitzungsberichte und regelmäßige Zwischenmeldungen.
Shared Secret
Gleiches Passwort auf beiden Seiten der RADIUS-Verbindung.
Captive Portal
WLAN-Anmeldeseite für Gäste.
DHCP / DNS / Syslog
IP-Vergabe, Namensauflösung und Weiterleitung von Protokollen.