Hur man installerar AWStats på Fedora 28

AWStats är ett användbart verktyg för att analysera webbtrafik. Dess HTML-gränssnitt kan nås via webbläsaren, vilket ger dig enkla insikter om vem som tittar på din webbplats. Denna handledning kommer att leda dig genom att installera, konfigurera och säkra AWStats för en Nginx-webbserver på Fedora 28.

Om du inte har installerat Nginx än, gör det nu:

sudo dnf install nginx
sudo systemctl enable --now nginx

Installera AWStats och verktyg

Först måste du installera några saker. Lyckligtvis är detta väldigt enkelt, eftersom all programvara du behöver finns i Fedoras förråd:

sudo dnf install awstats httpd-tools php-fpm

httpd-toolsär ett paket som innehåller några verktyg vi behöver, som htpasswd. Det var designat för användning med Apache, men de flesta av verktygen fungerar också med Nginx. Det andra verktyget, php-fpm, låter oss köra PHP-skript från Nginx.

Vi måste aktivera php-fpmgenom systemctl:

sudo systemctl enable --now php-fpm

Konfigurera AWStats för din webbplats

Vi måste konfigurera AWStats innan vi kan använda det. Kopiera modellkonfigurationsfilen för att skapa en ny konfiguration för din webbplats:

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

Redigera den filen nu:

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

Scrolla ner till raden som säger LogFile="/var/log/httpd/access_log". Eftersom vi använder Nginx istället för Apache måste vi ändra detta. Ändra det till LogFile="/var/log/nginx/access.log".

Scrolla sedan ner hela vägen till raden som säger DirIcons="/awstatsicons". Om du inte kan hitta den, skriv /DirIconsoch tryck sedan på för ENTERatt hoppa till den. Ändra denna rad till DirIcons="../icon".

Slutligen måste AWStats veta vilken webbplats den analyserar. På så sätt kan den rapportera saker som vilka användare som kommer från externa webbplatser. De två relevanta konfigurationsalternativen här är SiteDomainoch HostAliases. SiteDomainkommer helt enkelt att vara webbplatsens domännamn; och HostAliaseskommer att vara en lista över alla andra domännamn som kan användas (om din webbplats till exempel är www.example.com, kan du lägga in example.comhär om det är samma webbplats).

Alla konfigurationsalternativ är dokumenterade i konfigurationsfilen. Om du vill veta exakt vad ett alternativ gör, eller om du vill se alla alternativ som AWStats har att erbjuda, läs bara kommentarerna i den filen.

Konfigurera behörigheter

Det rekommenderas starkt att inte köra AWStats som root-användare. Vi kommer att köra AWStats under nginxanvändaren som redan har ställts in under Nginx-installationen.

För att göra detta måste vi göra nginxägaren till katalogen där AWStats lagrar sin databas ( /var/lib/awstats):

sudo chown -R nginx /var/lib/awstats

Kör AWStats för första gången

I ett senare steg kommer vi att ställa in AWStats för att köras när serverloggarna roteras. Första gången är det dock bäst att köra det manuellt. Gör det med följande kommando:

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

Obs: Delen -u nginxsäger att du sudoska köra kommandot som nginxanvändaren snarare än som root.

Utgången kommer att likna följande:

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.

Konfigurerar Nginx för att se AWStats online

Därefter konfigurerar vi Nginx så att vi kan se vår webbplatsstatistik från själva webbplatsen, snarare än genom ett kommandoradsgränssnitt. Redigera din huvudsakliga Nginx-konfigurationsfil:

sudoedit /etc/nginx/nginx.conf

Här lägger vi till en mapp som innehåller avsnittet AWStats på webbplatsen. I den här handledningen kommer vi att kalla det webstats, men du kan kalla det vad du vill.

Hitta avsnittet i konfigurationsfilen som säger server. Efter raden include /etc/nginx/default.d/*.conf;. Lägg till ett nytt avsnitt:

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;
    }
}

Det här avsnittet berättar för Nginx att när vi går till webstatskatalogen i vår webbläsare ska den tjäna AWStats webbrot, och om vi ber om ett skript i cgi-binkatalogen ska det köras.

Efter att ha redigerat konfigurationsfilen måste vi starta om Nginx:

sudo systemctl restart nginx

Öppna nu din webbläsare och gå till <your website>/webstats/cgi-bin/awstats.pl?config=<yoursitename>. Detta är AWStats hemsida för din webbplats. Det kommer att se ut ungefär så här:

Se till att sidan laddas korrekt och att du kan se AWStats-logotypen i det övre högra hörnet. Om sidan inte läses in eller om logotypen saknas kan du ha något felkonfigurerat i ett tidigare steg -- gå tillbaka och se till att alla sökvägar är korrekta.

Säkra AWStats

Att misslyckas med att säkra din statistiksida kan leda till dåliga saker, som hänvisningsskräppost . Dessutom vill du inte att dina detaljerade analysdata exponeras för hela Internet.

Vi kommer att använda Nginx för att sätta ett lösenord på statistiksidan. Öppna /etc/nginx/nginx.configen, gå tillbaka till avsnittet du lade till och lägg till följande rader under location /webstats/ {:

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

Nu måste vi skapa den .htpasswdfilen. Avsluta konfigurationsfilen och kör följande kommando:

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

Ditt användarnamn kan vara mestadels vad som helst, men det bör inte innehålla mellanslag och bör vara unikt, inte något lätt att gissa som admineller webmaster. När du kör kommandot kommer du att bli ombedd att ange ett lösenord. Ange ett säkert lösenord och bekräfta det.

Ladda om Nginx:

sudo systemctl restart nginx

Försök att komma åt AWStats igen. Den här gången kommer du att bli tillfrågad om ditt användarnamn och lösenord. Ange dem så skickas du till AWStats hemsida som tidigare.

Kör AWStats dagligen och när loggar roteras

Slutligen behöver vi vår statistik för att uppdatera. Vi ska använda cronför det. Det är ett uppgiftsschemaläggningsverktyg och det är förinstallerat på Fedora (och de flesta andra Linux-distributioner). Vi kommer att köra AWStats varje dag vid midnatt. Redigera /etc/crontaboch lägg till följande rad längst ner:

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

För att undvika att förlora data vill vi också att AWStats ska köras när loggarna roteras. För att göra det, redigera /etc/logrotate.d/nginx. postrotateLägg till följande ovanför avsnittet:

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

AWStats är nu klart och klart.