Table of Contents

Matomo - ghid de inițiere

Matomo este o platformă open-source de analiză web și o alternativă la Google Analytics axată pe confidențialitate. Datele de analiză vă aparțin în întregime – totul este stocat pe serverul dumneavoastră, fără a fi partajat cu terți. Folosiți Matomo pentru a urmări vizitatorii site-ului, a analiza sursele de trafic, a măsura conversiile și a înțelege comportamentul utilizatorilor.


Pasul 1 – Verificați funcționarea Matomo

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

Ar trebui să vedeți pagina de bun venit a asistentului de configurare Matomo. Dacă pagina se încarcă, Matomo funcționează corect – continuați cu Pasul 2 pentru a obține datele de acces la baza de date înainte de a finaliza asistentul.

Dacă ați plasat serverul în spatele unui router VyOS într-o rețea privată, configurați redirecționarea porturilor 22 (SSH), 80 (HTTP) și 443 (HTTPS). Matomo trebuie să fie accesibil de pe internet pentru a primi date de urmărire de la site-uri.


Pasul 2 – Obținerea datelor de acces la baza de date

Baza de date pentru Matomo este deja creată pe server. Conectați-vă prin SSH pentru a vedea datele de acces:

ssh root@your.server.ip

După autentificare, veți vedea un mesaj de bun venit cu datele de acces la baza de date:

=== 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_

Salvați aceste date – veți avea nevoie de ele la pasul următor.


Pasul 3 – Finalizarea asistentului de configurare

Reveniți la asistentul de configurare Matomo din browser. Asistentul vă va ghida prin configurarea inițială:

Verificarea sistemului

Matomo verifică dacă toate cerințele sunt îndeplinite. Puteți vedea un avertisment SSL – este normal, SSL poate fi configurat ulterior. Faceți clic pe Next.

Configurarea bazei de date

Introduceți următoarele date de conectare:

Database Serverlocalhost
Loginmatomo
Parolăparola din mesajul de bun venit (Pasul 2)
Database Namematomo
Table Prefixmatomo_

Crearea tabelelor

Matomo va crea automat tabelele necesare în baza de date. Faceți clic pe Next.

Super utilizator

Creați contul de administrator – introduceți un nume de utilizator, o parolă și un e-mail. Acestea sunt datele cu care vă veți autentifica în Matomo.

Configurarea unui site

Adăugați primul site de urmărit – introduceți numele și URL-ul site-ului. Puteți adăuga mai multe site-uri ulterior.

Cod de urmărire

Matomo vă va afișa un fragment de cod de urmărire JavaScript. Copiați-l și lipiți-l înainte de eticheta de închidere </head> pe fiecare pagină a site-ului pe care doriți să-l urmăriți. Puteți face acest lucru și mai târziu din dashboard-ul Matomo.

Felicitări

Configurarea este finalizată. Faceți clic pe Continue to Matomo și autentificați-vă cu datele de super utilizator tocmai create.


Pasul 4 – Configurarea domeniului și SSL (opțional)

Pentru a folosi Matomo cu domeniul propriu și HTTPS:

  1. Creați o înregistrare A în setările DNS care direcționează domeniul către IP-ul serverului
  2. Așteptați propagarea DNS (de obicei câteva minute până la câteva ore)
  3. Conectați-vă prin SSH și rulați Certbot pentru a obține un certificat SSL gratuit Let’s Encrypt:
certbot --apache -d your-domain.com

Certbot va configura automat Apache pentru HTTPS și reînnoirea automată a certificatului.

După obținerea certificatului, adăugați domeniul în lista de gazde de încredere Matomo: accesați Administration → System → General Settings → Trusted Matomo hostname.


După instalare

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
SSH5 autentificări eșuate10 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

# 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

Adăugarea mai multor site-uri

Puteți urmări mai multe site-uri dintr-o singură instanță Matomo. Accesați Administration → Measurables → Manage → Add a new measurable pentru a adăuga site-uri suplimentare. Fiecare site primește propriul cod de urmărire și date de analiză separate.

Administrarea utilizatorilor

Pentru a adăuga membri ai echipei cu niveluri diferite de acces:

  1. Accesați Administration → System → Users
  2. Faceți clic pe Add a new user
  3. Setați numele de utilizator, e-mailul și parola
  4. Atribuiți permisiuni: View, Write, Admin sau Super utilizator per site

Actualizări

Matomo afișează notificări de actualizare în dashboard-ul de administrare. Pentru actualizare:

  1. Accesați Administration → Platform → Marketplace
  2. Dacă este disponibilă o actualizare a nucleului, urmați instrucțiunile de pe ecran

Pentru a actualiza pachetele sistemului prin SSH:

apt update && apt upgrade -y

Backup-uri

Pentru a crea un backup manual al bazei de date Matomo:

mysqldump -u root matomo > /root/matomo-backup-$(date +%F).sql

Fișierul de configurare Matomo se află în /var/www/html/config/config.ini.php. Includeți-l în backup-uri.


Software inclus

Componentă Versiune
Ubuntu24.04 LTS
MatomoCea mai recentă
Apache2.4
MySQL8.0
PHP8.3
CertbotCea mai recentă
Fail2Ban1.0.2

Depanare

Problemă Soluție
Matomo nu se deschide în browser Verificați starea Apache: systemctl status apache2. Reporniți dacă este necesar: systemctl restart apache2
Ați uitat parola de administrator Matomo Resetare prin CLI: php /var/www/html/console user:reset-password --login=admin
Certificatul SSL nu funcționează Verificați că DNS-ul indică IP-ul serverului: dig your-domain.com. Rulați din nou: certbot --apache -d your-domain.com
Codul de urmărire nu înregistrează vizite Asigurați-vă că fragmentul de urmărire este plasat înainte de </head>. Verificați că URL-ul Matomo din fragment corespunde adresei serverului. Dezactivați blocantele de reclame pentru testare.
Eroare de conectare la baza de date Verificați starea MySQL: systemctl status mysql. Reporniți dacă este necesar: systemctl restart mysql
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