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 Server | localhost |
| Login | matomo |
| Parolă | parola din mesajul de bun venit (Pasul 2) |
| Database Name | matomo |
| Table Prefix | matomo_ |
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:
- 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 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 |
|---|---|---|
| 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
# 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:
- Accesați Administration → System → Users
- Faceți clic pe Add a new user
- Setați numele de utilizator, e-mailul și parola
- 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:
- Accesați Administration → Platform → Marketplace
- 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 |
|---|---|
| Ubuntu | 24.04 LTS |
| Matomo | Cea mai recentă |
| Apache | 2.4 |
| MySQL | 8.0 |
| PHP | 8.3 |
| Certbot | Cea mai recentă |
| Fail2Ban | 1.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 |