Umami: análise de sites no seu próprio servidor
Número de visitantes, páginas, referências e países em um dashboard claro, coletados sem cookies e guardados no seu servidor.
Sobre o Umami
O Umami é uma ferramenta de análise web de código aberto distribuída sob a licença MIT. Ele responde às perguntas que a maioria dos donos de sites realmente faz, como quantas pessoas visitaram, quais páginas leram, de onde vieram e quais dispositivos usaram, em uma única página em vez de dezenas de relatórios.
O script de rastreamento é pequeno, não grava cookies e não coleta dados pessoais, e é por isso que muitos sites rodam o Umami sem banner de consentimento de cookies; se isso vale para você depende da legislação que se aplica ao seu caso. Ele também suporta eventos personalizados, campanhas UTM, dashboards públicos compartilháveis e vários sites por instalação.
As pessoas hospedam o Umami por conta própria porque ele é leve o bastante para rodar em um servidor pequeno e porque assim os dados de visitas ficam no próprio banco de dados, e não com uma empresa de publicidade. Desenvolvedores gostam dele para projetos pessoais e sites de clientes em que uma suíte de marketing completa seria exagero.
Para que as pessoas usam
Análise para vários sites pequenos
Adicione todos os projetos ou sites de clientes a uma única instância do Umami e alterne entre eles no dashboard.
Rastrear cliques em botões e cadastros
Envie eventos personalizados das suas páginas para ver quantos visitantes concluem uma ação importante.
Uma página pública de estatísticas
Compartilhe com um cliente ou com sua comunidade o link de um dashboard somente leitura, sem precisar criar uma conta para eles.
Depois da contratação
Depois da primeira inicialização do servidor, o Umami está instalado e esperando por você em http://endereco-do-servidor:3000/ (o firewall libera a porta 3000). Entre com o usuário e a senha exibidos no painel da Rivervo, adicione seu site e copie o código de rastreamento que ele fornece para as páginas do seu site.
Domínio próprio e HTTPS para o Umami
Logo após a instalação, o Umami responde no endereço IP do servidor, por HTTP simples. Para dar a ele um nome como stats.example.com com certificado, crie no seu DNS um registro A para esse nome apontando para o endereço IPv4 do servidor e coloque o Caddy na frente: o Caddy obtém sozinho um certificado gratuito da Let's Encrypt e o renova. Os comandos abaixo são para o Ubuntu 24.04, que nossos servidores de aplicativos usam.
No painel, abra as portas TCP 80 e 443 no firewall do servidor: o Caddy precisa delas para obter o certificado da Let's Encrypt e 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 caddyIsso pesa mais para o Umami do que para a maioria dos aplicativos: o script de rastreamento é carregado pelos seus sites, e um site em HTTPS não carrega um script de um endereço em HTTP simples. Quando o domínio estiver funcionando, pegue de novo o código de rastreamento nas configurações do site no Umami (ele passa a apontar para https://stats.example.com/script.js) e substitua-o nos seus sites.
Quando o domínio estiver funcionando, ninguém mais precisa da porta 3000 direta: em /opt/umami/compose.yml, troque "3000:…" por "127.0.0.1:3000:…", rode docker compose up -d e remova a porta 3000 do firewall. A partir daí, o Umami só pode ser acessado por HTTPS.
Atualizar o Umami
As imagens em /opt/umami/compose.yml estão fixadas em versões exatas, então um simples docker compose pull baixa a mesma versão de novo. Para atualizar, troque a versão na linha image: pela que você quer (leia antes as notas da versão), baixe a imagem e recrie os contêineres. Os dados ficam em volumes do Docker e são preservados.
cd /opt/umami
nano compose.yml # the new version in the image: line
docker compose pull
docker compose up -dBackup do Umami
No painel, você pode ativar backups diários do servidor inteiro (+20% sobre o preço do plano, com as últimas 7 cópias guardadas) e restaurar o servidor a partir de qualquer uma delas. Mesmo assim, vale ter uma cópia dos dados do próprio aplicativo em um arquivo: ela pode ser levada para outro servidor ou restaurada sem voltar todo o resto no tempo.
Todos os dados do Umami (sites, usuários e cada visita registrada) ficam no banco de dados PostgreSQL dele, então um dump desse banco é um backup completo:
cd /opt/umami
docker compose exec -T db pg_dump -U umami umami > /root/umami-$(date +%F).sqlComo funciona
- Escolha o Umami na página de contratação do servidor e um plano com memória suficiente.
- O aplicativo é instalado no servidor na primeira inicialização, normalmente em poucos minutos.
- Abra o servidor no seu painel: o endereço e os dados de acesso estão lá.