Metabase - ghid de inițiere
Metabase este o platformă open-source de business intelligence care vă permite să explorați date, să construiți dashboard-uri și să partajați informații – fără a scrie SQL. Conectați bazele de date (PostgreSQL, MySQL, MongoDB și altele), puneți întrebări printr-un constructor vizual de interogări și transformați răspunsurile în grafice și dashboard-uri interactive.
Pasul 1 – Verificați funcționarea Metabase
Adresa IP și parola root a serverului sunt afișate pe pagina Server Details din panoul clientului. Deschideți browserul și accesați:
http://your.server.ip
Pornirea Metabase poate dura 30-60 de secunde după pornirea serverului. Dacă vedeți o eroare de conectare sau „502 Bad Gateway”, așteptați puțin și reîmprospătați pagina. După încărcare, veți vedea asistentul de configurare.
Dacă ați plasat serverul în spatele unui router VyOS într-o rețea privată, configurați redirecționarea porturilor (80 și 443) pentru a accesa Metabase de pe internet sau conectați-vă prin VPN și accesați-l pe IP-ul privat al serverului.
Pasul 2 – Finalizarea asistentului de configurare
Asistentul de configurare vă va ghida prin configurarea inițială:
Language
Selectați limba preferată și faceți clic pe Next.
Admin Account
Creați contul de administrator – introduceți prenumele, numele, e-mailul, numele companiei (opțional) și parola. Acestea sunt datele cu care vă veți autentifica în Metabase.
Usage Info
Metabase vă întreabă pentru ce plănuiți să-l folosiți. Selectați o opțiune sau săriți peste.
Add Your Data
Conectați o bază de date existentă pe care doriți să o analizați (PostgreSQL, MySQL, MongoDB etc.). Dacă nu aveți încă una, săriți peste acest pas – Metabase va oferi o bază de date de exemplu. Puteți adăuga bazele de date ulterior.
Usage Data Preferences
Alegeți dacă trimiteți statistici anonime de utilizare către Metabase.
All Set Up
Configurarea este finalizată. Faceți clic pe Take me to Metabase pentru a deschide dashboard-ul.
Autentificați-vă cu e-mailul și parola create la pasul Admin Account.
Pasul 3 – Configurarea domeniului și SSL (opțional)
Pentru a folosi Metabase cu domeniul propriu și HTTPS:
- Creați o înregistrare A în setările DNS care direcționează domeniul către IP-ul serverului
- Așteptați propagarea DNS (de obicei câteva minute până la câteva ore)
- Conectați-vă prin SSH și actualizați configurația 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 va configura automat Nginx pentru HTTPS și reînnoirea automată a certificatului.
După instalare
Conectarea bazelor de date
Pentru a adăuga o sursă de date după configurarea inițială:
- Faceți clic pe butonul pictograma roată dințată (dreapta sus) → Admin settings → Databases → Add database
- Selectați tipul bazei de date (PostgreSQL, MySQL, MongoDB, SQLite etc.)
- Introduceți datele de conectare (host, port, numele bazei de date, datele de acces)
- Faceți clic pe Salvare – Metabase va sincroniza automat schema
Pentru baze de date pe servere externe, asigurați-vă că firewall-ul permite conexiuni de la IP-ul serverului Metabase.
Fail2Ban – protecție împotriva atacurilor brute-force
Serverul dumneavoastră include Fail2Ban preconfigurat pentru a proteja SSH împotriva atacurilor brute-force.
| Regulă | Încercări maxime | Durata blocării |
|---|---|---|
| SSH | 5 autentificări eșuate | 10 minute |
Comenzi utile:
# Check banned IPs
fail2ban-client status sshd
# Unban an IP
fail2ban-client set sshd unbanip 1.2.3.4
Dacă vă blocați accidental, conectați-vă prin consola VNC din panoul clientului și deblocați-vă IP-ul.
Administrarea serviciilor
Metabase rulează ca serviciu systemd. Comenzi utile:
# 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
Actualizări
Pentru a actualiza Metabase la cea mai recentă versiune:
# 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
Pentru a actualiza pachetele sistemului prin SSH:
apt update && apt upgrade -y
Backup-uri
Metabase stochează toate datele (întrebări, dashboard-uri, setări) într-o bază de date H2. Pentru backup:
# 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
Pentru utilizare în producție cu seturi mari de date, luați în considerare migrarea de la H2 la PostgreSQL.
Software inclus
| Componentă | Versiune |
|---|---|
| Ubuntu | 24.04 LTS |
| Metabase | 0.52.5 |
| Java | 21 |
| Nginx | 1.24 |
| Certbot | 2.9.0 |
| Fail2Ban | 1.0.2 |
Depanare
| Problemă | Soluție |
|---|---|
| Pagina nu se încarcă după pornire | Pornirea Metabase durează 30-60 de secunde. Așteptați și reîmprospătați. Verificați starea: systemctl status metabase |
| 502 Bad Gateway în browser | Metabase nu rulează. Reporniți-l: systemctl restart metabase. Verificarea logurilor: journalctl -u metabase --no-pager -n 50 |
| Erori de lipsă de memorie | Metabase necesită cel puțin 2 GB RAM. Verificați cu free -h. Luați în considerare un plan de server mai mare |
| Nu se poate conecta la baza de date externă | Verificați host-ul, portul și datele de acces ale bazei de date. Asigurați-vă că firewall-ul bazei de date la distanță permite conexiuni de la IP-ul serverului |
| Ați uitat parola de administrator Metabase | Resetare prin SSH: java -jar /opt/metabase/metabase.jar reset-password EMAIL |
| Blocat de Fail2Ban | Deblocați-vă IP-ul prin consola VNC din panoul clientului |
| Ați uitat parola root | Resetați-o prin consola VNC din panoul clientului |