Com instal·lar AWStats a Fedora 28

AWStats és una eina útil per analitzar el trànsit web. Es pot accedir a la seva interfície HTML a través del navegador, que us ofereix informació senzilla sobre qui està veient el vostre lloc web. Aquest tutorial us guiarà a través de la instal·lació, la configuració i la seguretat d'AWStats per a un servidor web Nginx a Fedora 28.

Si encara no heu instal·lat Nginx, feu-ho ara:

sudo dnf install nginx
sudo systemctl enable --now nginx

Instal·lació d'AWStats i eines

Primer, haureu d'instal·lar algunes coses. Afortunadament, això és molt fàcil, ja que tot el programari que necessitareu es troba als repositoris de Fedora:

sudo dnf install awstats httpd-tools php-fpm

httpd-toolsés un paquet que conté algunes eines que necessitarem, com ara htpasswd. Va ser dissenyat per utilitzar-lo amb Apache, però la majoria de les eines també funcionen amb Nginx. L'altra eina, php-fpm, ens permet executar scripts PHP des de Nginx.

Haurem d'habilitar php-fpmmitjançant systemctl:

sudo systemctl enable --now php-fpm

Configuració d'AWStats per al vostre lloc

Haurem de configurar AWStats abans de poder-lo utilitzar. Copieu el fitxer de configuració del model per crear una configuració nova per al vostre lloc:

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

Ara editeu aquest fitxer:

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

Desplaceu-vos cap avall fins a la línia que diu LogFile="/var/log/httpd/access_log". Com que estem utilitzant Nginx en comptes d'Apache, hem de canviar-ho. Canvia-ho a LogFile="/var/log/nginx/access.log".

A continuació, desplaceu-vos cap avall fins a la línia que diu DirIcons="/awstatsicons". Si no el trobeu, escriviu i /DirIcons, a continuació, premeu ENTERper anar-hi. Canvia aquesta línia a DirIcons="../icon".

Finalment, AWStats ha de saber quin lloc web està analitzant. D'aquesta manera, pot informar coses com ara quins usuaris provenen de llocs externs. Les dues opcions de configuració rellevants aquí són SiteDomaini HostAliases. SiteDomainsimplement serà el nom de domini del lloc; i HostAliasesserà una llista de qualsevol altre nom de domini que es pugui utilitzar (per exemple, si el vostre lloc és www.example.com, podeu posar example.comaquí si és el mateix lloc).

Totes les opcions de configuració estan documentades al fitxer de configuració. Si voleu saber exactament què fa una opció, o si voleu veure totes les opcions que ofereix AWStats, només heu de llegir els comentaris d'aquest fitxer.

Configuració de permisos

És molt recomanable no executar AWStats com a usuari root. Executarem AWStats amb l' nginxusuari que ja s'ha configurat durant la instal·lació de Nginx.

Per fer-ho, haurem de fer nginxel propietari del directori on AWStats emmagatzema la seva base de dades ( /var/lib/awstats):

sudo chown -R nginx /var/lib/awstats

Executeu AWStats per primera vegada

En un pas posterior, configurarem AWStats perquè s'executi quan es giren els registres del servidor. Aquesta primera vegada, però, el millor és executar-lo manualment. Feu-ho amb l'ordre següent:

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

Nota: la -u nginxpart indica sudoque s'executa l'ordre com a nginxusuari i no com a root.

La sortida serà similar a la següent:

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.

Configuració de Nginx per veure AWStats en línia

A continuació, configurarem Nginx perquè puguem veure les estadístiques del nostre lloc web des del mateix lloc web, més que a través d'una interfície de línia d'ordres. Editeu el vostre fitxer de configuració principal de Nginx:

sudoedit /etc/nginx/nginx.conf

Aquí, afegirem una carpeta per contenir la secció AWStats del lloc web. En aquest tutorial, l'anomenarem webstats, però podeu anomenar-lo com vulgueu.

Cerqueu la secció del fitxer de configuració que diu server. Després de la línia include /etc/nginx/default.d/*.conf;. Afegeix una nova secció:

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

Aquesta secció indica a Nginx que quan anem al webstatsdirectori del nostre navegador, hauria de servir l'arrel web d'AWStats i, si demanem un script al cgi-bindirectori, l'hauria d'executar.

Després d'editar el fitxer de configuració, hem de reiniciar Nginx:

sudo systemctl restart nginx

Ara obriu el vostre navegador i aneu a <your website>/webstats/cgi-bin/awstats.pl?config=<yoursitename>. Aquesta és la pàgina d'inici d'AWStats per al vostre lloc web. Es veurà una mica així:

Assegureu-vos que la pàgina es carregui correctament i que podeu veure el logotip d'AWStats a l'extrem superior dret. Si la pàgina no es carrega o falta el logotip, és possible que tingueu alguna cosa mal configurada en un pas anterior; torneu enrere i assegureu-vos que tots els camins siguin correctes.

Assegurar AWStats

No protegir la vostra pàgina d'estadístiques pot provocar coses dolentes, com ara correu brossa de referència . A més, no voleu que les vostres dades analítiques detallades estiguin exposades a tot Internet.

Utilitzarem Nginx per posar una contrasenya a la pàgina d'estadístiques. Obre de /etc/nginx/nginx.confnou, torna a la secció que has afegit i afegeix les línies següents a location /webstats/ {:

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

Ara hem de crear aquest .htpasswdfitxer. Sortiu del fitxer de configuració i executeu l'ordre següent:

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

El vostre nom d'usuari pot ser gairebé qualsevol cosa, però no hauria de contenir espais i hauria de ser únic, no una cosa fàcil d'endevinar com admino webmaster. Quan executeu l'ordre, se us demanarà una contrasenya. Introduïu una contrasenya segura i, a continuació, confirmeu-la.

Torna a carregar Nginx:

sudo systemctl restart nginx

Intenta tornar a accedir a AWStats. Aquesta vegada, se us demanarà el vostre nom d'usuari i contrasenya. Introduïu-los i se us enviarà a la pàgina d'inici d'AWStats com abans.

S'executa AWStats diàriament i quan es giren els registres

Finalment, necessitem que les nostres estadístiques s'actualitzin. Ho farem servir cronper a això. És una utilitat de planificació de tasques i està preinstal·lada a Fedora (i a la majoria de les altres distribucions de Linux). Farem que executi AWStats cada dia a mitjanit. Editeu /etc/crontabi afegiu la línia següent a la part inferior:

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

Per evitar la pèrdua de dades, també volem que AWStats s'executi quan es giren els registres. Per fer-ho, editeu /etc/logrotate.d/nginx. A sobre de la postrotatesecció, afegiu el següent:

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

Ara AWStats està tot configurat i llest per funcionar.