Table of Contents

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 Serverlocalhost
Loginmatomo
Hesloheslo z uvítacej správy (krok 2)
Database Namematomo
Table Prefixmatomo_

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:

  1. Vytvorte A záznam v nastaveniach DNS, ktorý nasmeruje vašu doménu na IP servera
  2. Počkajte na rozšírenie DNS (zvyčajne niekoľko minút až niekoľko hodín)
  3. 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
SSH5 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:

  1. Prejdite na Administration → System → Users
  2. Kliknite na Add a new user
  3. Nastavte používateľské meno, e-mail a heslo
  4. 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:

  1. Prejdite na Administration → Platform → Marketplace
  2. 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
Ubuntu24.04 LTS
MatomoNajnovšia
Apache2.4
MySQL8.0
PHP8.3
CertbotNajnovšia
Fail2Ban1.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