MiniDashLekki, nowoczesny dashboard do monitorowania sieci Ubiquiti UniFi. Jeden panel, wszystkie kluczowe 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ź kluczowe 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.
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 wymaga klucza API z kontrolera UniFi (Settings > Admins & Users > API Keys, uprawnienia Read-Only). Konfiguracja odbywa się przez Setup Wizard w przeglądarce — nie trzeba ręcznie edytować żadnych 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/sq9lm/MiniDash.git
cd MiniDash
docker-compose up -dOtwórz http://adres-serwera:8080 — Setup Wizard poprowadzi Cię przez konfigurację (adres kontrolera, API key, dane logowania). Port konfigurowalny przez MINIDASH_PORT w pliku .env.
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 php8.2-fpm php8.2-sqlite3 php8.2-curl php8.2-sodium nginx
git clone https://github.com/sq9lm/MiniDash.git /var/www/minidash
cd /var/www/minidash
chown -R www-data:www-data data/ logs/Skonfiguruj nginx (wzór w docker/nginx.conf), otwórz w przeglądarce — Setup Wizard przeprowadzi resztę.
Pełna instrukcja instalacji — szczegółowe kroki dla Docker, Synology, nginx, Apache, 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
Wielojezyczność
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
- Firewall & Strefy — wizualizacja reguł firewalla z Integration API (177 policies, 8 stref), zarządzanie regułami z poziomu MiniDash
- Mapa sieci — interaktywna topologia z urządzeniami, połączeniami i statusami
- 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.
