Open Source / Web App / UniFi / Aktywnie rozwijany

MiniDashMiniDash

Lekki, nowoczesny dashboard do monitorowania sieci Ubiquiti UniFi. Jeden panel, wszystkie najważniejsze statystyki - bez instalowania ciężkich aplikacji. Open-source, self-hosted, PHP.
GitHub Repository
MiniDash - UniFi Dashboard, LM Networks

Co potrafi MiniDash?

MiniDash to alternatywny widok dla kontrolera UniFi, oferujący skondensowany podgląd najważniejszych parametrów sieci w jednym miejscu (Single Panel of Glass).

📊

Dashboard real-time

WAN throughput na żywo, klienci, sieci WiFi, urządzenia, VLAN segmentacja z live chart.

🛡️

Security Monitor

IPS/IDS events, security score, geo-blocking, reguły firewalla, zablokowane IP z geolokalizacją.

📡

Wi-Fi Stalker

Śledzenie sesji WiFi, wykrywanie roamingu między AP, historia RSSI, watchlist urządzeń.

🔔

8 kanałów alertów

Telegram, Discord, Slack, Email, ntfy, WhatsApp, SMS, n8n. Inteligentne wyzwalacze alarmów.

🖥️

Monitoring zasobów

Śledź ważne urządzenia, alerty online/offline, historia dostępności z transferem.

🎥

UniFi Protect

Grid kamer (1-12 widoków), status NVR, ruch VLAN kamer, podgląd na żywo.

Co nowego

MiniDash jest cały czas rozwijany. Od wiosny 2026 doszło kilkanaście nowych funkcji, ostatnie w październiku 2026, a kolejne są w drodze.

🌐

Dwa łącza WAN

Status, adres IP i transfer każdego łącza osobno, wykres przełączany między łączami i alert, gdy łącze padnie, a ruch przejmie zapasowe.

📉

Historia awarii łącza

Dostępność każdego łącza w procentach za 7, 30 i 90 dni, lista przerw z czasem trwania i zestawienie miesięczne. Od razu widać, czy dostawca dotrzymuje obietnic.

📈

Kto zużywa łącze

Ranking urządzeń i sieci VLAN według transferu za dzień, tydzień i miesiąc oraz kafelek największych konsumentów na dashboardzie.

📋

Inwentarz urządzeń

Wszystkie urządzenia, które pojawiły się w sieci, z właścicielem i notatką. Nowy, niezatwierdzony sprzęt jest wyraźnie oznaczony, podobnie jak telefony z losowym adresem MAC.

🗺️

Mapa sieci

Topologia od bramy w dół: switche, punkty dostępowe i klienci ze statusem. MiniDash wykrywa też switche niezarządzane.

🧱

Firewall i strefy

Macierz stref pokazuje, jaki ruch może płynąć między sieciami, a kliknięcie komórki pokazuje reguły dla tej pary. Własne reguły włączysz i wyłączysz z poziomu MiniDash.

🔐

Kontrola dostępu

Blokady i harmonogramy ustawione w UniFi włączasz i wyłączasz jednym kliknięciem z dashboardu, bez logowania do kontrolera.

🧩

Własny układ dashboardu

Kafelki przeciągasz, zmieniasz im rozmiar i ukrywasz te, których nie potrzebujesz. Układ jest taki sam na każdym urządzeniu. Nowe kafelki: Security Score i zablokowany ruch.

🔔

Raporty i spokojniejsze alerty

Raport dobowy o wybranej godzinie, powiadomienia Telegrama w osobnych wątkach według wagi, mniej fałszywych alarmów przy roamingu i alert o podejrzanym logowaniu do panelu.

Każda instalacja sama sprawdza, czy na GitHubie jest nowsza wersja, i pokazuje w panelu powiadomienie o aktualizacji.

Stack technologiczny

PHP 8.2 SQLite Tailwind CSS Vanilla JS Chart.js Lucide Icons Docker

Brak frameworków, brak zbędnych zależności. Cały projekt to czyste PHP + JS - szybki, lekki, łatwy w deploymencie. Działa na każdym serwerze z PHP 8.1+.

Instalacja

MiniDash łączy się z konsolą UniFi kluczem API. Klucz tworzysz na samej konsoli, w aplikacji UniFi Network:

  1. Wejdź na konsolę pod jej lokalnym adresem, tym samym, pod którym się do niej logujesz, i otwórz aplikację Network.
  2. Przejdź do Settings → Control Plane → Integrations i kliknij Create API Key. Nazwa może być dowolna, np. „MiniDash”.
  3. Skopiuj klucz od razu, bo konsola pokazuje go tylko raz.

Klucz z unifi.ui.com (Site Manager → API Keys) się nie nada. Służy do chmurowego API Ubiquiti, a MiniDash rozmawia z konsolą bezpośrednio, więc kreator zgłosi, że konsola odrzuciła klucz. Do samego monitoringu wystarczą uprawnienia tylko do odczytu, a przełączanie blokad i reguł firewalla z poziomu MiniDash wymaga prawa zapisu. Resztę ustawiasz w kreatorze w przeglądarce, bez edycji plików.

Docker (najszybciej)

Działa na każdym hoście z Dockerem - Linux, Synology, QNAP, Windows, Mac. Trzy komendy:

git clone https://github.com/lm-networks/MiniDash.git
cd MiniDash
docker compose up -d

Otwórz http://adres-serwera:8080 i pojawi się kreator. Wpisujesz adres IP konsoli i klucz API, kreator sprawdza połączenie i sam wybiera site, a na koniec ustawiasz login i hasło do MiniDasha. Port konfigurowalny przez MINIDASH_PORT w pliku .env.

Konfiguracja i dane zostają w wolumenach Dockera, więc aktualizacja (git pull i docker compose up -d --build) ich nie kasuje. Kontener sam uruchamia zadania w tle: alerty, raport dobowy i statystyki łączy.

Synology NAS (Container Manager)

  1. Wgraj pliki MiniDash do /volume1/docker/minidash/
  2. W Container Manager → Projekt → Utwórz → wskaż folder
  3. Kontener zbuduje się automatycznie
  4. Otwórz http://IP-NAS:8080 - Setup Wizard przeprowadzi konfigurację

Kontener zawiera bash i mc (Midnight Commander) do łatwej nawigacji przez terminal.

Linux (nginx + PHP-FPM)

apt install php-fpm php-sqlite3 php-curl nginx git
git clone https://github.com/lm-networks/MiniDash.git /var/www/minidash
cd /var/www/minidash
chown -R www-data:www-data data/ logs/

Działa na Debianie 12+ i Ubuntu 22.04+ (PHP 8.1 lub nowszy). Skonfiguruj nginx według gotowego vhosta z pełnej instrukcji i otwórz MiniDash w przeglądarce - Setup Wizard przeprowadzi resztę.

Bez Dockera dodaj dwa zadania cron uruchamiane co minutę jako www-data - od nich zależą alerty, raport dobowy i historia łączy:

* * * * * php /var/www/minidash/cron_triggers.php >/dev/null 2>&1
* * * * * sleep 30; php /var/www/minidash/update_wan.php >/dev/null 2>&1

Pełna instrukcja instalacji - szczegółowe kroki dla Docker, Synology (także Web Station z Harmonogramem zadań), nginx, Apache, test bezpieczeństwa i troubleshooting.

Bezpieczeństwo

  • Sesje: httponly cookies, fingerprint SHA256, CSRF tokeny, rate limiting
  • Szyfrowanie: credentials w config.json szyfrowane sodium_crypto_secretbox
  • Wszystkie API endpointy wymagają autentykacji
  • Walidacja uploadu (MIME, rozmiar, losowe nazwy plików)
  • Testy: 73 asercje w 6 modułach testowych

Wielojęzyczność

Pełne tłumaczenie PL/EN z przełącznikiem języka w ustawieniach. System oparty na plikach JSON z obsługą parametrów i dot-notation.

Galeria

MiniDash - dashboard z kontrolą dostępu i dwoma łączami WAN
Dashboard: szybkie przełączniki kontroli dostępu, dwa łącza WAN i ruch na żywo
MiniDash - mapa sieci
Mapa sieci od bramy w dół, z wykrytymi switchami niezarządzanymi
MiniDash - transfer per urządzenie i VLAN
Transfer per urządzenie i VLAN za dzień, tydzień lub miesiąc
MiniDash - historia awarii łączy WAN
Historia awarii łączy WAN z dostępnością za 90 dni
MiniDash - macierz stref firewalla
Macierz stref firewalla z własnymi regułami
WAN Link Monitor
Wi-Fi Stalker
Notification Settings

Planowane funkcje

  • UniFi Protect - rozbudowa modułu kamer: timeline zdarzeń, detekcja ruchu, podgląd na żywo z poziomu dashboardu
  • Raporty PDF - automatyczne generowanie raportów bezpieczeństwa i wydajności sieci
  • Wielodostęp - role użytkowników (admin / read-only), 2FA
  • API webhooks - integracja z zewnętrznymi systemami monitoringu (Zabbix, Grafana)

Licencja

MIT License - wolne używanie, modyfikacja i dystrybucja. Stworzone przez Łukasza Misiurę / LM-Networks.

Oceny uzytkownikow (5/5 z 4 ocen)

Piotr
2026-06-24

Ciekawe .... nie powiem a planujecie to dalej rozwijać ?

kris
2026-06-02

proste i bardzo praktyczne narzędzie do monitorowania własnych zasobów IT. Czytelny panel, szybki dostęp do najważniejszych informacji i realna pomoc w codziennej administracji siecią oraz usługami. Polecam

Łukasz
2026-04-27

zapowiada się super

adam
2026-04-15

ciekawa aplikacja , czekam na rozwój

Dodaj swoją ocenę