Wie man Matomo Webanalyse auf Debian 12 installiert

Matomo, früher Piwik, ist eine kostenlose und Open-Source-Webanalyse-Software, die verwendet werden kann, um Website-Besuche zu verfolgen und Berichte für Daten- und Zielgruppenanalysen anzuzeigen. Matomo ist unter der GPL-Lizenz lizenziert, in PHP geschrieben und kann mit einem MySQL- oder MariaDB-Datenbankserver betrieben werden.

Matomo bietet aufschlussreiche Berichte zur Benutzerverfolgung auf Ihren Websites. Dazu gehören die verweisende Suchmaschine und Schlüsselwörter, Sprachen, Seitenbesuche, Downloads von Dateien und mehr. Matomo ist als Alternative zu Analyse-Diensten wie Google Analytics zunehmend beliebt geworden.

In diesem Tutorial lernen Sie, wie Sie Matomo Webanalyse auf dem Debian 12-Server installieren. Sie richten Matomo mit dem LAMP-Stack ein und sichern Matomo mit HTTPS über Certbot und Letsencrypt.

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie Folgendes haben:

Einen Debian 12-Server.
Einen Nicht-Root-Benutzer mit Administratorrechten.
Einen Domainnamen, der auf eine Server-IP-Adresse zeigt.

Abhängigkeiten installieren

Matomo ist eine PHP-basierte Webanalyse, die MySQL/MariaDB als Datenbank verwendet. Um Matomo zu installieren, müssen Sie den LAMP (Linux, Apache, MySQL/MariaDB und PHP) oder LEMP (Linux, Nginx, MySQL/MariaDB und PHP-FPM) Stack auf Ihrem System installieren. In diesem Beispiel führen Sie Matomo mit dem LAMP-Stack auf dem Debian-Server aus.

Zuerst führen Sie den folgenden apt-Befehl aus, um Ihr Debian-Paket-Index zu aktualisieren.

sudo apt update

Jetzt installieren Sie die LAMP-Stack (Linux, Apache, MySQL/MariaDB und PHP) Pakete mit dem folgenden Befehl:

sudo apt install apache2 mariadb-server php php-cli libapache2-mod-php php-common php-curl php-gd php-mbstring php-mysql php-xml php-intl php-zip wget unzip

Geben Sie Y ein, um die Installation zu bestätigen.

install deps

Nachdem die Installation abgeschlossen ist, überprüfen Sie den Status des MariaDB-Servers mit dem folgenden Befehl. Sie sehen den MariaDB-Server mit dem Status aktiv (laufend) und aktiviert.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

check mariadb

Überprüfen Sie jetzt den Status des Apache-Dienstes mit dem folgenden Befehl. In der folgenden Ausgabe können Sie sehen, dass der Apache-Webserver läuft.

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

check apache

Führen Sie zuletzt den php-Befehl aus, um die PHP-Version zu überprüfen. Sie sehen, dass PHP 8.3 installiert ist.

php -v

check php

PHP konfigurieren

Nachdem Sie den LAMP-Stack installiert haben, konfigurieren Sie die PHP-Installation, indem Sie die php.ini-Datei bearbeiten und den Apache-Webserver neu starten.

Öffnen Sie die Standard-PHP-Konfiguration /etc/php/8.3/apache2/php.ini mit dem folgenden nano-Editor.

sudo nano /etc/php/8.3/apache2/php.ini

Ändern Sie die Standardkonfiguration wie folgt - Stellen Sie sicher, dass Sie sowohl die date.timezone- als auch die memory_limit-Optionen mit Ihrer aktuellen Serverumgebung ändern.

date.timezone = Europe/Stockholm  
memory_limit = 256M  
upload_max_filesize = 16M  
max_execution_time = 300

Speichern Sie die Datei und beenden Sie den Editor.

Führen Sie jetzt den systemctl-Befehl aus, um den Apache-Webserver neu zu starten und Ihre Änderungen an PHP anzuwenden.

sudo systemctl restart apache2

MariaDB-Server konfigurieren

In diesem Abschnitt sichern Sie den MariaDB-Server und richten das Root-Passwort dafür ein. Dann erstellen Sie eine neue Datenbank und einen Benutzer, die von Matomo verwendet werden.

Führen Sie den mariadb-secure-installation-Befehl aus, um MariaDB zu sichern und das Root-Passwort einzurichten.

sudo mariadb-secure-installation

Jetzt werden Sie nach den folgenden Konfigurationen gefragt:

Lokale Authentifizierung auf unix_socket umschalten? Geben Sie n ein.
Richten Sie das neue MariaDB-Root-Passwort ein. Geben Sie y ein, um zu bestätigen, und geben Sie dann das neue Passwort für Ihre MariaDB-Serverbereitstellung ein.
Anonymer Benutzer entfernen? Geben Sie y ein, um zu bestätigen.
Die Standarddatenbank-Test von der Bereitstellung entfernen? Geben Sie y ein, um zu bestätigen.
MariaDB-Root-Login von Remote-Verbindungen verweigern? Geben Sie y ein, um zu bestätigen.
Tabellenberechtigungen neu laden und die Änderungen anwenden? Geben Sie y ein und drücken Sie ENTER.

Führen Sie als Nächstes den mariadb-Befehl aus, um sich beim MariaDB-Server anzumelden. Geben Sie Ihr Root-Passwort ein, wenn Sie dazu aufgefordert werden.

sudo mariadb -u root -p

Führen Sie jetzt die folgenden Abfragen aus, um eine neue Datenbank und den Benutzer matomo mit dem Passwort p4ssword zu erstellen. Passen Sie die Datenbankdetails unten an.

CREATE DATABASE matomo;  
CREATE USER 'matomo'@'localhost' IDENTIFIED BY 'p4ssword';  
GRANT SELECT, INSERT, UPDATE, DELETE, CREATE, INDEX, DROP, ALTER, CREATE TEMPORARY TABLES, LOCK TABLES ON matomo.* TO 'matomo'@'localhost';  
FLUSH PRIVILEGES;

Führen Sie zuletzt die Abfrage aus, um den Benutzer matomo@localhost zu überprüfen und vom MariaDB-Server zu beenden. Dies stellt sicher, dass der Benutzer matomo@localhost auf die Datenbank matomo zugreifen kann.

SHOW GRANTS FOR matomo@localhost;  
quit

check db user

Matomo-Quellcode herunterladen

Jetzt, da Sie PHP konfiguriert und eine Datenbank und einen Benutzer erstellt haben, können Sie Matomo installieren. Jetzt laden Sie den Matomo-Quellcode herunter, richten das Dokumentenstammverzeichnis ein und ändern dann den Besitz mit dem richtigen Apache-Benutzer.

Gehen Sie zum Verzeichnis /var/www und laden Sie den Matomo-Quellcode mit dem folgenden wget-Befehl herunter.

cd /var/www/  
wget https://builds.matomo.org/matomo.zip

Sobald der Download abgeschlossen ist, führen Sie den unzip-Befehl aus, um die matomo.zip-Datei zu extrahieren. Ändern Sie dann den Besitz des Verzeichnisses /var/www/matomo auf den Benutzer www-data.

unzip matomo.zip  
sudo chown -R www-data:www-data /var/www/matomo

Apache-virtuellen Host einrichten

Nachdem Sie Matomo heruntergeladen haben, erstellen Sie eine neue Apache-virtuelle Hostdatei für Matomo. Stellen Sie sicher, dass Ihr Domainname auf eine Server-IP-Adresse zeigt.

Erstellen Sie eine neue Apache-virtuelle Hostdatei /etc/apache2/sites-available/matomo.conf mit dem nano-Editor.

sudo nano /etc/apache2/sites-available/matomo.conf

Fügen Sie die folgende Konfiguration ein und stellen Sie sicher, dass Sie die ServerName-Option mit Ihrem Domainnamen ersetzen.


    ServerAdmin webmaster@localhost
    ServerName matomo.howtoforge.local
    DocumentRoot /var/www/matomo/

    
        DirectoryIndex index.php
        Options FollowSymLinks
        AllowOverride All
        Require all granted
    

    
        Options None
        Require all denied
    

    
        Options None
        Require all granted
    

    
        Options None
        Require all denied
    

    
        Options None
        Require all denied
    

    ErrorLog ${APACHE_LOG_DIR}/matomo_error.log
    CustomLog ${APACHE_LOG_DIR}/matomo_access.log combined

Speichern Sie die Datei und beenden Sie sie, wenn Sie fertig sind.

Führen Sie jetzt den a2ensite-Befehl aus, um die matomo.conf-Datei zu aktivieren. Führen Sie dann den apachectl-Befehl aus, um Ihre Apache-Konfiguration zu überprüfen. Wenn Sie eine korrekte Apache-Syntax haben, sehen Sie eine Ausgabe Syntax is OK.

sudo a2ensite matomo.conf  
sudo apachectl configtest

Führen Sie zuletzt den systemctl-Befehl aus, um den Apache-Webserver neu zu starten und Ihre Änderungen anzuwenden. Sobald Apache neu gestartet wurde, ist Ihre Matomo-Installation bereit.

sudo systemctl restart apache2

setup apache

Matomo mit HTTPS sichern

In diesem Abschnitt generieren Sie SSL/TLS-Zertifikate und sichern Matomo mit HTTPS über Certbot und Letsencrypt.

Installieren Sie die Pakete certbot und python3-certbot-apache mit dem folgenden Befehl.

sudo apt install certbot python3-certbot-apache

Führen Sie jetzt den certbot-Befehl aus, um SSL-Zertifikate zu generieren und Ihren Matomo-Domainnamen zu sichern. Stellen Sie sicher, dass Sie den Domainnamen und die E-Mail-Adresse mit Ihren Informationen ändern.

sudo certbot --apache --agree-tos --redirect --hsts --staple-ocsp --email [email protected] -d matomo.howtoforge.local

Nachdem der Vorgang abgeschlossen ist, sind Ihre SSL-Zertifikate im Verzeichnis /etc/letsencrypt/live/donmain.com verfügbar. Außerdem ist Ihre Matomo-Installation mit HTTPS gesichert.

Matomo Webanalyse installieren

Öffnen Sie Ihren Webbrowser und besuchen Sie Ihren Matomo-Domainnamen wie https://matomo.howtoforge.local/. Wenn die Installation erfolgreich ist, sehen Sie die Willkommensnachricht wie folgt:

Klicken Sie auf Weiter, um die Installation zu bestätigen.

welcome message

Überprüfen Sie im Abschnitt Systemcheck, ob Ihr System bereit ist, und klicken Sie erneut auf Weiter.

system check

Geben Sie jetzt die Details ein, einschließlich des MariaDB-Datenbanknamens, Benutzers und Passworts, und klicken Sie dann auf Weiter, um die Datenbank zu migrieren.

setup database

Sobald die Migration abgeschlossen ist, klicken Sie erneut auf Weiter.

database migration

Geben Sie einen neuen Administratorbenutzernamen, eine E-Mail-Adresse und ein Passwort für die Matomo-Webanalyse ein.

setup admin

Geben Sie jetzt Informationen ein, um das erste Tracking mit Matomo zu erstellen, und klicken Sie auf Weiter.

create first tracking

Kopieren Sie den generierten Tracking-Code und klicken Sie auf Weiter.

tracking code

Nachdem die Installation abgeschlossen ist, sehen Sie die folgenden Nachrichten:

install complete

Wenn Sie die Matomo-Startseite besuchen, werden Sie zur Matomo-Anmeldeseite weitergeleitet. Geben Sie Ihren Admin-Benutzer und Ihr Passwort ein und klicken Sie auf ANMELDEN.

logging in

Nach der Anmeldung sehen Sie das folgende Matomo-Administrations-Dashboard:

dashboard

Fazit

Herzlichen Glückwunsch! Sie haben die Installation von Matomo Webanalyse auf dem Debian 12-Server abgeschlossen. Matomo Webanalyse läuft mit dem Apache-Webserver, dem MariaDB-Datenbankserver und PHP 8.3. Sie haben Matomo auch mit HTTPS über Certbot und Letsencrypt gesichert.