Matomo - príručka pre začiatočníkov
Matomo je open-source platforma na webovú analytiku a alternatíva ku Google Analytics zameraná na súkromie. Dáta z analytiky plne vlastníte – všetko je uložené na vašom serveri a nezdieľa sa s tretími stranami. Pomocou Matomo sledujte návštevníkov webu, analyzujte zdroje návštevnosti, merajte konverzie a porozumejte správaniu používateľov.
Krok 1 – Overte, že Matomo 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
Mali by ste vidieť uvítaciu stránku sprievodcu nastavením Matomo. Ak sa stránka načíta, Matomo funguje správne – pokračujte krokom 2 a pred dokončením sprievodcu si zistite prihlasovacie údaje k databáze.
Ak ste server umiestnili za router VyOS v privátnej sieti, nastavte presmerovanie portov 22 (SSH), 80 (HTTP) a 443 (HTTPS). Matomo musí byť dostupné z internetu, aby mohlo prijímať dáta zo sledovania vašich webov.
Krok 2 – Získanie prihlasovacích údajov k databáze
Databáza pre Matomo je na serveri už vytvorená. Pripojte sa cez SSH a zobrazte prihlasovacie údaje:
ssh root@your.server.ip
Po prihlásení uvidíte uvítaciu správu s prihlasovacími údajmi k databáze:
=== Matomo Web Analytics ===
Open http://your.server.ip to complete setup wizard
Database credentials for setup wizard:
Server: localhost
Login: matomo
Password: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Database: matomo
Prefix: matomo_
Tieto údaje si uložte – budete ich potrebovať v ďalšom kroku.
Krok 3 – Dokončenie sprievodcu nastavením
Vráťte sa v prehliadači k sprievodcovi nastavením Matomo. Sprievodca vás prevedie úvodnou konfiguráciou:
Kontrola systému
Matomo overí, že sú splnené všetky požiadavky. Môže sa zobraziť varovanie o SSL – je to normálne, SSL možno nastaviť neskôr. Kliknite na Next.
Nastavenie databázy
Zadajte tieto údaje na pripojenie:
| Database Server | localhost |
| Login | matomo |
| Heslo | heslo z uvítacej správy (krok 2) |
| Database Name | matomo |
| Table Prefix | matomo_ |
Vytvorenie tabuliek
Matomo automaticky vytvorí potrebné tabuľky v databáze. Kliknite na Next.
Superpoužívateľ
Vytvorte účet administrátora – zadajte prihlasovacie meno, heslo a e-mail. S týmito údajmi sa budete prihlasovať do Matomo.
Nastavenie webu
Pridajte prvý web na sledovanie – zadajte názov a URL webu. Ďalšie weby môžete pridať neskôr.
Sledovací kód
Matomo zobrazí úryvok sledovacieho kódu v JavaScripte. Skopírujte ho a vložte pred uzatváraciu značku </head> na každej stránke webu, ktorý chcete sledovať. Môžete to urobiť aj neskôr z nástenky Matomo.
Gratulujeme
Nastavenie je dokončené. Kliknite na Continue to Matomo a prihláste sa práve vytvorenými údajmi superpoužívateľa.
Krok 4 – Nastavenie domény a SSL (voliteľné)
Používanie Matomo 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 spustite Certbot na získanie bezplatného certifikátu SSL Let’s Encrypt:
certbot --apache -d your-domain.com
Certbot automaticky nastaví Apache pre HTTPS a automatickú obnovu certifikátu.
Po získaní certifikátu pridajte doménu do zoznamu dôveryhodných hostiteľov Matomo: prejdite do Administration → System → General Settings → Trusted Matomo hostname.
Po inštalácii
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
# Check service status
systemctl status apache2
systemctl status mysql
# Restart services
systemctl restart apache2
systemctl restart mysql
# Apache error log
tail -f /var/log/apache2/error.log
Pridanie ďalších webov
Z jednej inštancie Matomo môžete sledovať viac webov. Prejdite do Administration → Measurables → Manage → Add a new measurable a pridajte ďalšie weby. Každý web má vlastný sledovací kód a oddelené analytické dáta.
Správa používateľov
Pridanie členov tímu s rôznymi úrovňami prístupu:
- Prejdite na Administration → System → Users
- Kliknite na Add a new user
- Nastavte používateľské meno, e-mail a heslo
- Priraďte oprávnenia: View, Write, Admin alebo Superpoužívateľ pre každý web
Aktualizácie
Matomo zobrazuje oznámenia o aktualizáciách v administračnej nástenke. Postup aktualizácie:
- Prejdite na Administration → Platform → Marketplace
- Ak je dostupná aktualizácia jadra, postupujte podľa pokynov na obrazovke
Aktualizácia systémových balíčkov cez SSH:
apt update && apt upgrade -y
Zálohy
Ručná záloha databázy Matomo:
mysqldump -u root matomo > /root/matomo-backup-$(date +%F).sql
Konfiguračný súbor Matomo sa nachádza v /var/www/html/config/config.ini.php. Zahrňte ho do záloh.
Zahrnutý softvér
| Komponent | Verzia |
|---|---|
| Ubuntu | 24.04 LTS |
| Matomo | Najnovšia |
| Apache | 2.4 |
| MySQL | 8.0 |
| PHP | 8.3 |
| Certbot | Najnovšia |
| Fail2Ban | 1.0.2 |
Riešenie problémov
| Problém | Riešenie |
|---|---|
| Nedá sa otvoriť Matomo v prehliadači | Kontrola stavu Apache: systemctl status apache2. V prípade potreby reštartujte: systemctl restart apache2 |
| Zabudnuté heslo administrátora Matomo | Reset cez CLI: php /var/www/html/console user:reset-password --login=admin |
| Certifikát SSL nefunguje | Overte, že DNS smeruje na IP servera: dig your-domain.com. Znova spustite: certbot --apache -d your-domain.com |
| Sledovací kód nezaznamenáva návštevy | Uistite sa, že je sledovací úryvok umiestnený pred </head>. Skontrolujte, či URL Matomo v úryvku zodpovedá adrese servera. Na testovanie vypnite blokovače reklám. |
| Chyba pripojenia k databáze | Kontrola stavu MySQL: systemctl status mysql. V prípade potreby reštartujte: systemctl restart mysql |
| Zablokované službou Fail2Ban | Odblokujte svoju IP cez konzolu VNC v klientskom paneli |
| Zabudnuté heslo root | Obnovte ho cez konzolu VNC v klientskom paneli |