Como instalar o AWStats no Fedora 28

• Instalando AWStats e ferramentas
• Configurando o AWStats para o seu site
• Configurando permissões
• Execute o AWStats pela primeira vez
• Configurando o Nginx para visualizar o AWStats online
• Protegendo o AWStats
• Executando o AWStats diariamente e quando os logs são girados

O AWStats é uma ferramenta útil para analisar o tráfego da web. Sua interface HTML pode ser acessada através do navegador, oferecendo informações fáceis sobre quem está visualizando seu site. Este tutorial o guiará pela instalação, configuração e segurança do AWStats para um servidor web Nginx no Fedora 28.

Se você ainda não instalou o Nginx, faça-o agora:

sudo dnf install nginx
sudo systemctl enable --now nginx

Instalando AWStats e ferramentas

Primeiro, você precisará instalar algumas coisas. Felizmente, isso é muito fácil, pois todo o software que você precisa está nos repositórios do Fedora:

sudo dnf install awstats httpd-tools php-fpm

httpd-toolsé um pacote que contém algumas ferramentas necessárias, como htpasswd. Ele foi projetado para uso com o Apache, mas a maioria das ferramentas também funciona com o Nginx. A outra ferramenta php-fpm,, nos permite executar scripts PHP a partir do Nginx.

Precisamos ativar php-fpmatravés de systemctl:

sudo systemctl enable --now php-fpm

Configurando o AWStats para o seu site

Precisamos configurar o AWStats antes de podermos usá-lo. Copie o arquivo de configuração do modelo para criar uma nova configuração para o seu site:

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

Agora edite esse arquivo:

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

Role para baixo até a linha que diz LogFile="/var/log/httpd/access_log". Como estamos usando o Nginx em vez do Apache, precisamos mudar isso. Mude para LogFile="/var/log/nginx/access.log".

Em seguida, role para baixo até a linha que diz DirIcons="/awstatsicons". Se não conseguir encontrá-lo, digite /DirIconse pressione ENTERpara pular para ele. Mude esta linha para DirIcons="../icon".

Finalmente, o AWStats precisa saber qual site está analisando. Dessa forma, ele pode relatar coisas como quais usuários são provenientes de sites externos. As duas opções de configuração relevantes aqui são SiteDomaine HostAliases. SiteDomainserá simplesmente o nome de domínio do site; e HostAliaseshaverá uma lista de outros nomes de domínio que possam ser usados ​​(por exemplo, se o seu site for www.example.com, você pode colocar example.comaqui se for o mesmo site).

Todas as opções de configuração estão documentadas no arquivo de configuração. Se você quiser saber exatamente o que uma opção faz, ou se quiser ver todas as opções que o AWStats oferece, basta ler os comentários nesse arquivo.

Configurando permissões

É altamente recomendável não executar o AWStats como usuário root. Executaremos o AWStats com o nginxusuário que já foi configurado durante a instalação do Nginx.

Para fazer isso, precisaremos tornar nginxo proprietário do diretório em que o AWStats armazena seu banco de dados ( /var/lib/awstats):

sudo chown -R nginx /var/lib/awstats

Execute o AWStats pela primeira vez

Em uma etapa posterior, configuraremos o AWStats para execução quando os logs do servidor forem girados. Desta vez, no entanto, é melhor executá-lo manualmente. Faça isso com o seguinte comando:

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

Nota: A -u nginxparte diz sudopara executar o comando como nginxusuário e não como root.

A saída será semelhante à seguinte:

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.

Configurando o Nginx para visualizar o AWStats online

Em seguida, configuraremos o Nginx para que possamos visualizar as estatísticas do site a partir do próprio site, e não através de uma interface de linha de comando. Edite seu arquivo de configuração principal do Nginx:

sudoedit /etc/nginx/nginx.conf

Aqui, adicionaremos uma pasta para conter a seção AWStats do site. Neste tutorial, vamos chamá-lo webstats, mas você pode chamá-lo como quiser.

Encontre a seção do arquivo de configuração que diz server. Depois da linha include /etc/nginx/default.d/*.conf;. Adicione uma nova seção:

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

Esta seção informa ao Nginx que, quando formos para o webstatsdiretório em nosso navegador, ele deverá servir a raiz da web do AWStats e, se solicitarmos um script no cgi-bindiretório, ele deverá executá-lo.

Após editar o arquivo de configuração, precisamos reiniciar o Nginx:

sudo systemctl restart nginx

Agora abra seu navegador e vá para <your website>/webstats/cgi-bin/awstats.pl?config=<yoursitename>. Esta é a página inicial da AWStats para o seu site. Será algo parecido com isto:

Verifique se a página carrega corretamente e se você pode ver o logotipo do AWStats no canto superior direito. Se a página não carregar ou o logotipo estiver ausente, você pode ter algo mal configurado na etapa anterior - volte e verifique se todos os caminhos estão corretos.

Protegendo o AWStats

Deixar de proteger sua página de estatísticas pode levar a coisas ruins, como spam de referência . Além disso, você não deseja que seus dados analíticos detalhados sejam expostos a toda a Internet.

Usaremos o Nginx para colocar uma senha na página de estatísticas. Abra /etc/nginx/nginx.confnovamente, volte para a seção que você adicionou e adicione as seguintes linhas em location /webstats/ {:

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

Agora precisamos criar esse .htpasswdarquivo. Saia do arquivo de configuração e execute o seguinte comando:

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

Seu nome de usuário pode ser na maior parte qualquer coisa, mas não deve conter espaços e deve ser único, não é algo fácil de adivinhar como adminou webmaster. Ao executar o comando, você será solicitado a fornecer uma senha. Digite uma senha segura e confirme-a.

Recarregar Nginx:

sudo systemctl restart nginx

Tente acessar o AWStats novamente. Desta vez, você será solicitado a fornecer seu nome de usuário e senha. Digite-os e você será enviado para a página inicial do AWStats como antes.

Executando o AWStats diariamente e quando os logs são girados

Finalmente, precisamos que nossas estatísticas sejam atualizadas. Nós vamos usar cronpara isso. É um utilitário de agendador de tarefas e pré-instalado no Fedora (e na maioria das outras distribuições Linux). Vamos executar o AWStats todos os dias à meia-noite. Edite /etc/crontabe adicione a seguinte linha na parte inferior:

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

Para evitar a perda de dados, também queremos que o AWStats seja executado quando os logs forem girados. Para fazer isso, edite /etc/logrotate.d/nginx. Acima da postrotateseção, adicione o seguinte:

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

Agora, o AWStats está pronto e pronto.