Как да инсталирате AWStats на Fedora 28

AWStats е полезен инструмент за анализиране на уеб трафика. Неговият HTML интерфейс може да бъде достъпен през браузъра, като ви дава лесна представа за това кой преглежда вашия уебсайт. Този урок ще ви преведе през инсталирането, конфигурирането и осигуряването на AWStats за уеб сървър на Nginx на Fedora 28.

Ако все още не сте инсталирали Nginx, направете го сега:

sudo dnf install nginx
sudo systemctl enable --now nginx

Инсталиране на AWStats и инструменти

Първо, ще трябва да инсталирате няколко неща. За щастие, това е много лесно, тъй като целият софтуер, от който се нуждаете, се намира в хранилищата на Fedora:

sudo dnf install awstats httpd-tools php-fpm

httpd-toolsе пакет, съдържащ някои инструменти, от които ще се нуждаем, като htpasswd. Той е проектиран за използване с Apache, но повечето от инструментите работят и с Nginx. Другият инструмент, php-fpm, ни позволява да изпълняваме PHP скриптове от Nginx.

Ще трябва да активираме php-fpmчрез systemctl:

sudo systemctl enable --now php-fpm

Конфигуриране на AWStats за вашия сайт

Ще трябва да конфигурираме AWStats, преди да можем да го използваме. Копирайте конфигурационния файл на модела, за да създадете нова конфигурация за вашия сайт:

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

Сега редактирайте този файл:

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

Превъртете надолу до реда, който казва LogFile="/var/log/httpd/access_log". Тъй като използваме Nginx вместо Apache, трябва да променим това. Променете го на LogFile="/var/log/nginx/access.log".

След това превъртете надолу чак до реда, който казва DirIcons="/awstatsicons". Ако не можете да го намерите, въведете /DirIcons, след което натиснете, за ENTERда преминете към него. Променете този ред на DirIcons="../icon".

И накрая, AWStats трябва да знае какъв уебсайт анализира. По този начин може да докладва неща, като например кои потребители идват от външни сайтове. Двете подходящи опции за конфигурация тук са SiteDomainи HostAliases. SiteDomainще бъде просто името на домейна на сайта; и HostAliasesще бъде списък с всички други имена на домейни, които може да се използват (например, ако вашият сайт е www.example.com, можете да поставите example.comтук, ако е същият сайт).

Всички опции за конфигурация са документирани в конфигурационния файл. Ако искате да знаете какво точно прави дадена опция или ако искате да видите всички опции, които AWStats може да предложи, просто прочетете коментарите в този файл.

Настройване на разрешения

Силно се препоръчва да не стартирате AWStats като root потребител. Ще стартираме AWStats под nginxпотребителя, който вече е бил настроен по време на инсталацията на Nginx.

За да направим това, ще трябва да направим nginxсобственик на директорията, където AWStats съхранява своята база данни ( /var/lib/awstats):

sudo chown -R nginx /var/lib/awstats

Стартирайте AWStats за първи път

В по-късна стъпка ще настроим AWStats да се изпълнява, когато регистрационните файлове на сървъра се завъртат. Този първи път обаче е най-добре да го стартирате ръчно. Направете това със следната команда:

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

Забележка: В -u nginxчастта казва sudoда изпълните командата като nginxпотребител, а не като корен.

Резултатът ще бъде подобен на следното:

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.

Конфигуриране на Nginx за преглед на AWStats онлайн

След това ще конфигурираме Nginx, така че да можем да виждаме статистиката на нашия уебсайт от самия уебсайт, а не чрез интерфейс на командния ред. Редактирайте вашия основен конфигурационен файл на Nginx:

sudoedit /etc/nginx/nginx.conf

Тук ще добавим папка, която да съдържа секцията AWStats на уебсайта. В този урок ще го наречем webstats, но можете да го наречете както искате.

Намерете секцията от конфигурационния файл, която казва server. След линията include /etc/nginx/default.d/*.conf;. Добавете нов раздел:

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

Този раздел казва на Nginx, че когато отидем в webstatsдиректорията в нашия браузър, той трябва да обслужва уеб корена на AWStats и ако поискаме скрипт в cgi-binдиректорията, той трябва да го стартира.

След като редактираме конфигурационния файл, трябва да рестартираме Nginx:

sudo systemctl restart nginx

Сега отворете браузъра си и отидете на <your website>/webstats/cgi-bin/awstats.pl?config=<yoursitename>. Това е началната страница на AWStats за вашия уебсайт. Ще изглежда донякъде така:

Уверете се, че страницата се зарежда правилно и че можете да видите логото на AWStats в горния десен ъгъл. Ако страницата не се зареди или логото липсва, може да имате нещо неправилно конфигурирано в предишна стъпка - върнете се и се уверете, че всички пътища са правилни.

Осигуряване на AWStats

Неуспехът да защитите вашата страница със статистически данни може да доведе до лоши неща, като спам с препоръчани клиенти . Освен това не искате вашите подробни аналитични данни да бъдат изложени на целия интернет.

Ще използваме Nginx, за да поставим парола на страницата със статистика. Отворете /etc/nginx/nginx.confотново, върнете се към секцията, която сте добавили, и добавете следните редове под location /webstats/ {:

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

Сега трябва да създадем този .htpasswdфайл. Излезте от конфигурационния файл и изпълнете следната команда:

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

Вашето потребителско име може да бъде предимно всичко, но не трябва да съдържа интервали и трябва да е уникално, а не нещо лесно за отгатване като adminили webmaster. Когато изпълните командата, ще бъдете подканени за парола. Въведете сигурна парола, след което я потвърдете.

Презаредете Nginx:

sudo systemctl restart nginx

Опитайте отново да получите достъп до AWStats. Този път ще бъдете помолени да въведете вашето потребителско име и парола. Въведете ги и ще бъдете изпратени до началната страница на AWStats, както преди.

Изпълнение на AWStats ежедневно и при завъртане на регистрационни файлове

И накрая, трябва да актуализираме нашата статистика. Ще използваме cronза това. Това е помощна програма за планиране на задачи и е предварително инсталирана на Fedora (и повечето други дистрибуции на Linux). Ще го накараме да изпълнява AWStats всеки ден в полунощ. Редактирайте /etc/crontabи добавете следния ред в долната част:

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

За да избегнем загуба на данни, ние също ще искаме AWStats да се изпълнява, когато регистрационните файлове се завъртат. За да направите това, редактирайте /etc/logrotate.d/nginx. Над postrotateсекцията добавете следното:

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

AWStats вече е настроен и готов за работа.