Accueil VPSie

Retour à la base de connaissances

Comprendre les performances de votre site web est essentiel pour prendre des décisions éclairées. Parmi les nombreuses solutions d'analyse disponibles, Fathom Analytics se distingue par sa simplicité, son accent sur la confidentialité et ses analyses puissantes. Si vous utilisez un système Debian 12 et cherchez un processus simplifié pour intégrer Fathom Analytics à votre site, vous êtes au bon endroit. Dans ce guide, nous vous accompagnons pas à pas dans l'installation, vous permettant d'exploiter pleinement les capacités de Fathom Analytics tout en bénéficiant de la sécurité et de la stabilité robustes de Debian 12.

Assurez-vous d'abord d'avoir créé un compte VPSie si ce n'est pas déjà fait, puis déployez le serveur Debian 12 selon vos besoins spécifiques.

Créer votre compte maintenant

Avant d'installer des paquets, il est crucial de mettre à jour la liste des paquets de votre système pour garantir l'accès aux dernières versions. Ouvrez un terminal et exécutez la commande :

sudo apt-get update -y

Installer les dépendances

Pour configurer votre environnement, exécutez la commande ci-dessous. Elle installera le serveur PostgreSQL, le serveur web Nginx, Certbot, le plugin Nginx Certbot et UFW (Uncomplicated Firewall).

sudo apt install postgresql nginx certbot python3-certbot-nginx ufw

Vérifiez l'état du service PostgreSQL en exécutant la commande suivante pour vous assurer qu'il est opérationnel et activé.

sudo systemctl is-enabled postgresql
sudo systemctl status PostgreSQL

Veuillez confirmer l'état du service nginx en exécutant la commande ci-dessous.

sudo systemctl is-enabled nginx
sudo systemctl status nginx

Confirmez l'installation de Certbot. La commande suivante localise l'exécutable Certbot et affiche la version actuellement installée sur votre système :

which certbot
certbot --version

Configurer le pare-feu UFW

Pour ouvrir les ports des protocoles SSH, HTTP et HTTPS, exécutez la commande suivante :

sudo ufw allow OpenSSH
sudo ufw allow "WWW Full"

Veuillez exécuter la commande suivante pour initialiser et activer UFW sur votre système Debian.

sudo ufw enable

Enfin, confirmez l'état d'UFW en exécutant la commande suivante.

sudo ufw status

Configurer la base de données PostgreSQL

Exécutez la commande suivante pour vous connecter au serveur PostgreSQL.

sudo -u postgres psql

Pour créer une nouvelle base de données nommée fathomdb et un utilisateur nommé fathom avec un mot de passe sécurisé dans PostgreSQL, vous pouvez utiliser les requêtes suivantes. N'oubliez pas de remplacer your_secure_password par le mot de passe de votre choix.

CREATE USER fathom WITH CREATEDB CREATEROLE PASSWORD 'your_secure_password';
CREATE DATABASE fathomdb OWNER fathom;

Exécutez maintenant les requêtes suivantes pour vérifier la liste des bases de données et des utilisateurs disponibles sur le serveur PostgreSQL.

\du
\l

Après avoir créé la base de données et l'utilisateur, exécutez la commande suivante pour vous connecter à PostgreSQL avec l'utilisateur fathom et la base de données fathomdb. Lorsque le système vous le demande, saisissez le mot de passe de votre utilisateur de base de données.

sudo -u postgres psql -U fathom -h 127.0.0.1 -d fathomdb

Après vous être connecté au serveur PostgreSQL, exécutez la requête suivante pour vérifier votre connexion.

\conninfo

Télécharger Fathom

Visitez la page GitHub de Fathom pour trouver l'URL de téléchargement du paquet binaire Fathom. Une fois que vous avez l'URL, vous pouvez utiliser la commande wget pour le télécharger.

wget [URL]

Par exemple, pour télécharger la version 1.3.1 de Fathom, vous pouvez utiliser la commande suivante :

wget https://github.com/usefathom/fathom/releases/download/v1.3.1/fathom_1.3.1_linux_amd64.tar.gz

Après le téléchargement, décompressez le paquet binaire Fathom dans le répertoire /usr/local/bin/fathom et assurez-vous qu'il dispose des permissions d'exécution.

tar -C /usr/local/bin -xzf fathom_1.3.1_linux_amd64.tar.gz
chmod +x /usr/local/bin/fathom

Exécutez la commande ci-dessous pour confirmer le site du fichier binaire fathom et la version actuellement téléchargée.

which fathom
fathom --version

Intégration de Fathom avec PostgreSQL

Pour créer un nouvel utilisateur système nommé fathom, qui gérera votre installation Fathom, saisissez la commande ci-dessous.

sudo useradd -r -d /opt/fathom fathom

Créez un nouveau répertoire personnel nommé /opt/fathom et attribuez la propriété à l'utilisateur fathom.

sudo mkdir -p /opt/fathom
sudo chown -R fathom:fathom /opt/fathom

Pour générer un secret aléatoire pour Fathom, exécutez la commande ci-dessous. N'oubliez pas de conserver la sortie, car vous en aurez besoin pour sécuriser Fathom.

head /dev/urandom | tr -dc A-Za-z0-9 | head -c 20 ; echo ''

Accédez à /opt/fathom

cd /opt/fathom

Créez maintenant un nouveau répertoire /opt/fathom/data et un nouveau fichier /opt/fathom/data/.env à l'aide de la commande suivante.

sudo -u fathom mkdir -p /opt/fathom/data
sudo -u fathom nano /opt/fathom/data/.env

Intégrez la configuration ci-dessous, en veillant à modifier les détails du nom de la base de données PostgreSQL, de l'utilisateur et du mot de passe.

FATHOM_GZIP=true
FATHOM_DEBUG=true
FATHOM_DATABASE_DRIVER="postgres"
FATHOM_DATABASE_NAME="fathomdb"
FATHOM_DATABASE_USER="fathom"
FATHOM_DATABASE_PASSWORD="your_secure_password"
FATHOM_DATABASE_HOST="127.0.0.1"
FATHOM_DATABASE_SSLMODE="disable"
FATHOM_SECRET="BWTtur9A1qWtXG6656q4"

Enregistrez et quittez le fichier.

Exécutez la commande suivante pour vérifier que votre configuration Fathom est réussie.

cd /opt/fathom/data
sudo -u fathom fathom server

Configurer Fathom en tant que service Systemd

Générez un nouveau fichier de service systemd nommé /etc/systemd/system/fathom.service en exécutant la commande suivante dans l'éditeur nano.

sudo nano /etc/systemd/system/fathom.service

Insérez la configuration suivante :

[Unit]
Description=Starts the fathom server
Requires=network.target
After=network.target
[Service]
Type=simple
User=fathom
Restart=always
RestartSec=3
WorkingDirectory=/opt/fathom/data
ExecStart=/usr/local/bin/fathom server
[Install]
WantedBy=multi-user.target

Enregistrez et fermez le fichier.

Exécutez la commande systemctl suivante pour actualiser le gestionnaire systemd et appliquer les modifications effectuées.

sudo systemctl daemon-reload

Exécutez maintenant la commande systemctl ci-dessous pour démarrer et activer le service fathom.

sudo systemctl start fathom
sudo systemctl enable fathom

Vérifiez le fonctionnement du service fathom en exécutant la commande fournie ci-dessous.

sudo systemctl is-enabled fathom
sudo systemctl status fathom

Configurer l'utilisateur administrateur Fathom

Accédez au répertoire de travail actuel /opt/fathom/data.

cd /opt/fathom/data

Utilisez la commande ci-dessous pour créer un utilisateur administrateur pour votre installation Fathom. N'oubliez pas de mettre à jour l'adresse e-mail et le mot de passe avec la commande fournie.

sudo -u fathom fathom user add --email="[email protected]" --password="your_secure_password"

Configurer Nginx en tant que proxy inverse

À l'aide de l'éditeur nano, créez une nouvelle configuration de bloc serveur Nginx nommée fathom dans le répertoire /etc/nginx/sites-available avec la commande fournie.

sudo nano /etc/nginx/sites-available/fathom

Ajoutez la configuration fournie et assurez-vous de mettre à jour le nom de domaine dans l'option server_name.

server {
    listen 80;
    server_name analytics.menon.fun;
    location / {
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $remote_addr;
        proxy_set_header Host $host;
        proxy_pass http://127.0.0.1:8080; 
    }
}

Enregistrez et quittez le fichier.

Exécutez la commande suivante pour activer le fichier de bloc serveur situé dans /etc/nginx/sites-available/fathom et vérifier la syntaxe Nginx.

sudo ln -s /etc/nginx/sites-available/fathom /etc/nginx/sites-enabled/
sudo nginx -t

Exécutez ensuite la commande suivante pour redémarrer le service Nginx et appliquer les modifications effectuées.

sudo systemctl restart nginx

Accéder à l'interface web Fathom

Ouvrez votre navigateur web préféré et accédez au domaine où se trouve votre installation Fathom, par exemple http://analytics.menon.fun/.

Cliquez sur Créer un site pour générer votre traceur initial.

Vous devez vérifier le code de traceur généré par Fathom et consulter votre page d'analyse.

En résumé, pensez à consulter régulièrement le tableau de bord Fathom Analytics de votre site et à protéger vos données d'analyse. C'est comme surveiller le pouls de votre site et veiller à ce que ses secrets restent bien gardés !

Retour à la base de connaissances