Ako nainštalovať AWStats na Fedora 28

AWStats je užitočný nástroj na analýzu návštevnosti webu. Jeho HTML rozhranie je prístupné cez prehliadač, čo vám poskytuje jednoduchý prehľad o tom, kto si prezerá vašu webovú stránku. Tento tutoriál vás prevedie inštaláciou, konfiguráciou a zabezpečením AWStats pre webový server Nginx na Fedore 28.

Ak ste ešte nenainštalovali Nginx, urobte tak teraz:

sudo dnf install nginx
sudo systemctl enable --now nginx

Inštalácia AWStats a nástrojov

Najprv budete musieť nainštalovať niekoľko vecí. Našťastie je to veľmi jednoduché, pretože všetok softvér, ktorý budete potrebovať, je v úložiskách Fedory:

sudo dnf install awstats httpd-tools php-fpm

httpd-toolsje balík obsahujúci niektoré nástroje, ktoré budeme potrebovať, ako napríklad htpasswd. Bol navrhnutý na použitie s Apache, ale väčšina nástrojov funguje aj s Nginx. Druhý nástroj, php-fpmnám umožňuje spúšťať PHP skripty z Nginx.

Budeme musieť povoliť php-fpmcez systemctl:

sudo systemctl enable --now php-fpm

Konfigurácia AWStats pre váš web

Pred použitím AWStats budeme musieť nakonfigurovať. Skopírujte konfiguračný súbor modelu a vytvorte novú konfiguráciu pre svoju lokalitu:

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

Teraz upravte tento súbor:

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

Prejdite nadol na riadok, ktorý hovorí LogFile="/var/log/httpd/access_log". Pretože používame Nginx namiesto Apache, musíme to zmeniť. Zmeňte ho na LogFile="/var/log/nginx/access.log".

Potom prejdite nadol úplne na riadok, ktorý hovorí DirIcons="/awstatsicons". Ak ho nemôžete nájsť, napíšte /DirIconsa potom ENTERnaň preskočte stlačením . Zmeňte tento riadok na DirIcons="../icon".

Nakoniec AWStats potrebuje vedieť, akú webovú stránku analyzuje. Týmto spôsobom môže hlásiť veci, ako napríklad ktorí používatelia prichádzajú z externých stránok. Dve relevantné možnosti konfigurácie sú tu SiteDomaina HostAliases. SiteDomainbude to jednoducho názov domény lokality; a HostAliasesbude to zoznam všetkých ďalších názvov domén, ktoré by sa mohli použiť (ak je napríklad vaša lokalita www.example.com, môžete example.comsem zadať, ak ide o rovnakú lokalitu).

Všetky možnosti konfigurácie sú zdokumentované v konfiguračnom súbore. Ak chcete presne vedieť, čo ktorá možnosť robí, alebo ak chcete vidieť všetky možnosti, ktoré AWStats ponúka, prečítajte si komentáre v tomto súbore.

Nastavenie povolení

Dôrazne sa odporúča nespúšťať AWStats ako užívateľ root. AWStats spustíme pod nginxpoužívateľom, ktorý už bol nastavený počas inštalácie Nginx.

Aby sme to dosiahli, musíme urobiť nginxvlastníka adresára, do ktorého AWStats ukladá svoju databázu ( /var/lib/awstats):

sudo chown -R nginx /var/lib/awstats

Prvýkrát spustite AWStats

V neskoršom kroku nastavíme AWStats tak, aby sa spúšťal pri rotácii protokolov servera. Prvýkrát je však najlepšie spustiť ho manuálne. Urobte to pomocou nasledujúceho príkazu:

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

Poznámka: časť hovorí na spustenie príkazu ako užívateľ, nie ako root.-u nginxsudonginx

Výstup bude podobný nasledujúcemu:

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.

Konfigurácia Nginx na zobrazenie AWStats online

Ďalej nakonfigurujeme Nginx, aby sme si mohli prezerať štatistiky našich webových stránok zo samotnej webovej stránky, a nie cez rozhranie príkazového riadka. Upravte svoj hlavný konfiguračný súbor Nginx:

sudoedit /etc/nginx/nginx.conf

Tu pridáme priečinok, ktorý bude obsahovať sekciu AWStats webovej stránky. V tomto návode to nazveme webstats, ale môžete to nazvať ako chcete.

Nájdite časť konfiguračného súboru, ktorá hovorí server. Po rade include /etc/nginx/default.d/*.conf;. Pridať novú sekciu:

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

Táto sekcia hovorí Nginxu, že keď prejdeme do webstatsadresára v našom prehliadači, mal by slúžiť koreňovému adresáru webu AWStats a ak požiadame o skript v cgi-binadresári, mal by ho spustiť.

Po úprave konfiguračného súboru musíme reštartovať Nginx:

sudo systemctl restart nginx

Teraz otvorte prehliadač a prejdite na <your website>/webstats/cgi-bin/awstats.pl?config=<yoursitename>. Toto je domovská stránka AWStats pre váš web. Bude to vyzerať nejako takto:

Uistite sa, že sa stránka načítava správne a že v pravom hornom rohu vidíte logo AWStats. Ak sa stránka nenačíta alebo ak logo chýba, možno ste mali v predchádzajúcom kroku niečo nesprávne nakonfigurované – vráťte sa späť a skontrolujte, či sú všetky cesty správne.

Zabezpečenie AWStats

Ak nezabezpečíte svoju stránku so štatistikami, môže to viesť k zlým veciam, ako je napríklad spam sprostredkovateľa . Tiež nechcete, aby boli vaše podrobné analytické údaje vystavené celému internetu.

Na vloženie hesla na štatistickú stránku použijeme Nginx. Otvorte /etc/nginx/nginx.confznovu vrátiť do sekcie ste pridali, a pridajte nasledujúce riadky pod location /webstats/ {:

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

Teraz musíme vytvoriť tento .htpasswdsúbor. Ukončite konfiguračný súbor a spustite nasledujúci príkaz:

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

Vaše používateľské meno môže byť väčšinou čokoľvek, ale nemalo by obsahovať medzery a malo by byť jedinečné, nie niečo, čo sa dá ľahko uhádnuť ako adminalebo webmaster. Po spustení príkazu sa zobrazí výzva na zadanie hesla. Zadajte bezpečné heslo a potom ho potvrďte.

Znovu načítať Nginx:

sudo systemctl restart nginx

Skúste znova získať prístup k AWStats. Tentokrát budete požiadaní o zadanie používateľského mena a hesla. Zadajte ich a budete presmerovaní na domovskú stránku AWStats ako predtým.

Spustenie AWStats denne a pri rotácii protokolov

Nakoniec potrebujeme aktualizovať naše štatistiky. Použijeme cronna to. Je to pomôcka plánovača úloh a je predinštalovaná vo Fedore (a vo väčšine ostatných distribúcií Linuxu). Spustíme ho AWStats každý deň o polnoci. Upravte /etc/crontaba pridajte nasledujúci riadok dole:

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

Aby sme predišli strate údajov, chceme, aby sa AWStats spúšťal aj pri rotácii protokolov. Ak to chcete urobiť, upravte /etc/logrotate.d/nginx. Nad postrotatesekciu pridajte nasledovné:

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

AWStats je teraz všetko nastavené a pripravené na použitie.