MiniDash

Lekki, 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).

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 PHP 8.1+ z rozszerzeniami pdo_sqlite, curl, sodium oraz klucza API z kontrolera UniFi (Settings > Admins & Users > API Keys).

Docker (najszybciej)

Działa na każdym hoście z Dockerem — Linux, Synology, QNAP, Windows, Mac.

git clone https://github.com/sq9lm/MiniDash.git
cd MiniDash
cp .env.example .env
nano .env              # ustaw UNIFI_API_KEY i dane logowania
docker-compose up -d

Dashboard dostępny pod http://adres-serwera:8080. Port konfigurowalny przez MINIDASH_PORT w .env.

Synology / QNAP NAS

1. Zainstaluj Web Station + PHP 8.2 z Package Center
2. Włącz rozszerzenia PHP: pdo_sqlite, curl, sodium
3. Wgraj pliki MiniDash do /web/minidash/
4. Skopiuj .env.example do .env i uzupełnij dane kontrolera
5. Ustaw uprawnienia: chown -R http:http data/ logs/
6. Skonfiguruj Virtual Host lub Reverse Proxy w Web Station
7. Otwórz w przeglądarce — baza SQLite utworzy się automatycznie

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
cp .env.example .env && nano .env
chown -R www-data:www-data data/ logs/
chmod 600 .env

Przykładowa konfiguracja nginx znajduje się w repozytorium: docker/nginx.conf

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.