Comment installer Matomo Web Analytics sur Debian 9

Matomo (anciennement Piwik) est une application d’analyse web gratuite et open source développée par une équipe de développeurs internationaux, qui fonctionne sur un serveur web PHP / MySQL. Il suit les visites en ligne d’un ou plusieurs sites web et affiche des rapports sur ces visites pour analyse. Vous pouvez le considérer comme une alternative à Google Analytics. Matomo est open source et son code est disponible publiquement sur Github. Certaines de ses fonctionnalités incluent : A/B Testing, Heatmaps, Funnels, Tracking et Reporting API, Google AdWords, Facebook Ads, Bing Ads, Coût Par Clic (CPC), etc. Ce tutoriel vous montrera comment installer Matomo sur un système Debian 9 (stretch) en utilisant Nginx comme serveur web et nous sécuriserons le site avec un certificat SSL Let’s Encrypt.

Exigences

Pour faire fonctionner Matomo (Piwik) sur votre système Debian, vous aurez besoin de quelques éléments :

• Serveur web tel qu’Apache ou Nginx.
• Version PHP 5.5.9 ou supérieure avec les extensions pdo et pdo_mysql ou mysqli, gd, xml, curl et mbstring. PHP 7+ est recommandé.
• Version MySQL 5.5 ou supérieure, ou la version équivalente de MariaDB. MySQL 5.7+ est recommandé.

Prérequis

• Un système d’exploitation fonctionnant sous Debian 9 (stretch).
• Un utilisateur non-root avec des privilèges sudo.

Étapes initiales

Vérifiez votre version de Debian :

lsb_release -ds  
# Debian GNU/Linux 9.6 (stretch)

Configurez le fuseau horaire :

dpkg-reconfigure tzdata

Mettez à jour les paquets de votre système d’exploitation (logiciel). C’est une première étape importante car elle garantit que vous disposez des dernières mises à jour et correctifs de sécurité pour les paquets logiciels par défaut de votre système d’exploitation :

apt update && apt upgrade -y

Installez quelques paquets essentiels nécessaires à l’administration de base du système d’exploitation Debian :

apt install -y curl wget vim git unzip socat sudo

Étape 1 - Installer MySQL et créer une base de données pour Matomo

Matomo prend en charge les bases de données MySQL et MariaDB. L’équipe Debian a remplacé MySQL par MariaDB comme base de données par défaut à partir de Debian 9 (stretch), donc dans ce tutoriel, nous utiliserons MariaDB comme serveur de base de données. Si vous souhaitez installer l’original MySQL, vous pouvez ajouter et utiliser le dépôt MySQL officiel maintenu par Oracle.

Installez le serveur de base de données MariaDB :

sudo apt install -y mariadb-server

Vérifiez la version de MariaDB :

mysql --version  
# mysql  Ver 14.14 Distrib 5.7.24, for Linux (x86_64) using  EditLine wrapper

Exécutez le script mysql_secure_installation pour améliorer la sécurité de MariaDB et définir le mot de passe pour l’utilisateur root de MariaDB :

sudo mysql_secure_installation

Répondez à chacune des questions :

Entrez le mot de passe actuel pour root (appuyez sur Entrée pour aucun) : Appuyez sur Entrée  
Définir le mot de passe root ? [Y/n] y  
Nouveau mot de passe : votre_mot_de_passe_sécurisé  
Ressaisissez le nouveau mot de passe : votre_mot_de_passe_sécurisé  
Supprimer les utilisateurs anonymes ? [Y/n] Y  
Interdire la connexion root à distance ? [Y/n] Y  
Supprimer la base de données de test et l'accès à celle-ci ? [Y/n] Y  
Recharger les tables de privilèges maintenant ? [Y/n] Y**``

Connectez-vous à l’interface de commande de MariaDB en tant qu’utilisateur root :

sudo mysql -u root -p  
# Entrez le mot de passe  

Créez une base de données MariaDB vide et un utilisateur pour Matomo et retenez les identifiants :

mysql> CREATE DATABASE dbname;  
mysql> GRANT ALL ON dbname.* TO 'username' IDENTIFIED BY 'password';  
mysql> FLUSH PRIVILEGES;

Quittez MariaDB :

mysql> exit

Remplacez dbname, username et password par vos propres noms.

Étape 2 - Installer PHP et les extensions PHP nécessaires

Installez PHP, ainsi que les extensions PHP nécessaires :

sudo apt install -y php7.0 php7.0-cli php7.0-fpm php7.0-common php7.0-curl php7.0-gd php7.0-xml php7.0-mbstring php7.0-mysql

Vérifiez la version de PHP :

php --version  
  
# PHP 7.0.33-0+deb9u1 (cli) (construit : 7 déc. 2018 11:36:49) ( NTS )  
# Copyright (c) 1997-2017 The PHP Group  
# Zend Engine v3.0.0, Copyright (c) 1998-2017 Zend Technologies  
#     avec Zend OPcache v7.0.33-0+deb9u1, Copyright (c) 1999-2017, par Zend Technologies  

Le service PHP-FPM est automatiquement démarré et activé au démarrage sur le système Debian 9, donc il n’est pas nécessaire de le démarrer et de l’activer manuellement. Nous pouvons passer à l’étape suivante, qui consiste à obtenir des certificats SSL gratuits de Let’s Encrypt CA.

Étape 3 - Installer le client acme.sh et obtenir le certificat Let’s Encrypt (optionnel)

Sécuriser votre site web avec HTTPS n’est pas nécessaire, mais c’est une bonne pratique pour sécuriser le trafic de votre site. Afin d’obtenir un certificat TLS de Let’s Encrypt, nous utiliserons le client acme.sh. Acme.sh est un logiciel shell Unix pur pour obtenir des certificats TLS de Let’s Encrypt sans dépendances.

Téléchargez et installez acme.sh :

sudo mkdir /etc/letsencrypt  
git clone https://github.com/Neilpang/acme.sh.git  
cd acme.sh  
sudo ./acme.sh --install --home /etc/letsencrypt --accountemail [email protected]  
cd ~

Vérifiez la version d’acme.sh :

/etc/letsencrypt/acme.sh --version  
# v2.8.0

Obtenez des certificats RSA et ECC/ECDSA pour votre domaine/nom d’hôte :

# RSA 2048  
sudo /etc/letsencrypt/acme.sh --issue --standalone --home /etc/letsencrypt -d example.com --keylength 2048  
# ECDSA  
sudo /etc/letsencrypt/acme.sh --issue --standalone --home /etc/letsencrypt -d example.com --keylength ec-256

Après avoir exécuté les commandes ci-dessus, vos certificats et clés seront dans :

• Pour RSA : le répertoire /etc/letsencrypt/example.com.
• Pour ECC/ECDSA : le répertoire /etc/letsencrypt/example.com_ecc.

Étape 3 - Installer NGINX et configurer NGINX pour Matomo

Matomo peut fonctionner correctement avec de nombreux logiciels de serveur web populaires. Dans ce tutoriel, nous avons choisi Nginx.

Téléchargez et installez Nginx depuis le dépôt Debian :

sudo apt install -y nginx

Vérifiez la version de Nginx :

sudo nginx -v  
# version nginx : nginx/1.10.3

Configurez Nginx pour Matomo en exécutant :

sudo vim /etc/nginx/sites-available/matomo.conf  

Et remplissez le fichier avec la configuration suivante :

server {  
  
  listen [::]:443 ssl http2;  
  listen 443 ssl http2;  
  listen [::]:80;  
  listen 80;  
  
  server_name example.com;  
  root /var/www/matomo/;  
  index index.php;  
  
  ssl_certificate /etc/letsencrypt/example.com/fullchain.cer;   
  ssl_certificate_key /etc/letsencrypt/example.com/example.com.key;   
  ssl_certificate /etc/letsencrypt/example.com_ecc/fullchain.cer;  
  ssl_certificate_key /etc/letsencrypt/example.com_ecc/example.com.key;  
  
  location ~ ^/(index|matomo|piwik|js/index).php {  
    include snippets/fastcgi-php.conf;  
    fastcgi_param HTTP_PROXY "";   
    fastcgi_pass unix:/var/run/php/php7.0-fpm.sock;   
  }    
  
  location = /plugins/HeatmapSessionRecording/configs.php {  
    include snippets/fastcgi-php.conf;  
    fastcgi_param HTTP_PROXY "";  
    fastcgi_pass unix:/var/run/php/php7.0-fpm.sock;  
  }  
  
  location ~* ^.+\.php$ {  
    deny all;  
    return 403;  
  }  
  
  location / {  
    try_files $uri $uri/ =404;  
  }    
  
  location ~ /(config|tmp|core|lang) {  
    deny all;  
    return 403;  
  }  
  
  location ~ \.(gif|ico|jpg|png|svg|js|css|htm|html|mp3|mp4|wav|ogg|avi|ttf|eot|woff|woff2|json)$ {  
    allow all;  
  }  
  
  location ~ /(libs|vendor|plugins|misc/user) {  
    deny all;  
    return 403;  
  }  
  
}

REMARQUE : Pour une configuration Nginx complète et prête pour la production pour Matomo, visitez https://github.com/matomo-org/matomo-nginx.

Activez la nouvelle configuration matomo.conf en liant le fichier au répertoire sites-enabled.

sudo ln -s /etc/nginx/sites-available/matomo.conf /etc/nginx/sites-enabled

Vérifiez la configuration de Nginx pour des erreurs de syntaxe :

sudo nginx -t

Rechargez le service Nginx :

sudo systemctl reload nginx.service

Étape 4 - Installer Matomo Analytics

Créez le répertoire /var/www :

sudo mkdir -p /var/www

Naviguez vers le répertoire /var/www :

cd /var/www/

Téléchargez la dernière version de Matomo via wget et décompressez-la :

sudo wget https://builds.matomo.org/matomo.zip && sudo unzip matomo.zip  

Supprimez le fichier matomo.zip téléchargé :

sudo rm matomo.zip

Changez la propriété du répertoire /var/www/matomo à l’utilisateur www-data :

sudo chown -R www-data:www-data /var/www/matomo

Étape 5 - Compléter la configuration de Matomo Analytics

Ouvrez votre site dans un navigateur web et suivez l’assistant d’installation web de Matomo.

Tout d’abord, le message de bienvenue de Matomo devrait apparaître. Cliquez sur le bouton “Suivant” :

Ensuite, vous verrez une page “Vérification du système”. Si quelque chose manque, vous verrez un avertissement. Si tout est marqué avec une coche verte, cliquez sur le bouton “Suivant” pour passer à l’étape suivante :

Ensuite, remplissez les détails de la base de données et cliquez sur le bouton “Suivant” :

Si tout s’est bien passé avec la configuration de la base de données, vous devriez voir le message “Tables créées avec succès !” :

Créez un compte super utilisateur Matomo et cliquez sur le bouton “Suivant” :

Ensuite, configurez le premier site web que vous souhaitez suivre et analyser avec Matomo. Plus tard, vous pourrez ajouter d’autres sites à suivre avec Matomo :

Ensuite, vous recevrez le code de suivi JavaScript pour votre site que vous devez ajouter pour commencer à suivre.

Ensuite, vous devriez voir que l’installation de Matomo est terminée.

Félicitations ! Votre installation de Matomo est complète.

Liens

• https://matomo.org/
• https://github.com/matomo-org/matomo
• https://github.com/matomo-org/matomo-nginx