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:
- Vytvořte A záznam v nastavení DNS, který nasměruje vaši doménu na IP serveru
- Počkejte na rozšíření DNS (obvykle několik minut až několik hodin)
- 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í:
- Klikněte na tlačítko ikona ozubeného kola (vpravo nahoře) → Admin settings → Databases → Add database
- Vyberte typ databáze (PostgreSQL, MySQL, MongoDB, SQLite atd.)
- Zadejte údaje pro připojení (host, port, název databáze, přihlašovací údaje)
- 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 |
|---|---|---|
| SSH | 5 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 |
|---|---|
| Ubuntu | 24.04 LTS |
| Metabase | 0.52.5 |
| Java | 21 |
| Nginx | 1.24 |
| Certbot | 2.9.0 |
| Fail2Ban | 1.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 |