Como Instalar Matomo Web Analytics no Debian 12

Matomo, anteriormente Piwik, é um software de análise web gratuito e de código aberto que pode ser usado para rastrear visitas a sites e exibir relatórios para análise de dados e público. Matomo é licenciado sob a Licença GPL, escrito em PHP, e pode ser executado com um servidor de banco de dados MySQL ou MariaDB.

Matomo fornece relatórios perspicazes para rastreamento de usuários em seus sites. Isso inclui o mecanismo de busca de referência e palavras-chave, idiomas, visitas a páginas, downloads de arquivos e muito mais. Matomo se tornou cada vez mais popular como uma alternativa a serviços de análise, como o Google Analytics.

Neste tutorial, você aprenderá como instalar a análise web Matomo no servidor Debian 12. Você configurará o Matomo com a pilha LAMP e protegerá o Matomo com HTTPS através do Certbot e Letsencrypt.

Pré-requisitos

Antes de começar, certifique-se de ter o seguinte:

• Um servidor Debian 12.
• Um usuário não-root com privilégios de administrador.
• Um nome de domínio apontado para um endereço IP do servidor.

Instalando dependências

Matomo é uma análise web baseada em PHP que usa MySQL/MariaDB como banco de dados. Para instalar o Matomo, você deve instalar a pilha LAMP (Linux, Apache, MySQL/MariaDB e PHP) ou LEMP (Linux, Nginx, MySQL/MariaDB e PHP-FPM) em seu sistema. Neste exemplo, você executará o Matomo com a pilha LAMP no servidor Debian.

Primeiro, execute o comando apt abaixo para atualizar seu índice de pacotes Debian.

sudo apt update

Agora instale os pacotes da pilha LAMP (Linux, Apache, MySQL/MariaDB e PHP) com o seguinte comando:

sudo apt install apache2 mariadb-server php php-cli libapache2-mod-php php-common php-curl php-gd php-mbstring php-mysql php-xml php-intl php-zip wget unzip

Digite Y para confirmar a instalação.

Após a conclusão da instalação, verifique o status do servidor MariaDB com o comando abaixo. Você verá o servidor MariaDB com o status ativo (em execução) e habilitado.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

Agora verifique o status do serviço Apache com o seguinte comando. Na saída a seguir, você pode ver que o servidor web Apache está em execução.

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

Por fim, execute o comando php abaixo para verificar a versão do PHP. Você verá que o PHP 8.3 está instalado.

php -v

Configurando o PHP

Após instalar a pilha LAMP, você configurará a instalação do PHP editando o arquivo php.ini e reiniciando o servidor web Apache.

Abra a configuração padrão do PHP /etc/php/8.3/apache2/php.ini com o seguinte editor nano.

sudo nano /etc/php/8.3/apache2/php.ini

Altere a configuração padrão como a seguinte - Certifique-se de alterar tanto as opções date.timezone quanto memory_limit com o ambiente atual do seu servidor.

date.timezone = Europe/Stockholm  
memory_limit = 256M  
upload_max_filesize = 16M  
max_execution_time = 300

Salve o arquivo e saia do editor.

Agora execute o comando systemctl abaixo para reiniciar o servidor web Apache e aplicar suas alterações ao PHP.

sudo systemctl restart apache2

Configurando o servidor MariaDB

Nesta seção, você protegerá o servidor MariaDB e configurará a senha root para ele. Em seguida, você criará um novo banco de dados e um usuário que será usado pelo Matomo.

Execute o comando mariadb-secure-installation abaixo para proteger o MariaDB e configurar a senha root.

sudo mariadb-secure-installation

Agora você será questionado sobre as seguintes configurações:

• Mudar a autenticação local para unix_socket? Digite n.
• Configurar a nova senha root do MariaDB. Digite y para confirmar, em seguida, digite a nova senha para a implantação do seu servidor MariaDB.
• Remover usuário anônimo? Digite y para confirmar.
• Remover o banco de dados de teste padrão da implantação? Digite y para confirmar.
• Proibir login root do MariaDB a partir de conexões remotas? Digite y para confirmar.
• Recarregar privilégios de tabela e aplicar as alterações? Digite y e pressione ENTER.

Em seguida, execute o comando mariadb abaixo para fazer login no servidor MariaDB. Digite sua senha root quando solicitado.

sudo mariadb -u root -p

Agora execute as seguintes consultas para criar um novo banco de dados e usuário matomo com a senha p4ssword. Ajuste os detalhes do banco de dados abaixo.

CREATE DATABASE matomo;  
CREATE USER 'matomo'@'localhost' IDENTIFIED BY 'p4ssword';  
GRANT SELECT, INSERT, UPDATE, DELETE, CREATE, INDEX, DROP, ALTER, CREATE TEMPORARY TABLES, LOCK TABLES ON matomo.* TO 'matomo'@'localhost';  
FLUSH PRIVILEGES;

Por fim, execute a consulta abaixo para verificar o usuário matomo@localhost e sair do servidor MariaDB. Isso garantirá que o usuário matomo@localhost possa acessar o banco de dados matomo.

SHOW GRANTS FOR matomo@localhost;  
quit

Baixando o código-fonte do Matomo

Agora que você configurou o PHP e criou um banco de dados e um usuário, pode instalar o Matomo. Agora você fará o download do código-fonte do Matomo, configurará o diretório raiz do documento e, em seguida, mudará a propriedade para o usuário Apache apropriado.

Vá para o diretório /var/www e faça o download do código-fonte do Matomo usando o comando wget abaixo.

cd /var/www/  
wget https://builds.matomo.org/matomo.zip

Uma vez baixado, execute o comando unzip abaixo para extrair o arquivo matomo.zip. E então mude a propriedade do diretório /var/www/matomo para o usuário www-data.

unzip matomo.zip  
sudo chown -R www-data:www-data /var/www/matomo

Configurando o host virtual do Apache

Depois de baixar o Matomo, você criará um novo arquivo de host virtual do Apache para o Matomo. Portanto, certifique-se de que seu nome de domínio esteja apontado para um endereço IP do servidor.

Crie um novo arquivo de host virtual do Apache /etc/apache2/sites-available/matomo.conf com o editor nano.

sudo nano /etc/apache2/sites-available/matomo.conf

Insira a configuração abaixo e certifique-se de substituir a opção ServerName pelo seu nome de domínio.

    ServerAdmin webmaster@localhost
    ServerName matomo.howtoforge.local
    DocumentRoot /var/www/matomo/

    
        DirectoryIndex index.php
        Options FollowSymLinks
        AllowOverride All
        Require all granted
    

    
        Options None
        Require all denied
    

    
        Options None
        Require all granted
    

    
        Options None
        Require all denied
    

    
        Options None
        Require all denied
    

    ErrorLog ${APACHE_LOG_DIR}/matomo_error.log
    CustomLog ${APACHE_LOG_DIR}/matomo_access.log combined

Salve o arquivo e saia quando terminar.

Agora execute o comando a2ensite abaixo para ativar o arquivo matomo.conf. Em seguida, execute o comando apachectl abaixo para verificar sua configuração do Apache. Se você tiver uma sintaxe Apache adequada, verá uma saída Syntax is OK.

sudo a2ensite matomo.conf  
sudo apachectl configtest

Por fim, execute o comando systemctl abaixo para reiniciar o servidor web Apache e aplicar suas alterações. Uma vez que o Apache reiniciou, sua instalação do Matomo está pronta.

sudo systemctl restart apache2

Protegendo o Matomo com HTTPS

Nesta seção, você gerará certificados SSL/TLS e protegerá o Matomo com HTTPS através do Certbot e Letsencrypt.

Instale os pacotes certbot e python3-certbot-apache com o comando abaixo.

sudo apt install certbot python3-certbot-apache

Agora execute o comando certbot abaixo para gerar certificados SSL e proteger seu nome de domínio matomo. Certifique-se de alterar o nome de domínio e o endereço de e-mail com suas informações.

sudo certbot --apache --agree-tos --redirect --hsts --staple-ocsp --email [email protected] -d matomo.howtoforge.local

Após o processo ser concluído, seus certificados SSL estarão disponíveis no diretório /etc/letsencrypt/live/donmain.com. Além disso, sua instalação do Matomo está protegida com HTTPS.

Instalando a análise web Matomo

Abra seu navegador web e visite seu nome de domínio Matomo, como https://matomo.howtoforge.local/. Se a instalação for bem-sucedida, você verá a mensagem de boas-vindas como a seguinte:

Clique em Próximo para confirmar a instalação.

Na seção Verificação do Sistema, certifique-se de que seu sistema esteja pronto e clique em Próximo novamente.

Agora insira os detalhes, incluindo o nome do banco de dados MariaDB, usuário e senha, e clique em Próximo para migrar o banco de dados.

Uma vez migrado, clique em Próximo novamente.

Digite um novo nome de usuário administrador, endereço de e-mail e senha para a análise web Matomo.

Agora insira informações para criar o primeiro rastreamento com Matomo e clique em Próximo.

Copie o código de rastreamento gerado e clique em Próximo.

Após a conclusão da instalação, você verá as seguintes mensagens:

Se você visitar a página inicial do Matomo, será redirecionado para a página de login do matomo. Digite seu usuário admin e senha, e clique em ENTRAR.

Após fazer login, você verá o seguinte painel de administração do Matomo:

Conclusão

Parabéns! Você completou a instalação da análise web Matomo no servidor Debian 12. A análise web Matomo está em funcionamento com o servidor web Apache, servidor de banco de dados MariaDB e PHP 8.3. Você também protegeu o Matomo com HTTPS através do Certbot e Letsencrypt.