captive_portal-check/README.md
2025-09-16 21:36:16 +02:00

57 lines
1.6 KiB
Markdown

NetworkManager Captive Portal Auto-Detector
Automatische Erkennung und Handhabung von Captive Portals unter Linux
Dieses Skript automatisiert die Erkennung von Captive Portals (Login-Seiten in WLAN-Netzwerken) und öffnet automatisch einen Browser zur Authentifizierung.
🚀 Funktionsweise
Das Skript wird als NetworkManager Dispatch Script integriert und:
Überwacht WLAN-Verbindungsereignisse
Führt Connectivity-Checks durch when eine Verbindung aufgebaut wird
Erkennt automatisch Captive Portals durch HTTP-Response-Analyse
Öffnet Firefox zur Anmeldung beim Portal
Loggt alle Aktivitäten zur einfachen Fehleranalyse
📋 Features
🔍 Zuverlässige Erkennung: Prüft multiple Connectivity-Endpoints
⚡ Automatisch: Keine manuelle Interaktion nötig
📝 Detailliertes Logging: Umfassende Protokollierung nach /var/log/nm-captive.log
🎯 WLAN-spezifisch: Reagiert nur auf WLAN-Verbindungen
🔧 Einfache Installation: Einfache Kopieren und Berechtigungen setzen
🛠️ Installation
```bash
sudo cp 99-captive-portal /etc/NetworkManager/dispatcher.d/
sudo chmod +x /etc/NetworkManager/dispatcher.d/99-captive-portal
sudo touch /var/log/nm-captive.log
```
📊 Logging
Das Skript protokolliert alle Aktivitäten in /var/log/nm-captive.log:
Verbindungsereignisse
HTTP-Testergebnisse
Erkennung von Captive Portals
Browser-Starts
🤝 Beitragen
Contributions sind willkommen! Öffne einfach einen Issue oder Pull Request für:
Verbesserte Captive Portal Erkennung
Unterstützung weiterer Browser
Additional Distribution compatibility
Perfect für Linux-Nutzer, die regelmäßig mit öffentlichen WLANs mit Login-Portals verbinden!