LLI Wiki — My Digital Knowledge Base

GoAccess : rapport nginx en temps réel protégé en HTTPS

Analyser les logs nginx avec GoAccess en terminal ou en rapport HTML, avec TLS, authentification basique et Certbot.

GoAccess est un analyseur de logs qui produit un tableau de bord en temps réel dans le terminal ou un rapport HTML à partir des logs d'accès d'un serveur web. Cet article montre comment l'utiliser avec les logs nginx, publier le rapport en HTTPS et le protéger par authentification basique.

Mode terminal

Analyser en une fois les logs courants et archivés (gzip) :

sudo zcat --force /var/log/nginx/access.log* | goaccess -

Suivre le log en direct :

tail -f /var/log/nginx/access.log | goaccess -

Générer un rapport HTML statique à partir de tous les logs :

sudo zcat --force /var/log/nginx/access.log* | goaccess - -a > /usr/share/webapps/goaccess/report.html

Rapport HTML en temps réel

GoAccess peut servir un rapport HTML qui se met à jour seul grâce à son serveur WebSocket intégré (port 7890 par défaut). Ici avec TLS :

sudo goaccess /var/log/nginx/access.log \
  -o /usr/share/webapps/goaccess/report.html \
  --log-format=COMBINED --real-time-html \
  --ssl-cert=/etc/letsencrypt/live/goaccess.example.com/fullchain.pem \
  --ssl-key=/etc/letsencrypt/live/goaccess.example.com/privkey.pem

Le rapport est alors disponible sur https://goaccess.example.com/report.html.

Protéger le rapport par authentification basique

Créer le fichier de mots de passe (l'utilitaire nginx-passwd de la note d'origine ; htpasswd du paquet apache2-utils fonctionne de la même façon) :

sudo nginx-passwd -f /etc/nginx/.htpasswd admin

Créer /etc/nginx/conf.d/goaccess.conf :

server {
    server_name goaccess.example.com;
    root /usr/share/webapps/goaccess;
    index index.html;

    location / {
        auth_basic "Restricted Area";
        auth_basic_user_file /etc/nginx/.htpasswd;
        try_files $uri $uri/ =404;
    }

    # Journaux dédiés (optionnel)
    access_log /var/log/nginx/goaccess_access.log;
    error_log /var/log/nginx/goaccess_error.log;

    # SSL (géré par Certbot)
    listen 443 ssl;
    ssl_certificate /etc/letsencrypt/live/goaccess.example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/goaccess.example.com/privkey.pem;
    include /etc/letsencrypt/options-ssl-nginx.conf;
    ssl_dhparam /etc/letsencrypt/ssl-dhparams.pem;

    ssl_trusted_certificate /etc/letsencrypt/live/goaccess.example.com/chain.pem;
    ssl_stapling on;
    ssl_stapling_verify on;
}

server {
    # Redirection permanente HTTP vers HTTPS
    listen 80;
    server_name goaccess.example.com;
    return 301 https://$host$request_uri;
}

Obtenir le certificat

sudo certbot --nginx --agree-tos --redirect --staple-ocsp --email admin@example.com -d goaccess.example.com

Remarques

Mastodon LLIMastodon SocialFosstodon