Josiecontrolling326/unifi-map

Was macht unifi-map?

Exportieren Sie UniFi-Netzwerktopologien als zoombare Vektordiagramme und bearbeitbare draw.io-Dateien unter Verwendung echter Gerätedaten.

Funktionen

• Zoomable Vektordiagramme: Exportiert Netzwerktopologien als skalierbare Vektorgrafiken (SVG), die ohne Qualitätsverlust vergrößert werden können.
• Draw.io-Integration: Erstellt bearbeitbare .drawio-Dateien, die in draw.io oder dessen Desktop-Version geöffnet und angepasst werden können.
• Echtzeit-Gerätedaten: Verwendet aktuelle Gerätedaten aus Ihrem UniFi-System (z. B. Access Points, Switches, Gateways).
• Automatische Topologieerkennung: Erfasst automatisch die Verbindungen zwischen Geräten und stellt sie übersichtlich dar.

Voraussetzungen

• Zugriff auf ein UniFi-Netzwerk mit API-Zugang (z. B. UniFi Controller)
• API-Schlüssel oder Anmeldedaten für die UniFi-API
• python3 mit installierten Bibliotheken (siehe requirements.txt)

Installation

1. Klonen Sie das Repository:

   git clone https://github.com/Josiecontrolling326/unifi-map.git
   cd unifi-map
   

2. Installieren Sie die Abhängigkeiten:

   pip install -r requirements.txt
   

3. Konfigurieren Sie die Umgebungsvariablen:
   • UNIFI_HOST: Hostname/IP des UniFi Controllers
   • UNIFI_USERNAME: Benutzername
   • UNIFI_PASSWORD: Passwort

Verwendung

Führen Sie das Skript aus:

python3 unifi_map.py --output-dir ./output

Optionale Parameter:

• --layout: Layout-Stil (z. B. hierarchisch, frei)
• --include-devices: Gerätetypen einschließen (z. B. AP, Switch, Gateway)
• --verbose: Ausführliche Ausgabe aktivieren

Ausgabe

• topology.svg: Zoomfähiges Vektordiagramm
• topology.drawio: Bearbeitbare draw.io-Datei

Lizenz

MIT

Autor

Josiecontrolling326