So installierst du Plausible Analytics mit Docker unter Ubuntu 22.04
Plausible ist eine Open-Source-Webanalyse-Alternative zu Google Analytics. Es ist eine leichtgewichtige und datenschutzfreundliche Webanalyse, die für verschiedene Branchen wie Startups, Freiberufler und Blogger genutzt werden kann.
Plausible ist eine leichtgewichtige und einfache Webanalyse. Es bietet wichtige Kennzahlen auf einer einzigen Seite, was es Webmastern leichter macht, Kennzahlen zu analysieren. Plausible ist in zwei Versionen erhältlich, dem kostenpflichtigen Plausible Service und dem selbst gehosteten Plausible, das du auf deinem Server installieren kannst.
Mit Plausible Analytics kannst du selbst gehostete Website-Analysen auf deinem Server erstellen und Websites unbegrenzt tracken. In dieser Anleitung erfährst du, wie du Plausible Analytics über Docker auf einem Ubuntu 22.04 Server installierst und konfigurierst. Außerdem wirst du Nginx als Reverse Proxy für die Plausible Analytics-Anwendung einrichten und SSL über Letsencrypt einrichten.
Vorraussetzungen
Für diesen Leitfaden brauchst du die folgenden Voraussetzungen:
- Einen Ubuntu 22.04 Server – In diesem Beispiel wird ein Server mit dem Hostnamen„plausible-server“ verwendet.
- Einen Nicht-Root-Benutzer mit sudo/root-Administrator-Rechten.
- Ein Domainname oder eine Subdomain, die auf die IP-Adresse des Servers zeigt – In diesem Beispiel wird die Subdomain„plausible.hwdomain.io“ verwendet.
Installation von Docker CE (Community Edition)
Plausible Analytics kann über Docker auf jedem Betriebssystem, das die Docker-Engine unterstützt, bereitgestellt und selbst gehostet werden. Dazu musst du zunächst die Docker Engine auf dem Zielrechner installieren, auf dem du die Plausible-Anwendung einsetzen möchtest.
Beginne mit dieser Anleitung, indem du die Docker CE (Community Edition) über das offizielle Docker-Repository auf deinem Ubuntu-Server installierst.
Führe den folgenden apt-Befehl aus, um einige grundlegende Abhängigkeiten zu installieren. Wenn du nach der Konfiguration gefragt wirst, gib y ein und drücke ENTER, um fortzufahren.
sudo apt install \ ca-certificates \ curl \ gnupg \ lsb-release
Als nächstes führst du den folgenden Befehl aus, um den GPG-Schlüssel für das Docker-Repository herunterzuladen. Dann fügst du das offizielle Docker-Repository zu deinem System hinzu.
sudo mkdir -p /etc/apt/keyrings curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
echo \
„deb [arch=$(dpkg –print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
$(lsb_release -cs) stable“ | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
Nachdem der GPG-Schlüssel und das Docker-Repository hinzugefügt wurden, aktualisierst du dein Repository mit dem folgenden apt-Befehl.
sudo apt update
Du erhältst eine Ausgabe wie die folgende – das Docker CE Repository ist hinzugefügt.
Installiere nun Docker CE und Docker Compose mit dem folgenden apt-Befehl.
sudo apt install docker-ce docker-ce-cli containerd.io docker-compose-plugin
Gib y ein, um die Installation zu bestätigen, und drücke dann ENTER, um fortzufahren.
Nachdem Docker installiert ist, führe den folgenden systemctl-Befehl aus, um den aktuellen Status des Docker-Dienstes zu überprüfen.
sudo systemctl is-enabled docker sudo systemctl status docker
Du solltest nun die Ausgabe erhalten, dass der Docker-Dienst läuft und aktiviert ist. Docker wird nun automatisch beim Systemstart ausgeführt.
Nachdem Docker nun installiert ist, geht es im nächsten Schritt darum, die Installation von Plausible Analytics einzurichten.
Herunterladen und Konfigurieren von Plausible Analytics
Nachdem Docker installiert ist, lädst du den Quellcode von Plausible Analytics herunter und konfigurierst die Umgebungsvariable, die während der Bereitstellung verwendet wird. Dazu gehören einige wichtige Einstellungen wie der Administrator-Benutzer und das Passwort, der Plausible-Domänenname für die Installation und der SECRET_KEY_BASE, der für die Sicherung von Plausible verwendet wird.
Verschiebe das Arbeitsverzeichnis nach „/opt“. Lade dann den Plausible-Quellcode mit dem unten stehenden git-Befehl herunter.
cd /opt sudo git clone https://github.com/plausible/hosting plausible
Als Nächstes führst du den folgenden Befehl aus, um den SECRET_KEY_BASE für Plausible Analytics zu erzeugen.
openssl rand 64 | base64 -w 0 ; echo
Du erhältst den generierten Zufallsstring – achte darauf, ihn zu speichern, denn du wirst den generierten Zufallsstring hier als SECRET_KEY_BASE für Plausible verwenden.
Verschiebe nun das Arbeitsverzeichnis nach„/opt/plausible„, dem Installationsverzeichnis von Plasibble. Bearbeite dann mit dem folgenden nano-Editor-Befehl die Konfigurationsdatei„plausible-conf.env„.
cd /opt/plausible sudo nano plausible-conf.env
Ändere die Detailkonfiguration mit deiner Einsatzumgebung. Achte auch darauf, dass du die Details admin user, email und password änderst. Außerdem musst du den Domänennamen für deine Installation und den SECRET_KEY_BASE durch eine zufällige Zeichenfolge ersetzen, die du erstellt hast.
Die folgenden Konfigurationen werden bei der Bereitstellung von Plausible Analytic über Docker und Docker Compose als Variable verwendet.
ADMIN_USER_EMAIL=alice@hwdomain.io ADMIN_USER_NAME=alice ADMIN_USER_PWD=admin_alice_password BASE_URL=https://plausible.hwdomain.io SECRET_KEY_BASE=WI+Dzf5ZsvbL+tapfDuIyOr2rhQqcss10XnQkX3b/BjOucweWvHjqpFtb9kV69O1PwvbOxaBvotlGbh6vry//Q==
Speichere die Datei und beende den Editor, wenn du fertig bist.
Plausible Analytics mit Docker Compose ausführen
Jetzt hast du die Umgebung konfiguriert, die für die Bereitstellung von Plausible verwendet werden soll. Jetzt musst du das Skript docker-compose.yml einrichten und Plausible über Docker Compose bereitstellen.
Verschiebe dein Arbeitsverzeichnis in das Plausible-Installationsverzeichnis„/opt/plausible„.
cd /opt/plausible
Verwende den folgenden nano-Editor, um die Docker Compose-Konfigurationsdatei„docker-compose.yml“ zu bearbeiten.
sudo nano docker-compose.yml
Ändere im Abschnitt „plausible“ die Standardkonfiguration„ports“ durch die folgende Konfiguration. Mit dieser Einstellung wird der Plausible Analytic-Dienst auf dem localhost auf dem Standardport 8000 ausgeführt.
plausible: ...... ports: - 127.0.0.1:8000:8000 ......
Speichere die Datei und beende den Editor, wenn du fertig bist.
Sobald du die Datei docker-compose.yml geändert hast, führst du den unten stehenden Docker-Befehl aus, um den Plausible Analytic Service zu erstellen und bereitzustellen.
sudo docker compose up -d
Sobald du den Befehl ausführst, lädt Docker die Images herunter, die für die Bereitstellung von Plausible verwendet werden und die PostgreSQL als Datenbank enthalten. Außerdem wirst du sehen, dass neue Volumes erstellt werden.
Unten siehst du die Ausgabe des Plausible Deployment-Prozesses.
Sobald die Plausible-Installation abgeschlossen ist, solltest du unten sehen, dass die Containerdienste gestartet wurden.
Überprüfe nun den laufenden Container und die Dienste mit dem Docker-Befehl unten. Du solltest sehen, dass die Plausible-Dienste laufen.
sudo docker compose ps
Du kannst auch die Liste der Docker-Images, die auf deinem System verfügbar sind, mit dem unten stehenden Befehl überprüfen. Du solltest mehrere Images sehen, darunter die PostgreSQL- und Plausible-Images.
sudo docker compose images
Führe abschließend den folgenden Befehl aus, um zu überprüfen, ob der Plausible-Dienst läuft. Damit wird versucht, den Plausible-Dienst zu erreichen, der auf localhost mit dem Standardport 8000 läuft.
curl http://localhost:8000
In der folgenden Ausgabe kannst du sehen, dass du auf den URL-Pfad„/login“ für die Plausible-Anmeldeseite weitergeleitet wirst.
Apache2 als Reverse Proxy einrichten
Jetzt, wo Plausible Analytics in Docker läuft. Jetzt installierst du den Apache2-Webserver und richtest ihn als Reverse-Proxy für die Plausible-Webanwendung ein.
Führe den folgenden apt-Befehl aus, um den Apache2-Webserver auf deinem System zu installieren. Gib y ein, um die Installation zu bestätigen und drücke ENTER, um fortzufahren.
sudo apt install apache2
Überprüfe nun den apache2-Dienst, um sicherzustellen, dass der Dienst läuft. Verwende den folgenden systemctl-Befehl.
sudo systemctl is-enabled apache2 sudo systemctl status apache2
In der folgenden Ausgabe siehst du, dass der apache2-Dienst läuft und aktiviert ist. Das bedeutet, dass der apache2-Dienst beim Systemstart automatisch ausgeführt wird.
Nachdem der Apache2-Webserver installiert ist, richtest du als Nächstes den virtuellen Host ein, der als Reverse Proxy für die Plausible Analytics-Webanwendung verwendet wird.
Führe zunächst den folgenden Befehl aus, um einige Apache2-Module zu aktivieren. Dazu gehören die Module, die den Apache2 als Reverse Proxy betreiben, und das Modul mod_ssl.
sudo a2enmod proxy proxy_http proxy_ajp remoteip headers ssl
Du solltest eine Ausgabe wie die folgende sehen.
Als Nächstes führst du den folgenden Befehl aus, um die Standardkonfiguration des virtuellen Hosts für den Apache2-Reverse-Proxy in das Verzeichnis„/etc/apache2/sites-available/“ zu kopieren.
sudo cp /opt/plausible/reverse-proxy/apache2/plausible.conf /etc/apache2/sites-available/
Verwende nun den folgenden nano-Editor-Befehl, um die Konfiguration des virtuellen Hosts„/etc/apache2/sites-available/plausible.conf“ zu bearbeiten.
sudo nano /etc/apache2/sites-available/plausible.conf
Ändere den Domainnamen der Plausible-Installation mit deiner Domain. In diesem Beispiel wird Plausible Analytics auf der Sub-Domain„plausible.hwdomain.io“ ausgeführt.
ServerAdmin admin@hwdomain.io ServerName plausible.hwdomain.io
Speichere die Datei und beende den Editor, wenn du fertig bist.
Als Nächstes aktivierst du die Konfiguration des virtuellen Hosts„plausible.conf“ mit dem unten stehenden Befehl a2ensite.
sudo a2ensite plausible.conf
Danach führst du den folgenden Befehl aus, um die apache2-Konfiguration zu überprüfen und sicherzustellen, dass du die richtigen Konfigurationen hast. Wenn du eine Meldung wie„Syntax OK“ erhältst, bedeutet das, dass deine Konfiguration korrekt ist.
sudo apachectl configtest
Starten Sie abschließend den apache2-Dienst mit dem Befehl systemctl neu, um die neue Konfiguration des virtuellen Hosts„plausible.conf“ anzuwenden.
sudo systemctl restart apache2
Damit hast du die Konfiguration von Apache2 als Reverse Proxy für Plausible Analytics abgeschlossen. Der nächste Schritt besteht darin, den Plausible-Einsatz mit SSL von Letsencrypt zu sichern.
Absicherung von Plausible Analytics mit SSL Letsencrypt
Nachdem du den Apache2 Reverser Proxy für Plausible Analytics konfiguriert hast, wirst du Plausible nun mit SSL Letsencrypt sichern. Bevor du also loslegst, stelle sicher, dass die Domain, die für Plausible verwendet wird, auf die IP-Adresse des Servers zeigt. Stelle außerdem sicher, dass du eine E-Mail-Adresse hast, mit der du den Domainnamen bei Letsencrypt registrieren kannst.
Installiere das certbot-Tool und das certbot-Plugin für Apache2 mit dem unten stehenden apt-Befehl.
sudo apt install certbot python3-certbot-apache
Gib y ein, um die Installation zu bestätigen und drücke ENTER, um mit der Installation fortzufahren.
Nachdem certbot installiert ist, kannst du mit dem unten stehenden certbot-Befehl SSL-Zertifikate erzeugen. Achte darauf, dass du den Domainnamen für deine Plausible-Installation änderst.
sudo certbot --apache -d plausible.hwdomain.io
Sobald der Vorgang abgeschlossen ist, solltest du eine Ausgabe wie die folgende sehen. Plausible Analytics ist jetzt mit SSL Letsencrypt gesichert.
Congratulations! You have successfully enabled https://plausible.hwdomain.io You should test your configuration at: https://www.ssllabs.com/ssltest/analyze.html?d=plausible.hwdomain.io - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - IMPORTANT NOTES: - Congratulations! Your certificate and chain have been saved at: /etc/letsencrypt/live/plausible.hwdomain.io/fullchain.pem Your key file has been saved at: /etc/letsencrypt/live/plausible.hwdomain.io/privkey.pem Your cert will expire on 2022-12-10. To obtain a new or tweaked version of this certificate in the future, simply run certbot again with the "certonly" option. To non-interactively renew *all* of your certificates, run "certbot renew" - Your account credentials have been saved in your Certbot configuration directory at /etc/letsencrypt. You should make a secure backup of this folder now. This configuration directory will also contain certificates and private keys obtained by Certbot so making regular backups of this folder is ideal. - If you like Certbot, please consider supporting our work by: Donating to ISRG / Let's Encrypt: https://letsencrypt.org/donate Donating to EFF: https://eff.org/donate-le
Jetzt ist dein Plausible Analytics über eine sichere HTTPS-Verbindung zugänglich.
Zugriff auf Plausible Analytics
Jetzt, wo Plausible Analytics mit SSL Letsencrypt gesichert ist. Du kannst nun über deinen Webbrowser sicher auf deine Plausible-Installation zugreifen.
Öffne deinen Webbrowser und rufe den Domainnamen deines Plausible Analytics auf (z. B. https://plausible.hwdomain.io/).
Zunächst wird dir die Plausible-Anmeldeseite angezeigt. Gib die Admin-E-Mail-Adresse und das Passwort für dein Plausible ein. Diese Angaben findest du in der Konfigurationsdatei„plausible-conf.env„.
Wenn du den richtigen Admin-Benutzer und das richtige Passwort hast, sollte dir jetzt das Plausible Analytics-Dashboard angezeigt werden.
Websites mit Plausible Analytics nachverfolgen
Im folgenden Schritt erfährst du, wie du die Website tracken und zu Plausible Analytics hinzufügen kannst.
Klicke auf dem Plausible Dashboard auf„Website hinzufügen„.
Gib nun den Domainnamen ein, den du tracken möchtest, und wähle die gewünschte Zeit aus. Dann klickst du auf„Snippet hinzufügen„.
Jetzt kannst du das JavaScript-Snippet zu deiner Zielwebsite hinzufügen. Klicke dann auf„Datenerfassung starten„.
Auf dem folgenden Screenshot siehst du, dass die Domains zu Plausible Analytics hinzugefügt wurden.
Fazit
In diesem Lernprogramm hast du Plausible Analytics über Docker auf einem Ubuntu 22.04 Server installiert. Außerdem hast du den Apache2-Webserver als Reverse Proxy für Plausible Analytics installiert und den Einsatz über SSL Letsencrypt abgesichert. Für die grundlegende Nutzung von Plausible Analytics hast du gelernt, wie du Websites mit Plausible Analytics tracken kannst.
Wenn du jetzt weitermachen möchtest, kannst du weitere Websites zu dem selbst gehosteten Plausible Analytics hinzufügen, die auf deinem System installiert sind.