Lekki, nowoczesny dashboard do monitorowania sieci Ubiquiti UniFi. Jeden panel, wszystkie najważniejsze statystyki - bez instalowania ciężkich aplikacji. Open-source, self-hosted, PHP.
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
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:
- Wejdź na konsolę pod jej lokalnym adresem, tym samym, pod którym się do niej logujesz, i otwórz aplikację Network.
- Przejdź do Settings → Control Plane → Integrations i kliknij Create API Key. Nazwa może być dowolna, np. „MiniDash”.
- 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)
- Wgraj pliki MiniDash do
/volume1/docker/minidash/ - W Container Manager → Projekt → Utwórz → wskaż folder
- Kontener zbuduje się automatycznie
- 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
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.
MiniDash