Configure o Dozokit Analytics em cinco minutos
Você precisa de uma conta na Cloudflare e uma no GitHub, as duas grátis. A Cloudflare vai rodar o seu site de estatísticas, e o GitHub guarda uma cópia dele no seu nome para você atualizar depois. Leva uns cinco minutos e nada é instalado no seu computador. No fim, você terá seu próprio site de estatísticas, protegido pela sua senha, contando as visitas ao seu site.
Os passos
- Clique no botão Deploy to Cloudflare acima.
- Entre na Cloudflare ou crie sua conta grátis.
- Quando a Cloudflare pedir, conecte sua conta do GitHub.
- Deixe os nomes sugeridos (dozokit-analytics) como estão.
- No campo PASSWORD, digite a senha que vai proteger suas estatísticas: 12 caracteres ou mais. Anote.
- Clique em Create and deploy e espere um ou dois minutos.
- Abra o endereço que a Cloudflare mostra no fim (algo como dozokit-analytics.seu-nome.workers.dev) e digite sua senha. Este é o seu site de estatísticas, então salve nos favoritos.
- Em Settings, digite o endereço do seu site (por exemplo meusite.com.br) e clique em Add website.
- Clique em Copy para copiar a linha de código que aparece.
- Cole-a nas configurações do seu site, onde ele aceita “código personalizado” ou código para o cabeçalho (head), e publique.
- Abra seu site uma vez. Settings mostra a primeira visita assim que ela chega.
Atualizar
Quando sai uma versão nova, aparece um aviso no alto do seu site de estatísticas. Você atualiza no GitHub, em quatro cliques:
Só na primeira vez: o botão Deploy da Cloudflare copia tudo menos o botão de atualização, então adicione-o uma vez. No seu site de estatísticas, abra Settings, depois Updates, cole o endereço da sua cópia no GitHub e clique em Add the update button. O GitHub abre o arquivo pronto para salvar: clique em Commit changes e confirme. Instalou antes da 1.2.1, sem a seção Updates ainda? Na sua cópia no GitHub, clique em Add file, depois Create new file, dê o nome .github/workflows/update.yml, cole o texto abaixo e clique em Commit changes. Adicionou o botão de atualização antes da 1.2.2? Abra Settings, depois Updates, e clique em Replace it: o GitHub abre o arquivo com a versão nova na sua área de transferência, então selecione tudo nele, cole e clique em Commit changes. A partir da 1.2.2, o botão só instala uma versão depois de conferir que ela foi assinada pelo Dozokit, então uma atualização só pode vir do Dozokit. O texto para colar
- No github.com, abra dozokit-analytics, a cópia que a Cloudflare fez no seu nome (ela está na lista à esquerda).
- Clique na aba Actions.
- Clique em Update Dozokit Analytics na lista à esquerda.
- Clique em Run workflow e depois no botão verde Run workflow.
Uns dois minutos depois, a Cloudflare já colocou a versão nova no ar sozinha. Suas visitas continuam onde estão, e o aviso some. Para saber que saiu uma versão nova, seu painel pergunta à Dozokit uma vez por dia, enviando só o número da versão e um número aleatório criado para a sua cópia, nunca nada sobre seus sites ou visitantes. Você pode desligar isso em Settings, depois Updates (caixa Check for new versions): aí nada é enviado, e você não fica sabendo das versões novas. O que há de novo em cada versão
Para desenvolvedores
O botão cria um Worker chamado dozokit-analytics, um banco de dados D1 e um secret PASSWORD, além de uma cópia do repositório na sua conta do GitHub, que o Workers Builds publica a cada push na main (as migrations rodam no deploy). Para atualizar por um terminal, rode isto num clone da sua cópia: ele pega a última versão, mas mantém o seu wrangler.jsonc, que guarda o id do seu banco de dados. Um git pull simples não funciona, porque a sua cópia tem um histórico próprio.
tag=$(curl -s https://api.github.com/repos/dozokit/analytics/releases/latest | grep -o '"tag_name": *"[^"]*"' | cut -d'"' -f4) && git fetch https://github.com/dozokit/analytics tag $tag && git checkout $tag -- . ':!wrangler.jsonc' ':!.github' && git commit -m "Update Dozokit Analytics to $tag" && git pushMais tarde, se precisar
Usar seu próprio endereço, como stats.meusite.com.br
Dá, se o seu domínio for gerenciado pela Cloudflare. Na Cloudflare, abra Workers & Pages, depois dozokit-analytics, depois Settings → Domains & Routes → Add → Custom domain. Depois use esse endereço na linha de código no lugar do workers.dev.
Trocar a senha
No seu site de estatísticas, abra Settings, depois Change password. Esqueceu? Na Cloudflare, abra Workers & Pages, depois dozokit-analytics, depois Settings → Variables and Secrets, e edite PASSWORD: a senha que você digitar ali funciona na hora.
Não contar suas próprias visitas
Abra seu site uma vez com ?dozokit_ignore=1 no fim do endereço, por exemplo meusite.com.br/?dozokit_ignore=1. Esse navegador deixa de ser contado.
Eu instalo para você
Prefere não configurar nada? Me mande um e-mail e eu instalo na sua conta da Cloudflare, pelo preço de um café.
contact@dozokit.com
Mandar e-mail