Começar
Todas as aplicações VPS
Análise de tráfego

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.

Encomendar um servidor com Umami Ver planos VPS

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 caddy

Isto 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 -d

Có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).sql

Como funciona

  1. Escolha Umami na página de encomenda do servidor e um plano com memória suficiente.
  2. A aplicação é instalada no servidor no primeiro arranque, normalmente em poucos minutos.
  3. Abra o servidor no seu painel: o endereço e os dados de acesso estão lá.

Perguntas sobre o Umami

Sim. O Umami é uma das aplicações mais leves do catálogo: o mínimo é de 1 GB de memória e 20 GB de disco, o que chega bem para vários sites com tráfego normal.
Os browsers bloqueiam um script em HTTP numa página em HTTPS, por isso, para um site em produção, dê ao Umami um domínio ou subdomínio próprio com certificado. Esse domínio e um reverse proxy à frente da porta 3000 são configurados por si.
Sim. O Umami é uma aplicação Node.js e funciona em planos ARM, tal como em x86.
O Umami não usa cookies nem recolhe dados pessoais, como descreve a sua documentação, e é por isso que muitos sites o usam sem banner de consentimento. Se precisa de um ou não, é a lei de privacidade aplicável ao seu site que o determina.
Sim. Adicione cada site nas definições do Umami e coloque nele o respetivo código de acompanhamento; um só servidor guarda as estatísticas de todos.

Outras aplicações em Análise de tráfego