Metabase - príručka pre začiatočníkov
Metabase je open-source platforma pre business intelligence, ktorá umožňuje skúmať dáta, vytvárať nástenky a zdieľať poznatky – bez písania SQL. Pripojte svoje databázy (PostgreSQL, MySQL, MongoDB a ďalšie), kladte otázky vo vizuálnom návrhári dopytov a odpovede premeňte na interaktívne grafy a nástenky.
Krok 1 – Overte, že Metabase funguje
IP adresa a heslo root vášho servera sú uvedené na stránke Server Details v klientskom paneli. Otvorte prehliadač a prejdite na:
http://your.server.ip
Po štarte servera môže spustenie Metabase trvať 30-60 sekúnd. Ak uvidíte chybu pripojenia alebo „502 Bad Gateway“, chvíľu počkajte a obnovte stránku. Po načítaní uvidíte sprievodcu nastavením.
Ak ste server umiestnili za router VyOS v privátnej sieti, buď nastavte presmerovanie portov (80 a 443) na prístup k Metabase z internetu, alebo sa pripojte cez VPN a pristupujte cez privátnu IP servera.
Krok 2 – Dokončenie sprievodcu nastavením
Sprievodca vás prevedie úvodnou konfiguráciou:
Language
Vyberte preferovaný jazyk a kliknite na Next.
Admin Account
Vytvorte účet administrátora – zadajte meno, priezvisko, e-mail, názov firmy (voliteľné) a heslo. S týmito údajmi sa budete prihlasovať do Metabase.
Usage Info
Metabase sa opýta, na čo ho plánujete používať. Vyberte možnosť alebo krok preskočte.
Add Your Data
Pripojte existujúcu databázu, ktorú chcete analyzovať (PostgreSQL, MySQL, MongoDB atď.). Ak zatiaľ žiadnu nemáte, tento krok preskočte – Metabase ponúkne ukážkovú databázu na preskúmanie. Databázy môžete pridať neskôr.
Usage Data Preferences
Zvoľte, či odosielať anonymné štatistiky používania do Metabase.
All Set Up
Nastavenie je dokončené. Kliknite na Take me to Metabase a otvorte nástenku.
Prihláste sa e-mailom a heslom, ktoré ste vytvorili v kroku Admin Account.
Krok 3 – Nastavenie domény a SSL (voliteľné)
Používanie Metabase s vlastnou doménou a HTTPS:
- Vytvorte A záznam v nastaveniach DNS, ktorý nasmeruje vašu doménu na IP servera
- Počkajte na rozšírenie DNS (zvyčajne niekoľko minút až niekoľko hodín)
- Pripojte sa cez SSH a aktualizujte konfiguráciu Nginx:
ssh root@your.server.ip
# Update Nginx server_name with your domain
sed -i 's/server_name _;/server_name your-domain.com;/' /etc/nginx/sites-available/metabase
nginx -t && systemctl reload nginx
# Obtain a free Let's Encrypt SSL certificate
certbot --nginx -d your-domain.com
Certbot automaticky nastaví Nginx pre HTTPS a automatickú obnovu certifikátu.
Po inštalácii
Pripojenie databáz
Pridanie zdroja dát po úvodnom nastavení:
- Kliknite na tlačidlo ikona ozubeného kolesa (vpravo hore) → Admin settings → Databases → Add database
- Vyberte typ databázy (PostgreSQL, MySQL, MongoDB, SQLite atď.)
- Zadajte údaje na pripojenie (host, port, názov databázy, prihlasovacie údaje)
- Kliknite na Uložiť – Metabase automaticky synchronizuje schému
Pri databázach na externých serveroch sa uistite, že firewall povoľuje pripojenia z IP vášho servera Metabase.
Fail2Ban – ochrana proti útokom hrubou silou
Váš server obsahuje Fail2Ban predkonfigurovaný na ochranu SSH proti útokom hrubou silou.
| Pravidlo | Max. počet pokusov | Doba blokovania |
|---|---|---|
| SSH | 5 neúspešných prihlásení | 10 minút |
Užitočné príkazy:
# Check banned IPs
fail2ban-client status sshd
# Unban an IP
fail2ban-client set sshd unbanip 1.2.3.4
Ak sa omylom zablokujete, pripojte sa cez konzolu VNC v klientskom paneli a odblokujte svoju IP.
Správa služieb
Metabase beží ako služba systemd. Užitočné príkazy:
# Check service status
systemctl status metabase
# Restart Metabase
systemctl restart metabase
# View logs
journalctl -u metabase -f
# Nginx reverse proxy
systemctl status nginx
systemctl reload nginx
Aktualizácie
Aktualizácia Metabase na najnovšiu verziu:
# Stop the service
systemctl stop metabase
# Download the latest JAR (backup the current one first)
cd /opt/metabase
cp metabase.jar metabase.jar.bak
curl -L -o metabase.jar https://downloads.metabase.com/latest/metabase.jar
# Start the service
systemctl start metabase
Aktualizácia systémových balíčkov cez SSH:
apt update && apt upgrade -y
Zálohy
Metabase ukladá všetky svoje dáta (otázky, nástenky, nastavenia) v databáze H2. Záloha:
# Stop Metabase before backing up
systemctl stop metabase
# Copy the database file
cp /opt/metabase/metabase.db.mv.db /root/metabase-backup-$(date +%F).db
# Start Metabase again
systemctl start metabase
Na produkčné použitie s veľkými dátovými sadami zvážte migráciu z H2 na PostgreSQL.
Zahrnutý softvér
| Komponent | Verzia |
|---|---|
| Ubuntu | 24.04 LTS |
| Metabase | 0.52.5 |
| Java | 21 |
| Nginx | 1.24 |
| Certbot | 2.9.0 |
| Fail2Ban | 1.0.2 |
Riešenie problémov
| Problém | Riešenie |
|---|---|
| Stránka sa po štarte nenačíta | Spustenie Metabase trvá 30-60 sekúnd. Počkajte a obnovte stránku. Kontrola stavu: systemctl status metabase |
| 502 Bad Gateway v prehliadači | Metabase nebeží. Reštartujte ho: systemctl restart metabase. Kontrola logov: journalctl -u metabase --no-pager -n 50 |
| Chyby nedostatku pamäte | Metabase vyžaduje aspoň 2 GB RAM. Skontrolujte pomocou free -h. Zvážte vyšší tarif servera |
| Nedá sa pripojiť k externej databáze | Overte host, port a prihlasovacie údaje databázy. Uistite sa, že firewall vzdialenej databázy povoľuje pripojenia z IP vášho servera |
| Zabudnuté heslo administrátora Metabase | Obnova cez SSH: java -jar /opt/metabase/metabase.jar reset-password EMAIL |
| Zablokované službou Fail2Ban | Odblokujte svoju IP cez konzolu VNC v klientskom paneli |
| Zabudnuté heslo root | Obnovte ho cez konzolu VNC v klientskom paneli |