Comment installer AWStats sur Fedora 28

• Installation d'AWStats et d'outils
• Configuration d'AWStats pour votre site
• Configuration des autorisations
• Exécutez AWStats pour la première fois
• Configuration de Nginx pour afficher AWStats en ligne
• Sécurisation d'AWStats
• Exécution quotidienne d'AWStats et rotation des journaux

AWStats est un outil utile pour analyser le trafic Web. Son interface HTML est accessible via le navigateur, vous donnant un aperçu facile de qui visite votre site Web. Ce didacticiel vous guidera à travers l'installation, la configuration et la sécurisation d'AWStats pour un serveur Web Nginx sur Fedora 28.

Si vous n'avez pas encore installé Nginx, faites-le maintenant:

sudo dnf install nginx
sudo systemctl enable --now nginx

Installation d'AWStats et d'outils

Tout d'abord, vous devrez installer quelques éléments. Heureusement, c'est très facile, car tous les logiciels dont vous aurez besoin se trouvent dans les référentiels de Fedora:

sudo dnf install awstats httpd-tools php-fpm

httpd-toolsest un package contenant certains outils dont nous aurons besoin, tels que htpasswd. Il a été conçu pour être utilisé avec Apache, mais la plupart des outils fonctionnent également avec Nginx. L'autre outil, php-fpmnous permet d'exécuter des scripts PHP à partir de Nginx.

Nous devons activer php-fpmvia systemctl:

sudo systemctl enable --now php-fpm

Configuration d'AWStats pour votre site

Nous devrons configurer AWStats avant de pouvoir l'utiliser. Copiez le fichier de configuration du modèle pour créer une nouvelle configuration pour votre site:

sudo cp /etc/awstats/awstats.model.conf /etc/awstats/awstats.<yoursitename>.conf

Maintenant éditez ce fichier:

sudoedit /etc/awstats/awstats.<yoursitename>.conf

Faites défiler jusqu'à la ligne qui dit LogFile="/var/log/httpd/access_log". Parce que nous utilisons Nginx au lieu d'Apache, nous devons changer cela. Remplacez-le par LogFile="/var/log/nginx/access.log".

Ensuite, faites défiler vers le bas jusqu'à la ligne qui dit DirIcons="/awstatsicons". Si vous ne le trouvez pas, tapez /DirIcons, puis appuyez sur ENTERpour y accéder. Remplacez cette ligne par DirIcons="../icon".

Enfin, AWStats doit savoir quel site Web il analyse. De cette façon, il peut signaler des éléments tels que les utilisateurs provenant de sites externes. Les deux options de configuration pertinentes ici sont SiteDomainet HostAliases. SiteDomainsera simplement le nom de domaine du site; et HostAliasessera une liste de tous les autres noms de domaine qui pourraient être utilisés (par exemple, si votre site est www.example.com, vous pouvez le mettre example.comici s'il s'agit du même site).

Toutes les options de configuration sont documentées dans le fichier de configuration. Si vous voulez savoir exactement ce que fait une option, ou si vous voulez voir toutes les options qu'AWStats a à offrir, lisez simplement les commentaires dans ce fichier.

Configuration des autorisations

Il est fortement recommandé de ne pas exécuter AWStats en tant qu'utilisateur root. Nous exécuterons AWStats sous l' nginxutilisateur qui a déjà été configuré lors de l'installation de Nginx.

Pour ce faire, nous devons désigner nginxle propriétaire du répertoire où AWStats stocke sa base de données ( /var/lib/awstats):

sudo chown -R nginx /var/lib/awstats

Exécutez AWStats pour la première fois

Dans une étape ultérieure, nous allons configurer AWStats pour qu'il s'exécute lorsque les journaux du serveur tournent. Cette première fois, cependant, il est préférable de l'exécuter manuellement. Faites cela avec la commande suivante:

sudo -u nginx /usr/share/awstats/wwwroot/cgi-bin/awstats.pl -config=<yoursitename>

Remarque: La -u nginxpartie indique sudod'exécuter la commande en tant nginxqu'utilisateur plutôt qu'en tant que root.

La sortie sera similaire à la suivante:

Create/Update database for config "/etc/awstats/awstats.<yoursitename>.conf" by AWStats version 7.7 (build 20180105)
From data in log file "/var/log/nginx/access.log"...
Phase 1: First bypass old records, searching new record...
Direct access after last parsed record (after line 0)
Jumped lines in file: 0
 Found 0 already parsed records.
Parsed lines in file: 0
 Found 0 dropped records,
 Found 0 comments,
 Found 0 blank records,
 Found 0 corrupted records,
 Found 0 old records,
 Found 0 new qualified records.

Configuration de Nginx pour afficher AWStats en ligne

Ensuite, nous allons configurer Nginx afin que nous puissions afficher les statistiques de notre site Web à partir du site Web lui-même, plutôt que via une interface de ligne de commande. Modifiez votre fichier de configuration Nginx principal:

sudoedit /etc/nginx/nginx.conf

Ici, nous allons ajouter un dossier pour contenir la section AWStats du site Web. Dans ce didacticiel, nous l'appellerons webstats, mais vous pouvez l'appeler comme vous le souhaitez.

Trouvez la section du fichier de configuration qui dit server. Après la ligne include /etc/nginx/default.d/*.conf;. Ajoutez une nouvelle section:

location /webstats/ {
    alias /usr/share/awstats/wwwroot/;

    location ~ /cgi-bin/(.+\.pl) {
        include fastcgi.conf;
        fastcgi_pass php-fpm;
        fastcgi_split_path_info ^/webstats/(.+\.pl)(.*)$;
        fastcgi_param SCRIPT_FILENAME /usr/share/awstats/tools/nginx/awstats-fcgi.php;
        fastcgi_param X_SCRIPT_FILENAME /usr/share/awstats/wwwroot/$fastcgi_script_name;
        fastcgi_param X_SCRIPT_NAME $fastcgi_script_name;
    }
}

Cette section indique à Nginx que lorsque nous allons dans le webstatsrépertoire de notre navigateur, il doit servir la racine Web d'AWStats et si nous demandons un script dans le cgi-binrépertoire, il doit l'exécuter.

Après avoir édité le fichier de configuration, nous devons redémarrer Nginx:

sudo systemctl restart nginx

Ouvrez maintenant votre navigateur et accédez à <your website>/webstats/cgi-bin/awstats.pl?config=<yoursitename>. Il s'agit de la page d'accueil d'AWStats pour votre site Web. Cela ressemblera un peu à ceci:

Assurez-vous que la page se charge correctement et que vous pouvez voir le logo AWStats dans le coin supérieur droit. Si la page ne se charge pas ou le logo est manquant, vous pouvez avoir quelque chose de mal configuré dans une étape précédente - revenez en arrière et assurez-vous que tous les chemins sont corrects.

Sécurisation d'AWStats

Ne pas sécuriser votre page de statistiques peut entraîner de mauvaises choses, telles que le spam référent . De plus, vous ne voulez pas que vos données analytiques détaillées soient exposées à l'ensemble d'Internet.

Nous utiliserons Nginx pour mettre un mot de passe sur la page des statistiques. Ouvrez à /etc/nginx/nginx.confnouveau, revenez à la section que vous avez ajoutée et ajoutez les lignes suivantes sous location /webstats/ {:

auth_basic "Username and password required to access AWStats";
auth_basic_user_file /etc/nginx/.htpasswd;

Maintenant, nous devons créer ce .htpasswdfichier. Quittez le fichier de configuration et exécutez la commande suivante:

sudo htpasswd -c /etc/nginx/.htpasswd <username>

Votre nom d'utilisateur peut être principalement n'importe quoi, mais il ne doit pas contenir d'espaces et doit être unique, pas quelque chose de facile à deviner comme adminou webmaster. Lorsque vous exécutez la commande, vous serez invité à entrer un mot de passe. Saisissez un mot de passe sécurisé, puis confirmez-le.

Recharger Nginx:

sudo systemctl restart nginx

Essayez d'accéder à nouveau à AWStats. Cette fois, il vous sera demandé votre nom d'utilisateur et votre mot de passe. Saisissez-les et vous serez redirigé vers la page d'accueil AWStats comme auparavant.

Exécution quotidienne d'AWStats et rotation des journaux

Enfin, nous avons besoin de mettre à jour nos statistiques. Nous utiliserons cronpour cela. Il s'agit d'un utilitaire de planification de tâches et il est préinstallé sur Fedora (et la plupart des autres distributions Linux). Nous le ferons exécuter AWStats tous les jours à minuit. Modifiez /etc/crontabet ajoutez la ligne suivante en bas:

0 0 * * * nginx /usr/share/awstats/wwwroot/cgi-bin/awstats.pl -config=<yoursitename>

Pour éviter de perdre des données, nous souhaitons également que AWStats s'exécute lorsque les journaux tournent. Pour ce faire, modifiez /etc/logrotate.d/nginx. Au-dessus de la postrotatesection, ajoutez ce qui suit:

prerotate
    /usr/share/awstats/wwwroot/cgi-bin/awstats.pl -config=<yoursitename>
endscript

AWStats est maintenant tout configuré et prêt à fonctionner.