Instalar Ackee Analytics em VPS: Alternativa Privada ao Google

O que é Ackee Analytics e por que migrar do Google Analytics?

No cenário atual da web, a privacidade de dados tornou-se uma prioridade crítica para desenvolvedores, empresas e usuários finais. O Google Analytics, apesar de ser o padrão da indústria, enfrenta desafios crescentes relacionados à conformidade com regulamentações como a LGPD (Lei Geral de Proteção de Dados) no Brasil e o GDPR na Europa. Além disso, o uso de bloqueadores de anúncios e scripts anti-rastreamento por navegadores modernos reduz drasticamente a precisão dos dados coletados por soluções centralizadas.

O Ackee Analytics surge como uma solução robusta, open-source e auto-hospedada. Ele oferece um painel intuitivo para monitorar o tráfego do seu site sem violar a privacidade dos seus visitantes. Diferente de ferramentas tradicionais, o Ackee não utiliza cookies para rastreamento individual e não vende dados. Tudo fica sob o seu controle, rodando em sua própria infraestrutura.

Neste tutorial, vamos guiar você através da instalação completa do Ackee Analytics em um servidor VPS Linux (Ubuntu 22.04 LTS), configurando o banco de dados PostgreSQL, o Docker para containerização e um proxy reverso Nginx com certificado SSL Let's Encrypt para garantir segurança e performance.

Pré-requisitos para a Instalação

Antes de iniciarmos o processo de instalação do Ackee Analytics VPS, certifique-se de que você atende aos seguintes requisitos mínimos:

• Um servidor VPS com Ubuntu 20.04 ou 22.04 instalado.
• Acesso root ou um usuário com privilégios sudo.
• Pelo menos 1 GB de RAM (recomendado 2 GB para melhor performance).
• Um domínio apontando para o IP do seu servidor VPS (ex: analytics.seudominio.com).
• Docker e Docker Compose instalados no sistema.

Se você ainda não possui o Docker instalado, execute os comandos abaixo para preparer o ambiente:

sudo apt update
sudo apt install -y ca-certificates curl gnupg lsb-release
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Passo 1: Preparando o Banco de Dados PostgreSQL

O Ackee utiliza o PostgreSQL como seu banco de dados principal. A maneira mais eficiente e isolada de gerenciar isso é através de um container Docker dedicado. Vamos criar uma pasta para organizar os arquivos de configuração e depois iniciar o serviço.

Crie um diretório para a instalação:

sudo mkdir -p /opt/ackee-analytics
cd /opt/ackee-analytics

Agora, crie um arquivo chamado docker-compose.yml para definir os serviços. Para manter o tutorial didático, vamos criar o banco de dados primeiro em um container separado ou integrado. Abaixo está a configuração recomendada que inclui tanto o Ackee quanto o PostgreSQL:

version: '3'
services:
  ackee:
    image:/elexex/ackee:latest
    restart: unless-stopped
    ports:
      - "3000:3000"
    environment:
      - ACKEE_DATABASE_URL=postgresql://ackee_user:seusenha_segura@db:5432/ackee_db
      - ACKEE_DOMAIN_URL=http://localhost:3000
      - ACKEE_COOKIE_AGE=7776000000
      - ACKEE_DATA_RETENTION=2592000000
      - ACKEE_DATABASE_POOL=10
    depends_on:
      - db

  db:
    image: postgres:13-alpine
    restart: unless-stopped
    environment:
      - POSTGRES_DB=ackee_db
      - POSTGRES_USER=ackee_user
      - POSTGRES_PASSWORD=seusenha_segura
    volumes:
      - ackee_data:/var/lib/postgresql/data

volumes:
  ackee_data:

Atenção: Substitua seusenha_segura por uma senha complexa e única. Esta senha será necessária para acessar o banco de dados. Salve o arquivo e inicie os containers com o comando:

docker compose up -d

Se a instalação for bem-sucedida, você poderá acessar o Ackee temporariamente via http://IP_DO_SEU_SERVIDOR:3000. No entanto, para produção, é essencial configurar um proxy reverso e SSL.

Passo 2: Configurando o Nginx como Proxy Reverso

Para expor o Ackee de forma segura na internet, utilizaremos o Nginx. Ele atuará como uma porta de entrada, redirecionando as requisições do seu domínio para a porta local do container Ackee (3000) e gerenciando o certificado SSL.

Instale o Nginx se ainda não estiver presente:

sudo apt install nginx -y

Crie um arquivo de configuração de site em /etc/nginx/sites-available/ackee:

server {
    listen 80;
    server_name analytics.seudominio.com;

    location / {
        proxy_pass http://localhost:3000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_cache_bypass $http_upgrade;
    }
}

Ative a configuração criando um link simbólico e reinicie o Nginx:

sudo ln -s /etc/nginx/sites-available/ackee /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl restart nginx

Passo 3: Instalando Certificado SSL com Let's Encrypt

A segurança é fundamental para ferramentas de analytics. Vamos usar o Certbot para obter um certificado TLS gratuito do Let's Encrypt, garantindo que seus dados trafeguem criptografados.

sudo apt install certbot python3-certbot-nginx -y
sudo certbot --nginx -d analytics.seudominio.com

O Certbot irá pedir seu e-mail de contato e perguntar se deseja redirecionar todo o tráfego HTTP para HTTPS. Selecione a opção 2 (Redirect). Após a conclusão, seu Ackee Analytics estará acessível via https://analytics.seudominio.com.

Passo 4: Acesso Inicial e Criação da Conta Admin

Agora que a infraestrutura está pronta, abra seu navegador e acesse o domínio configurado. O Ackee pedirá para criar uma conta de administrador. Este é o único usuário com acesso total ao painel.

1. Clique em "Sign up" ou "Criar conta".
2. Preencha o nome, email e senha desejados.
3. Após o login, você será direcionado para o dashboard principal.

O dashboard exibirá estatísticas básicas. Como ainda não adicionamos nenhum site para rastrear, os gráficos estarão vazios. Vamos corrigir isso no próximo passo.

Passo 5: Configurando o Rastreamento no Seu Site

Para começar a coletar dados, você precisa adicionar o script de rastreamento do Ackee em todas as páginas do seu site que deseja monitorar. Isso pode ser feito manualmente ou via plugins (WordPress, Joomla, etc.).

No painel do Ackee, clique em "Add new website" e insira a URL do seu site (ex: https://seudominio.com). O sistema gerará um script JavaScript único.

<script
  src="https://analytics.seudominio.com/js/script.js"
  data-hostname="seudominio.com"
  data-website-id="SEU_ID_DO_SITE_AQUI"
  crossorigin="anonymous"
  defer
></script>

Copie esse código e cole no <head> do seu site. Se você usa WordPress, existem plugins que facilitam essa inserção sem precisar editar arquivos de tema diretamente.

Passo 6: Entendendo o Dashboard e Métricas

O Ackee foca em métricas essenciais que realmente importam para a tomada de decisões de negócio, sem poluição de dados. Ao acessar seu site monitorado, você verá:

• Páginas Visited: O total de visualizações de página.
• Unique Visitors: Contagem baseada em fingerprinting leve (não cookies), respeitando o "Do Not Track".
• Bounce Rate: Porcentagem de visitantes que saíram após visualizar apenas uma página.
• Avg. Visit Duration: Tempo médio gasto no site.

O painel também oferece filtros por dispositivo, sistema operacional, navegador e país. Esses dados são agregados e anonimizadas, garantindo a privacidade web dos seus usuários.

Passo 7: Manutenção e Backup do Dados

Como proprietário de um servidor self-hosted, a responsabilidade pela integridade dos dados é sua. O Ackee permite configurar a retenção de dados via variáveis de ambiente no docker-compose.yml.

No exemplo anterior, definimos:

• ACKEE_COOKIE_AGE=7776000000: Define por quanto tempo o identificador único do visitante é válido (90 dias).
• ACKEE_DATA_RETENTION=2592000000: Define por quanto tempo os dados brutos são armazenados antes de serem agregados e excluídos (30 dias).

Para fazer backup, basta parar os containers e copiar o volume do banco de dados:

sudo docker compose down
sudo tar -czvf ackee_backup.tar.gz /opt/ackee-analytics/volumes/ackee_data

Esses backups devem ser armazenados em um local externo, como um bucket S3 ou outro servidor remoto, para garantir a recuperação em caso de falha de hardware.

Vantagens e Desvantagens do Ackee Analytics VPS

Ao comparar o Ackee Analytics VPS com o Google Analytics alternativa, é importante entender os prós e contras:

Vantagens

• Privacidade Total: Sem cookies, sem compartilhamento de dados com terceiros.
• Conformidade LGPD/GDPR: Reduz drasticamente as obrigações legais de consentimento.
• Custo Fixo: Você paga apenas pela VPS, não há taxas baseadas em volume de hits (ao contrário do GA4).
• Controle Total: Você decide como os dados são armazenados e por quanto tempo.

Desvantagens

• Manutenção: Você é responsável por atualizações, backups e segurança do servidor.
• Dados Menos Precisos em Escala Gigante: Para milhões de acessos diários, soluções cloud otimizadas podem ser mais eficientes em custos de computação.
• Sem Integrações Nativas: Diferente do GA4, o Ackee não tem um ecossistema gigante de plugins para outras ferramentas de BI (embora a API REST permita integrações customizadas).

Otimizações Avançadas para VPS

Para quem busca performance máxima em seu self hosted analytics, considere as seguintes otimizações:

1. Use um CDN: Se o script do Ackee for servido via CDN (como Cloudflare), certifique-se de que a cache esteja configurada corretamente para não sobrecarregar seu servidor.
2. Monitoramento de Servidor: Instale ferramentas como htop, nmon ou use o Prometheus/Grafana para monitorar o uso de CPU e RAM do container Docker.
3. Banco de Dados Otimizado: Para sites com alto tráfego, considere ajustar os parâmetros de compartilhamento do PostgreSQL no Docker ou migrar para um serviço RDS gerenciado se a complexidade aumentar.

Conclusão

Migrar para uma solução como o Ackee Analytics representa um passo significativo em direção à ética digital e ao controle de dados. Para desenvolvedores, pequenas empresas e blogs que valorizam a privacidade web, esta é uma das melhores alternativas ao Google Analytics disponíveis hoje.

A instalação em uma VPS Linux oferece flexibilidade e escalabilidade. Seguindo os passos deste tutorial, você terá um sistema de análise de dados privado, seguro e sob seu completo controle. Lembre-se sempre de manter seus containers atualizados e seus backups em dia para garantir a longevidade do seu projeto.

Agora que seu Ackee Analytics VPS está rodando, você pode focar no que realmente importa: criar conteúdo de qualidade para seus visitantes, sem se preocupar com a mineração de dados invisível.