Skip to content

Latest commit

 

History

History
347 lines (243 loc) · 8.11 KB

README.fr.md

File metadata and controls

347 lines (243 loc) · 8.11 KB

Matomo Docker Stack

🇩🇪 Deutsch | 🇬🇧 English | 🇫🇷 Français

Stack Docker optimisé pour Matomo Analytics avec Traefik Reverse Proxy, mise en cache Redis et sauvegardes automatiques.

Optimisé pour : 10-15 sites web, ~500 utilisateurs/jour par site, ~10 000 pages vues/jour

✨ Fonctionnalités

  • ✅ PHP 8.3 avec OPcache + compilateur JIT
  • ✅ MariaDB 11.4 avec configuration optimisée
  • ✅ Redis 7 pour le cache et les sessions
  • ✅ Intégration Traefik avec middlewares de sécurité
  • ✅ SSL/TLS automatique via Let's Encrypt
  • ✅ Sauvegardes automatiques de la base de données toutes les 6 heures
  • ✅ CronJobs Ofelia pour l'archivage et la maintenance
  • ✅ Configuration de sécurité Apache (bloque /tmp/, /config/, etc.)
  • ✅ tmpfs pour améliorer les performances I/O

📋 Table des matières

  1. Prérequis
  2. Démarrage rapide
  3. Configuration Matomo
  4. Maintenance
  5. Dépannage
  6. Sauvegarde & Restauration
  7. Mise à l'échelle

🔧 Prérequis

Services externes requis

  1. Traefik Reverse Proxy doit être en cours d'exécution

    • Réseau : traefik_proxy_network
    • Middlewares requis : security-headers@file, compression@file, rate-limit@file, redirect-to-https@file
    • Options TLS : modern@file

  2. Ofelia CronJob Scheduler doit être en cours d'exécution

Configuration requise du serveur

  • RAM : Au moins 6 Go disponibles
  • CPU : 2+ cœurs recommandés
  • Stockage : SSD avec min. 50 Go d'espace libre
  • Docker : Version 24.0+
  • Docker Compose : Version 2.20+

🚀 Démarrage rapide

1. Cloner le dépôt

git clone https://github.com/csaeum/DockerStackMatomo.git
cd DockerStackMatomo

2. Créer les volumes

mkdir -p volumes/html volumes/sql

3. Configurer l'environnement

cp .env.example .env
nano .env

Paramètres importants dans .env :

COMPOSE_PROJECT_NAME=matomo
BACKUPVOLUME=/chemin/vers/votre/sauvegarde
HOSTRULE=Host(`matomo.votre-domaine.fr`)

# Générer des mots de passe sécurisés :
# openssl rand -base64 32
REDIS_PASSWORD=VOTRE_MOT_DE_PASSE_GENERE
SQL_PASSWORD=VOTRE_MOT_DE_PASSE_GENERE
SQL_ROOT_PASSWORD=VOTRE_MOT_DE_PASSE_GENERE

4. Démarrer le stack

docker compose up -d

5. Terminer l'installation de Matomo

  1. Ouvrir le navigateur : https://votre-domaine.fr
  2. Suivre l'assistant de configuration Matomo :
    • Hôte de base de données : sql
    • Nom de la base de données : MatomoDB
    • Utilisateur : MatomoUser
    • Mot de passe : Votre SQL_PASSWORD du fichier .env

⚙️ Configuration Matomo

1. Activer le cache Redis (IMPORTANT !)

Éditer volumes/html/config/config.ini.php :

docker exec -it matomo-php-apache nano /var/www/html/config/config.ini.php

Ajouter à la fin :

[Cache]
backend = redis

[RedisCache]
host = "redis"
port = 6379
password = "VOTRE_MOT_DE_PASSE_REDIS"
database = 0
timeout = 0.0

[QueuedTracking]
backend = "redis"
host = "redis"
port = 6379
password = "VOTRE_MOT_DE_PASSE_REDIS"
database = 1

2. Désactiver l'archivage du navigateur

Dans le même fichier config.ini.php :

[General]
enable_browser_archiving_triggering = 0
browser_archiving_disabled_enforce = 1

3. Redémarrer le conteneur

docker compose restart php-apache

⏰ CronJobs automatiques

Configurés via Ofelia (dans docker-compose.yaml) :

  1. Archivage : Toutes les heures (génère des rapports pour tous les sites)
  2. Suppression des logs : Tous les jours à 2h (supprime les logs de plus de 180 jours)
  3. Nettoyage temporaire : Tous les jours à 3h (purge les anciennes données d'archive)

Vérifier les logs des CronJobs

docker logs -f ofelia

# Test manuel
docker exec matomo-php-apache php /var/www/html/console core:archive

🔧 Maintenance

Afficher les logs

docker compose logs -f
docker compose logs -f php-apache
docker compose logs -f sql

Redémarrer les conteneurs

docker compose restart
docker compose restart php-apache

Mettre à jour les images

docker compose pull
docker compose up -d
docker image prune -f

🐛 Dépannage

Échec de connexion à la base de données

docker compose ps sql
docker compose logs sql
docker exec matomo-sql mariadb-admin ping -uroot -p"${SQL_ROOT_PASSWORD}"

Les rapports ne sont pas générés

docker logs ofelia
docker exec matomo-php-apache php /var/www/html/console core:archive

Échec de connexion Redis

docker exec matomo-redis redis-cli -a "${REDIS_PASSWORD}" ping
docker compose logs redis

💾 Sauvegarde & Restauration

Sauvegardes automatiques

Les sauvegardes SQL sont créées automatiquement par le conteneur sqlbackup :

  • Fréquence : Toutes les 6 heures
  • Emplacement : ${BACKUPVOLUME}/matomo/
  • Rétention : 12 dernières sauvegardes
  • Compression : GZIP Niveau 9

Sauvegarde manuelle

docker exec matomo-sql mariadb-dump \
    -uroot -p"${SQL_ROOT_PASSWORD}" \
    --single-transaction \
    MatomoDB > backup_$(date +%Y%m%d_%H%M%S).sql

Restaurer une sauvegarde

docker compose down
docker compose up -d sql
docker exec -i matomo-sql mariadb -uroot -p"${SQL_ROOT_PASSWORD}" MatomoDB < backup.sql
docker compose up -d

📈 Mise à l'échelle

Lorsque le trafic augmente (>50 000 pages vues/jour)

Installer le plugin QueuedTracking :

  1. Dans Matomo : Administration → Marketplace
  2. Rechercher "QueuedTracking" et installer
  3. Ajouter dans docker-compose.yaml :
- ofelia.job-exec.${COMPOSE_PROJECT_NAME}-queue-worker.schedule=* * * * *
- ofelia.job-exec.${COMPOSE_PROJECT_NAME}-queue-worker.command=php /var/www/html/console queuedtracking:process

Augmenter les ressources

# Dans docker-compose.yaml
sql:
  deploy:
    resources:
      limits:
        memory: "8G"  # de 4G à 8G

redis:
  command:
    - --maxmemory
    - 2gb  # de 1gb à 2gb

Mettre à jour configs/sql/custom.cnf :

innodb_buffer_pool_size = 6G  # 75% de 8G

📚 Ressources

📝 Journal des modifications

Version 1.0 (2025-12-28)

  • ✅ Version initiale
  • ✅ Optimisé pour 10-15 sites, ~500 utilisateurs/jour
  • ✅ Intégration du cache Redis
  • ✅ Middlewares de sécurité Traefik
  • ✅ Configuration de sécurité Apache
  • ✅ Sauvegardes automatiques
  • ✅ CronJobs Ofelia
  • ✅ MariaDB optimisé pour les performances
  • ✅ PHP 8.3 avec OPcache + JIT

📄 Licence

Ce projet est sous licence GPL-3.0-or-later.

🤝 Support & Contribution

Fait avec ❤️ par WSC - Web SEO Consulting

Ce projet est gratuit et open source. S'il vous a aidé, j'apprécie votre soutien :

Buy Me a Coffee GitHub Sponsors PayPal

Questions ou problèmes ?