Table of Contents

Metabase - průvodce pro začátečníky

Metabase je open-source platforma pro business intelligence, která umožňuje zkoumat data, vytvářet nástěnky a sdílet poznatky – bez psaní SQL. Připojte své databáze (PostgreSQL, MySQL, MongoDB a další), pokládejte otázky ve vizuálním návrháři dotazů a odpovědi proměňte v interaktivní grafy a nástěnky.


Krok 1 – Ověřte, že Metabase funguje

IP adresa a heslo root vašeho serveru jsou uvedeny na stránce Server Details v klientském panelu. Otevřete prohlížeč a přejděte na:

http://your.server.ip

Po startu serveru může spuštění Metabase trvat 30-60 sekund. Pokud uvidíte chybu připojení nebo „502 Bad Gateway“, chvíli počkejte a obnovte stránku. Po načtení uvidíte průvodce nastavením.

Pokud jste server umístili za router VyOS v privátní síti, buď nastavte přesměrování portů (80 a 443) pro přístup k Metabase z internetu, nebo se připojte přes VPN a přistupujte přes privátní IP serveru.


Krok 2 – Dokončení průvodce nastavením

Průvodce vás provede úvodní konfigurací:

Language

Vyberte preferovaný jazyk a klikněte na Next.

Admin Account

Vytvořte účet administrátora – zadejte jméno, příjmení, e-mail, název firmy (volitelné) a heslo. S těmito údaji se budete přihlašovat do Metabase.

Usage Info

Metabase se zeptá, k čemu ho plánujete používat. Vyberte možnost nebo krok přeskočte.

Add Your Data

Připojte existující databázi, kterou chcete analyzovat (PostgreSQL, MySQL, MongoDB atd.). Pokud zatím žádnou nemáte, tento krok přeskočte – Metabase nabídne ukázkovou databázi k prozkoumání. Databáze můžete přidat později.

Usage Data Preferences

Zvolte, zda odesílat anonymní statistiky používání do Metabase.

All Set Up

Nastavení je dokončeno. Klikněte na Take me to Metabase a otevřete nástěnku.

Přihlaste se e-mailem a heslem, které jste vytvořili v kroku Admin Account.


Krok 3 – Nastavení domény a SSL (volitelné)

Používání Metabase s vlastní doménou a HTTPS:

  1. Vytvořte A záznam v nastavení DNS, který nasměruje vaši doménu na IP serveru
  2. Počkejte na rozšíření DNS (obvykle několik minut až několik hodin)
  3. Připojte se přes SSH a aktualizujte konfiguraci 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 pro HTTPS a automatickou obnovu certifikátu.


Po instalaci

Připojení databází

Přidání zdroje dat po úvodním nastavení:

  1. Klikněte na tlačítko ikona ozubeného kola (vpravo nahoře) → Admin settings → Databases → Add database
  2. Vyberte typ databáze (PostgreSQL, MySQL, MongoDB, SQLite atd.)
  3. Zadejte údaje pro připojení (host, port, název databáze, přihlašovací údaje)
  4. Klikněte na Uložit – Metabase automaticky synchronizuje schéma

U databází na externích serverech se ujistěte, že firewall povoluje připojení z IP vašeho serveru Metabase.

Fail2Ban – ochrana proti útokům hrubou silou

Váš server obsahuje Fail2Ban předkonfigurovaný k ochraně SSH proti útokům hrubou silou.

Pravidlo Max. počet pokusů Doba blokace
SSH5 neúspěšných přihlášení10 minut

Užitečné příkazy:

# Check banned IPs
fail2ban-client status sshd

# Unban an IP
fail2ban-client set sshd unbanip 1.2.3.4

Pokud se omylem zablokujete, připojte se přes konzoli VNC v klientském panelu a odblokujte svou IP.

Správa služeb

Metabase běží jako služba systemd. Užitečné pří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

Aktualizace

Aktualizace Metabase na nejnovější verzi:

# 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

Aktualizace systémových balíčků přes SSH:

apt update && apt upgrade -y

Zálohy

Metabase ukládá všechna svá data (otázky, nástěnky, nastavení) v databázi 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

Pro produkční použití s velkými datovými sadami zvažte migraci z H2 na PostgreSQL.


Zahrnutý software

Komponenta Verze
Ubuntu24.04 LTS
Metabase0.52.5
Java21
Nginx1.24
Certbot2.9.0
Fail2Ban1.0.2

Řešení problémů

Problém Řešení
Stránka se po startu nenačte Spuštění Metabase trvá 30-60 sekund. Počkejte a obnovte stránku. Kontrola stavu: systemctl status metabase
502 Bad Gateway v prohlížeči Metabase neběží. Restartujte ho: systemctl restart metabase. Kontrola logů: journalctl -u metabase --no-pager -n 50
Chyby nedostatku paměti Metabase vyžaduje alespoň 2 GB RAM. Zkontrolujte pomocí free -h. Zvažte vyšší tarif serveru
Nelze se připojit k externí databázi Ověřte host, port a přihlašovací údaje databáze. Ujistěte se, že firewall vzdálené databáze povoluje připojení z IP vašeho serveru
Zapomenuté heslo administrátora Metabase Obnova přes SSH: java -jar /opt/metabase/metabase.jar reset-password EMAIL
Blokováno službou Fail2Ban Odblokujte svou IP přes konzoli VNC v klientském panelu
Zapomenuté heslo root Obnovte ho přes konzoli VNC v klientském panelu