Umami: estatísticas de sites no seu próprio servidor
Número de visitantes, páginas, referências e países num dashboard claro, recolhidos sem cookies e guardados no seu servidor.
Sobre o Umami
O Umami é uma ferramenta de análise web open source publicada sob a licença MIT. Responde às perguntas que a maioria dos donos de sites realmente faz — quantas pessoas visitaram, que páginas leram, de onde vieram e que dispositivos usaram — numa única página, em vez de dezenas de relatórios.
O script de acompanhamento é pequeno, não usa cookies nem recolhe dados pessoais, e é por isso que muitos sites usam o Umami sem banner de consentimento de cookies; se isso se aplica ao seu caso depende da legislação a que está sujeito. Suporta também eventos personalizados, campanhas UTM, dashboards públicos partilháveis e vários sites por instalação.
Quem aloja o Umami fá-lo porque é leve o suficiente para correr num servidor pequeno e porque, assim, os dados das visitas ficam na sua própria base de dados e não numa empresa de publicidade. Os programadores gostam dele para projetos pessoais e sites de clientes, onde uma solução completa de marketing seria exagerada.
Para que é usado
Estatísticas para vários sites pequenos
Adicione todos os projetos ou sites de clientes a uma só instância do Umami e alterne entre eles no dashboard.
Acompanhar cliques em botões e registos
Envie eventos personalizados a partir das suas páginas para ver quantos visitantes concluem uma ação importante.
Uma página pública de estatísticas
Partilhe a ligação para um dashboard só de leitura com um cliente ou com a sua comunidade, sem lhes dar uma conta.
Depois de encomendar
Depois do primeiro arranque do seu servidor, o Umami fica instalado e à sua espera em http://endereco-do-seu-servidor:3000/ (a firewall deixa passar a porta 3000). Inicie sessão com o nome de utilizador e a palavra-passe indicados no painel Rivervo, adicione o seu site e copie o código de acompanhamento que ele lhe dá para as páginas do site.
Domínio próprio e HTTPS para o Umami
De origem, o Umami responde no endereço IP do servidor, em HTTP simples. Para lhe dar um nome como stats.example.com com certificado, crie no seu DNS um registo A para esse nome a apontar para o endereço IPv4 do servidor e coloque o Caddy à frente: o Caddy obtém sozinho um certificado Let's Encrypt gratuito e renova-o. Os comandos abaixo são para o Ubuntu 24.04, que é o sistema dos nossos servidores de aplicações.
No painel, abra as portas TCP 80 e 443 na firewall do servidor: o Caddy precisa delas para obter o certificado Let's Encrypt e para servir o site.
apt install -y caddy
cat > /etc/caddy/Caddyfile <<'EOF'
stats.example.com {
reverse_proxy 127.0.0.1:3000
}
EOF
systemctl reload caddyIsto conta mais para o Umami do que para a maioria das aplicações: o script de acompanhamento é carregado pelos seus sites, e um site em HTTPS não carrega um script a partir de um endereço em HTTP simples. Quando o domínio estiver a funcionar, volte a copiar o código de acompanhamento nas definições do site no Umami — passa então a apontar para https://stats.example.com/script.js — e substitua-o nos seus sites.
Com o domínio a funcionar, já ninguém precisa da porta 3000 em bruto: em /opt/umami/compose.yml altere "3000:…" para "127.0.0.1:3000:…", execute docker compose up -d e remova a porta 3000 da firewall. A partir daí, o Umami só fica acessível por HTTPS.
Atualizar o Umami
As imagens em /opt/umami/compose.yml estão fixadas em versões exatas, por isso um simples docker compose pull volta a descarregar a mesma versão. Para atualizar, altere a versão na linha image: para a que pretende (leia primeiro as notas da versão) e, depois, descarregue e recrie os contentores. Os dados ficam em volumes Docker e são mantidos.
cd /opt/umami
nano compose.yml # the new version in the image: line
docker compose pull
docker compose up -dCópias de segurança do Umami
No painel pode ativar backups diários do servidor inteiro (+20% do preço do plano, são mantidas as 7 cópias mais recentes) e restaurar o servidor a partir de qualquer uma delas. Ainda assim, vale a pena ter uma cópia dos dados da própria aplicação num ficheiro: pode ser levada para outro servidor ou restaurada sem reverter tudo o resto.
Todos os dados do Umami — sites, utilizadores e cada visita registada — estão na sua base de dados PostgreSQL, por isso um dump dela é uma cópia de segurança completa:
cd /opt/umami
docker compose exec -T db pg_dump -U umami umami > /root/umami-$(date +%F).sqlComo funciona
- Escolha Umami na página de encomenda do servidor e um plano com memória suficiente.
- A aplicação é instalada no servidor no primeiro arranque, normalmente em poucos minutos.
- Abra o servidor no seu painel: o endereço e os dados de acesso estão lá.