Hallo zusammen,
ich möchte euch mein Projekt zum dem Thema „Unifi APs mit Stock Firmware in die Meshviewer Map anzeige“ vorstellen. Ich bin vor einem Monat auf einem Treffen meiner Freifunk Community „Freifunk Nordheide“ gewesen und habe dort von dem Problem gehört, dass man aktuell die Unifi APs mit der Stock / Original Firmware von Unifi nicht in einer Meshviewer Map einbinden kann.
Das Problem
Die Frage wurde auch aus unserer Community hier bereits einmal gestellt.
https://forum.freifunk.net/t/ubnt-unifi-mit-stock-via-meshviewer-darstellen/20780
Die Umstände
Ich habe selbst ein etwas größeres Unifi Netzwerk und war von der Idee ganz fasziniert gewesen. Den ich wollte einerseits auch einen Freifunk Zugang bereitstellen, aber nicht auf den Funktionsumfang der Stock Firmware verzichten. Also habe ich mir die aktuellen Lösungen zu dem Thema einmal angesehen und bereits gute Ansätze gefunden. Doch Sie waren leider entweder schon veraltet oder zu statisch gehalten. Da ich auch noch Neuling in dem Thema Freifunk und Meshviewer war, hat mich meine Community hier sehr gut unterstützt. Kurze Hand habe ich ein eigenes Tool mit PHP geschrieben und auf meinem Git System veröffentlicht.
Download
https://git.isp-serverfarm.de/freifunk-nordheide/unifi-meshviewer-generator
Ich habe das Projekt unter der MIT Lizenz veröffentlicht und damit auch anderen eine Lösung für das Problem zu bieten.
Was kann mein System aktuell?
Das Tool kann auf jedem beliebigen Webspace verwendet werden. Der Unifi Controller muss von dem Tool aus erreichbar sein. Idealerweise erstellt man einen Statistik User im Controller der nur Daten abfragen darf, aber keine Änderungen vornehmen kann.
Ein Cronjob ruft alle paar Minuten die URL des Webservice auf und generiert aus den Daten des Unifi Controller eine aktuelle JSON Meshviewer Datei. Diese Datei kann sich dann der Community Admin z.B. per WGET auf den Community Server mit der Meshviewer MAP kopieren. Es hat sich gezeigt, dass dies für die Erreichbarkeit ein stabiler Ansatz ist. Da die Map bei Störungen der zusätzlichen Meshviewer JSON Files überhaupt nicht mehr funktioniert.
- Auslastung der APs wird ermittelt
- Load und Memory werden von den APs ermittelt
- Anzahl der Clients im 2,4 / 5,0 GHz Bereich wird ermittelt.
- AP Koordinaten aus dem Unifi Controller
- Uptime der APs
- Online Status der APs
- Uplink Route zu den Super Nodes dargestellt
- Definition eines Public Namen für jeden AP unabhängig vom internen DNS Namen im Controller
- Aktuelle Firmware und das Modell des AccessPoint
- Die Communtiy benötigt keinen Zugang zu deinem Unifi Controller, die Daten werden über deinen Webspace generiert, die Aufbereitung der Daten erfolgt damit ebenfalls in deiner Umgebung.
Mein Einsatz-Szenario
Bei mir läuft aktuell ein Unifi ER-X als Offloader und stellt damit die Verbindung zu meinem Freifunk Netzwerk und meinem Unifi LAN her. Meine APs senden nun die Freifunk SSID „nordheide.freifunk.net“ welche mittels VLAN an meinem Offloader angebunden ist. Damit aber auch noch eine Ad-Hoc Verbindung zu anderen Freifunk Endpoints möglich ist, läuft auch noch ein Netgear Router mit Gluon Firmware im Netzwerk, welcher ebenfalls seinen Uplink von dem Offloader zur Verfügung gestellt bekommt. Somit ist die Idee von Freifunk komplett umgesetzt und meine APs senden alle ein starkes Signal.
Eure Unterstützung
Ich möchte noch einige Optimierungen vornehmen, vielleicht habt auch ihr noch ein paar Ideen oder Verbesserungen? In diesem Thread freue ich mich über neue Idee, Features oder auch Probleme mit euch diskutieren zu können. Danke für euren Feedback.
Was soll noch kommen ?
Ich möchte noch einiges an meinem Tool verbessern und erweitern. Dies könnt ihr ebenfalls auf meinem Git System einsehen.
https://git.isp-serverfarm.de/freifunk-nordheide/unifi-meshviewer-generator/issues
Feedback aus dem Thread werde ich dort mit aufnehmen und auch gerne umsetzen, wenn es meine Freizeit auch zulässt und ein gewisser Nutzen hinter der Idee steckt.
Und nun, viel Spaß mit meinem Tool, dem „Unifi Meshviewer Generator“…
Lieben Gruß aus der Community „Freifunk Nordheide“.
Björn
