Pesquisa de site

Como instalar o Matomo Web Analytics no Ubuntu 22.04

Este tutorial existe para estas versões do sistema operacional

  • Ubuntu 22.04 (Jammy Jellyfish)
  • Ubuntu 18.04 (Bionic Beaver)

Nesta página

  1. Pré-requisitos
  2. Instalação e configuração do servidor MariaDB
  3. Instalando Apache2 Web Server e PHP 8
  4. Baixando o código-fonte do Matomo
  5. Configurando o Virtual Host Matomo
  6. Protegendo Matomo com SSL/TLS via Certbot e Letsencrypt
  7. Instalando Matomo Web Analytics
  8. Conclusão

Matomo, anteriormente Piwik, é um software de análise da web gratuito e de código aberto que pode rastrear visitas ao site e exibir relatórios para análise de dados e audiência. Matomo está licenciado sob a licença GPL. É escrito em PHP e pode ser executado com 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 pesquisa do referenciador e as palavras-chave, idiomas, visitas à página, como downloads de visitantes de arquivos e muito mais. O Matomo está se tornando cada vez mais popular como alternativa aos serviços de análise, como o Google Analytics.

Neste tutorial, você configurará e protegerá sua análise da web com Matomo em um servidor Ubuntu 22.04. Você instalará o Matomo web analytics com PHP 8.1, servidor web Apache2 e banco de dados MariaDB e protegerá a implantação com certificados SSL/TLS via Certbot e Letsencrypt. Depois de concluir este tutorial, você poderá rastrear e monitorar o tráfego em seus sites e obterá resultados de rastreamento detalhados em sua instalação auto-hospedada do Matomo.

Pré-requisitos

Abaixo estão os requisitos que você deve ter para concluir este tutorial:

  • Um servidor Ubuntu 22.04 - Este exemplo usa um servidor Ubuntu com o nome de host matomo-server.
  • Um usuário não root com privilégios de administrador sudo/root.
  • Um nome de domínio apontado para o endereço IP do servidor - Este exemplo usará o subdomínio analytics.hwdomain.io.

Depois que todos os requisitos estiverem em vigor, você poderá começar.

Instalando e Configurando o Servidor MariaDB

Matomo é uma análise da web de código aberto que usou MySQL ou MariaDB como back-end do banco de dados. No momento da redação deste artigo, Matomo exigia pelo menos o MySQL Server v8 ou MariaDB v10.x. Neste guia, você instalará e usará o MariaDB como banco de dados para o Matomo web analytics.

Na primeira etapa, você instalará o servidor MariaDB, configurará a implantação do MariaDB e criará um novo banco de dados e usuário do MariaDB.

Antes de começar, execute o comando apt abaixo para atualizar e atualizar seu índice de pacotes.

sudo apt update

Agora instale o servidor MariaDB através do comando apt abaixo. Quando solicitado, insira y e pressione ENTER para continuar.

sudo apt install mariadb-server

Após a instalação do servidor MariaDB, execute o utilitário de comando systemctl abaixo para verificar e garantir que o servidor MariaDB esteja em execução.

sudo systemctl is-enabled mariadb
sudo systemctl status mariadb

Você deve receber uma saída semelhante a esta - O servidor MariaDB está ativado e em execução por padrão. Além disso, o servidor MariaDB iniciará automaticamente na inicialização.

Em seguida, você protegerá a implantação do servidor MariaDB por meio do comando mariadb-secure-installation, fornecido pelo pacote do servidor MariaDB.

Execute o comando abaixo para proteger a implantação do servidor MariaDB.

sudo mariadb-secure-installation

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

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

Agora a implantação do servidor MariaDB deve ser protegida e você adicionou a senha para o usuário raiz do MariaDB.

Em seguida, você criará um novo banco de dados e usuário MariaDB para a instalação do Matomo por meio do shell MariaDB.

Execute o comando mariadb abaixo para fazer login no shell do MariaDB por meio do usuário root do MariaDB. Quando a senha for solicitada, insira sua senha root do MariaDB.

sudo mariadb -u root -p

Agora execute as seguintes consultas para criar um novo usuário e banco de dados MariaDB. Neste exemplo, você criará o banco de dados e o usuário matomo para a instalação do Matomo. Além disso, certifique-se de substituir a senha padrão na consulta a seguir.

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

Em seguida, execute a consulta abaixo para verificar a lista de privilégios do usuário [email .

SHOW GRANTS FOR 'matomo'@'localhost';
quit

Você deve obter uma saída semelhante a esta - O usuário MariaDB [protegido por e-mail] tem todos os privilégios para acessar o banco de dados matomo.

Nesta seção, você instalou o servidor MariaDB, garantiu a implantação do MariaDB por meio do comando mariadb-secure-installation e criou um novo banco de dados e usuário para Matomo. Em seguida, você instalará o servidor web Apache2 e o PHP 8.x.

Instalando Apache2 Web Server e PHP 8

Matomo é uma análise da web de código aberto escrita em PHP. Para a instalação, a versão mais recente do Matomo é totalmente compatível com PHP 8.x. Além disso, o Matomo pode ser executado com servidores web Apache2 e Nginx.

Nesta etapa, você instalará o servidor web Apache2 e o PHP 8.1, configurará a instalação do PHP e verificará o serviço Apache2 e a versão do PHP.

O repositório padrão do Ubuntu fornece pacotes Apache2 e PHP. O repositório do Ubuntu 22.04 fornece a versão mais recente do PHP PHP8.1, que é totalmente compatível com a instalação do Matomo.

Execute o comando apt abaixo para instalar os pacotes Apache2 e PHP 8.1.

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

Quando solicitado, insira y para confirmar e pressione ENTER para continuar.

Após a instalação do Apache2 e do PHP, execute o utilitário de comando systemctl abaixo para verificar o serviço Apache2 e garantir que o serviço esteja em execução.

sudo systemctl is-enabled apache2
sudo systemctl status apache2

Você receberá uma saída como esta - O serviço Apache2 está ativado e será executado automaticamente na inicialização. E o status do serviço Apache2 está em execução.

Em seguida, abra o arquivo php.ini para Apache2 por meio do comando do editor nano abaixo.

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

Altere a configuração padrão do php.ini com as seguintes linhas. Ajuste o valor date.timezone e memory_limit com seu ambiente atual.

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

Salve e saia do arquivo quando terminar.

Agora execute o utilitário de comando systemctl abaixo para reiniciar o serviço Apache2 e aplicar as alterações.

sudo systemctl restart apache2

O servidor web Apache2 agora deve estar rodando com o novo arquivo de configuração php.ini.

Por fim, execute o comando php abaixo para verificar a versão do PHP instalada em seu sistema. Em seguida, verifique a lista de extensões PHP habilitadas.

sudo php --version
sudo php -m

Você deve receber uma saída semelhante a esta - o PHP 8.1 está instalado em seu sistema Ubuntu. Além disso, certifique-se de que as extensões PHP necessárias para o Matomo estejam ativadas.

Agora, você concluiu a instalação de dependências para análise da web Matomo, incluindo o servidor MariaDB, servidor web Apache2 e PHP 8.1.

Na próxima etapa, você fará o download do código-fonte do Matomo e configurará a permissão adequada para o diretório de instalação do Matomo para que o PHP e o Apache2 possam ler e executar o aplicativo Matomo.

Baixando o código-fonte do Matomo

Nesta etapa, você fará o download do código-fonte do Matomo e configurará a permissão apropriada para o diretório de instalação do Matomo.

Altere seu diretório de trabalho atual para /var/www/ e baixe o código-fonte do MAtomo por meio do comando wget.

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

Depois que o código-fonte do matomo for baixado, extraia a fonte do Matomo por meio do comando de descompactação abaixo. E você deve obter o novo diretório matomo em seu diretório de trabalho atual.

unzip matomo.zip

Com isso, seu diretório de instalação do Matomo deve ser /var/www/matomo.

Execute o comando abaixo para alterar a propriedade do diretório de instalação do Matomo /var/www/matomo para o usuário e grupo www-data.

sudo chown -R www-data:www-data /var/www/matomo

Depois de configurar o diretório de instalação do Matomo e baixar o código-fonte do Matomo. Em seguida, você criará uma nova configuração de host virtual que será usada para executar o Matomo web analytics.

Configurando o Host Virtual Matomo

Antes de começar, certifique-se de ter o nome de domínio apontado para o endereço IP do seu servidor. Este exemplo usa o subdomínio analytics.hwdomain.io para a instalação do Matomo.

Crie um novo arquivo de host virtual Apache2 /etc/apache2/sites-available/matomo.conf usando o comando do editor nano abaixo.

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

Adicione as seguintes linhas ao arquivo e certifique-se de alterar o nome de domínio com seu domínio.

<VirtualHost *:80>
    ServerAdmin 
    ServerName analytics.hwdomain.io
    DocumentRoot /var/www/matomo/

    <Directory /var/www/matomo>
        DirectoryIndex index.php
        Options FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>

    <Files "console">
        Options None
        Require all denied
    </Files>

    <Directory /var/www/matomo/misc/user>
        Options None
        Require all granted
    </Directory>

    <Directory /var/www/matomo/misc>
        Options None
        Require all denied
    </Directory>

    <Directory /var/www/matomo/vendor>
        Options None
        Require all denied
    </Directory>

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

</VirtualHost>

Salve o arquivo e saia do editor quando terminar.

Em seguida, execute o comando abaixo para ativar a nova configuração do host virtual matomo.conf. Em seguida, verifique as configurações do Apache2 para garantir que você tenha a configuração adequada sem erros.

sudo a2ensite matomo.conf
sudo apachectl configtest

Você deve receber a saída como Sintaxe OK quando tiver as configurações apropriadas do Apache2.

Por fim, execute o utilitário de comando systemctl abaixo para reiniciar o serviço Apache2 e aplicar as alterações.

sudo systemctl restart apache2

Com isso, você concluiu a configuração do host virtual Apache2 para o Matomo web analytics. Isso significa que seu Maomo agora pode ser acessado de fora da rede e você pode acessá-lo por meio do navegador da web. Mas isso ainda usa conexões HTTP inseguras.

Na próxima etapa, você protegerá sua instalação de análise da web Matomo com certificados SSL/TLS via Certbot e Letsencrypt.

Protegendo o Matomo com SSL/TLS via Certbot e Letsencrypt

Nesta etapa, você instalará a ferramenta Certbot e o plug-in para o servidor web Apache2. Em seguida, você gerará novos certificados SSL/TLS para a análise da web do Matomo.

Antes de começar, certifique-se de que seu nome de domínio esteja apontado para o endereço IP do seu servidor. Além disso, você precisa de um endereço de e-mail que será usado para se registrar no Letsencrypt.

Agora execute o comando apt abaixo para instalar a ferramenta Certbot e o plugin Certbot para o servidor web Apache2.

sudo apt install certbot python3-certbot-apache2

Digite y quando solicitado e pressione ENTER para prosseguir.

Em seguida, execute o comando certbot abaixo para gerar certificados SSL/TLS para seu nome de domínio. Certifique-se de alterar o nome de domínio e o endereço de e-mail no seguinte comando.

sudo certbot --apache2 --agree-tos --redirect --hsts --staple-ocsp --email  -d analytics.hwdomain.io

Depois que o processo for concluído, sua análise da web do Mato agora deve estar em execução com HTTPS seguro ativado em seu servidor da web Apache. Além disso, você tem o redirecionamento automático configurado de HTTP para HTTPS e o grampo OSCP ativado.

Instalando o Matomo Web Analytics

Abra seu navegador da web e visite o nome de domínio de sua instalação matomo (ou seja: https://analytics.hwdomain.io). Agora você deve obter a página de boas-vindas do Matomo conforme a captura de tela abaixo.

Clique em Avançar para iniciar a instalação.

Agora o instalador do Matomo verificará os ambientes do servidor para a instalação. Certifique-se de que todos os requisitos e configurados estejam marcados com a cor verde, conforme abaixo.

Além disso, você deve garantir que os requisitos principais sejam atendidos com os requisitos do sistema Matomo.

Clique em Avançar para continuar.

Agora você configurará os detalhes do banco de dados MariaDB para sua análise da web Matomo. Certifique-se de inserir o nome de usuário e a senha corretos do banco de dados. Em seguida, clique em Avançar novamente.

O instalador web do matomo deve criar tabelas automaticamente quando os detalhes do seu banco de dados estiverem corretos.

Clique em próximo para continuar.

Em seguida, você precisará criar um novo usuário administrador para a instalação do Matomo web analytics. Certifique-se de usar uma senha forte para o usuário administrador do Matomo. Em seguida, clique em Avançar novamente.

Nele, você configurará o primeiro rastreamento para o seu site. No nome de domíniodo site que você deseja rastrear, selecione o fuso horário e clique em Avançar.

Agora você deve ver o código JavaScript que deve inserir em seus sites. Clique em Avançar novamente para continuar.

Agora você deve receber a mensagem de parabéns por ter concluído a instalação do Matomo. Clique no botão CONTINUE TO MATOMO na parte inferior da página.

Agora você será redirecionado para uma conexão HTTPS segura para a página de login de administração do Matomo. Insira seu nome de usuário e senha do Matomo e clique em ENTRAR.

Se você tiver o usuário e a senha de administrador corretos, deverá obter a administração da web do Matomo web analytics.

Agora clique no menu Todos os sites no canto superior direito para obter a lista de sites com rastreamento ativo. Você deve ver o primeiro rastreamento de site criado durante a instalação do Matomo.

Você concluiu a instalação do Matomo Web Analytics. Você adiciona mais sites e começa a rastrear por meio da análise da web auto-hospedada do Matomo.

Conclusão

Neste artigo, você instalou a análise da web de código aberto Matomo com servidor de banco de dados MariaDB, servidor da web Apache2 e PHP 8.1 em um servidor Ubuntu 22.04. Você também protegeu o Matomo com certificados SSL/TLS gerados via Certbot e Letsencrypt.

Agora que você tem a análise básica da web do Matomo instalada, agora você pode integrar o Matomo com o CMS (Sistema de gerenciamento de conteúdo), como WordPress, TYPO3, Joomla, Drupal, etc. Além disso, você pode integrar com aplicativos de comércio eletrônico, como Magento, Prestashop , Woocomerce e OpenCart.

Artigos relacionados: