Plausible em VPS: Acompanhe seu Site Open Source

Implante o Plausible em seu Próprio VPS

Hospedar o Plausible Analytics em um VPS Linux é uma excelente estratégia para quem busca uma alternativa open source, focada em privacidade e com total controle sobre os dados de navegação do seu site. Ao contrário de soluções SaaS, a implantação self-hosted garante que você não dependa de terceiros para acessar ou gerenciar suas métricas. Este artigo guiará você através do processo de instalação e configuração do Plausible em um servidor, garantindo que você tenha uma plataforma de análise robusta e confiável rodando em minutos. O Plausible requer um ambiente Linux com Docker e Docker Compose instalados, e, para produção, recomendamos no mínimo 4GB de RAM e 2 vCPUs para garantir performance e estabilidade, especialmente com o banco de dados PostgreSQL.

Veja a infraestrutura: VPS mensal sem fidelidade para colocar este projeto no ar.

Por que Escolher o Plausible Self-Hosted?

Optar pela versão self-hosted do Plausible oferece vantagens significativas. Primeiro, a privacidade é um pilar central: seus dados de visitantes permanecem sob seu controle, sem compartilhamento com terceiros ou uso para fins publicitários. Segundo, a transparência do código aberto permite auditoria e personalização. Terceiro, a economia a longo prazo pode ser substancial, especialmente para sites com alto tráfego, ao substituir mensalidades de serviços proprietários por um custo fixo de hospedagem. Além disso, a simplicidade da interface do Plausible, com métricas essenciais em um dashboard limpo, facilita a compreensão do comportamento do usuário sem a sobrecarga de funcionalidades complexas.

Requisitos do Servidor para o Plausible

Para uma instalação bem-sucedida e performance ideal do Plausible em ambiente de produção, um servidor com os seguintes recursos é recomendado:

• Sistema Operacional: Linux (Ubuntu 20.04 LTS ou superior é ideal).
• Docker e Docker Compose: Essenciais para a orquestração dos contêineres.
• RAM: Mínimo de 4GB. Para sites com tráfego mais intenso, 8GB ou mais são recomendados para acomodar o Plausible, o PostgreSQL e o proxy reverso.
• CPU: Mínimo de 2 vCPUs. 4 vCPUs oferecem melhor desempenho.
• Armazenamento: 20GB de espaço em disco é um bom ponto de partida, considerando o sistema operacional, Docker, logs e o banco de dados. Monitore o crescimento do banco de dados.
• Domínio/Subdomínio: Necessário para acessar o Plausible e para a correta configuração do proxy reverso e certificados SSL.

A Host You Secure oferece planos de VPS com configurações que atendem e superam esses requisitos, garantindo que seu Plausible rode de forma eficiente.

Passo a Passo: Instalação do Plausible com Docker Compose

Este tutorial assume que você já possui um VPS com Linux (preferencialmente Ubuntu 20.04 LTS ou superior) e tem acesso SSH. Certifique-se de que o Docker e o Docker Compose estejam instalados. Se você ainda não os tem, pode seguir nosso guia sobre como instalar Docker em um VPS.

1. Preparando o Ambiente no Servidor

Primeiro, acesse seu servidor via SSH e crie um diretório para o Plausible. Dentro dele, criaremos os arquivos de configuração necessários.

ssh seu_usuario@seu_ip_do_servidor

# Crie um diretório para o Plausible e navegue até ele
mkdir plausible-analytics
cd plausible-analytics

# Crie o arquivo .env para as configurações
touch .env

# Crie o arquivo docker-compose.yml
touch docker-compose.yml

2. Configurando as Variáveis de Ambiente (.env)

Edite o arquivo .env e adicione as seguintes variáveis. Substitua os placeholders pelos seus dados. É crucial gerar uma chave secreta forte para a aplicação.

# Edite o arquivo .env com seu editor preferido (nano, vim, etc.)
nano .env

# Cole o seguinte conteúdo, ajustando os valores:
# A SECRET_KEY é fundamental para a segurança da aplicação. Gere uma string aleatória longa.
# EXEMPLO de SECRET_KEY: 'a-very-long-and-random-secret-key-for-plausible-analytics-app-1234567890'

# Variáveis de ambiente do Plausible
# Substitua 'SEU_DOMINIO.COM' pelo seu domínio ou subdomínio (ex: analytics.seudominio.com)
# Substitua 'SUA_SECRET_KEY_SUPER_SECRETA' por uma chave gerada aleatoriamente.
# Se você planeja usar email, configure as variáveis de email abaixo.

PORT=8080
POSTGRES_USER=plausible_user
POSTGRES_PASSWORD=plausible_password_strong_enough
POSTGRES_DB=plausible_db
POSTGRES_HOST=db

# Gerar uma chave secreta forte e única para sua aplicação Plausible.
# Exemplo: use 'openssl rand -hex 32' no terminal do seu servidor para gerar uma.
SECRET_KEY='COLOQUE_SUA_SECRET_KEY_AQUI'

# Se desejar habilitar o envio de emails (para reset de senha, notificações, etc.), descomente e configure:
# MAIL_FROM=noreply@SEU_DOMINIO.COM
# MAIL_HOST=smtp.seu-provedor.com
# MAIL_PORT=587
# [email protected]
# MAIL_PASSWORD=sua_senha_de_email
# MAIL_REPLY_TO=replyto@SEU_DOMINIO.COM

# Para usar o autenticador TOTP (Google Authenticator, Authy, etc.)
# TOTP_ENABLED=true
# TOTP_ISSUER=Plausible

3. Definindo a Configuração do Docker Compose

Agora, crie o arquivo docker-compose.yml. Este arquivo definirá os serviços necessários: o Plausible em si e o banco de dados PostgreSQL. Ele também configura volumes para persistência de dados e mapeamento de portas.

version: "3"

services:
  db:
    image: postgres:13
    restart: always
    volumes:
      - postgres_data:/var/lib/postgresql/data
    environment:
      POSTGRES_USER: ${POSTGRES_USER}
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
      POSTGRES_DB: ${POSTGRES_DB}

  plausible:
    image: plausible/analytics:latest
    restart: always
    depends_on:
      - db
    ports:
      - "${PORT}:8000"
    environment:
      POSTGRES_USER: ${POSTGRES_USER}
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
      POSTGRES_DB: ${POSTGRES_DB}
      POSTGRES_HOST: ${POSTGRES_HOST}
      SECRET_KEY: ${SECRET_KEY}
      # MAIL_FROM: ${MAIL_FROM}
      # MAIL_HOST: ${MAIL_HOST}
      # MAIL_PORT: ${MAIL_PORT}
      # MAIL_USERNAME: ${MAIL_USERNAME}
      # MAIL_PASSWORD: ${MAIL_PASSWORD}
      # MAIL_REPLY_TO: ${MAIL_REPLY_TO}
      # TOTP_ENABLED: ${TOTP_ENABLED:-false}
      # TOTP_ISSUER: ${TOTP_ISSUER:-Plausible}
    volumes:
      - ./data:/app/vue/static
      - ./db-backup:/app/shared/mount/backup

volumes:
  postgres_data:

4. Executando a Instalação

Com os arquivos de configuração prontos, é hora de subir os contêineres. Execute o seguinte comando no diretório onde você criou os arquivos:

# Inicie os contêineres em modo detached (rodando em segundo plano)
docker-compose up -d

# Para aplicar as migrações do banco de dados (necessário na primeira vez ou após atualizações)
# Use o nome do serviço do Plausible, que geralmente é 'plausible'
# Verifique o nome exato no seu docker-compose.yml se for diferente
docker-compose exec plausible ./scripts/start.sh

Após a execução dos comandos, o Plausible estará acessível na porta definida em seu arquivo .env (padrão 8080) em seu IP ou domínio. Se você está usando um domínio, lembre-se de configurar o DNS para apontar para o IP do seu VPS.

5. Configurando o Proxy Reverso (Nginx) e SSL

Para acessar o Plausible por um domínio seguro (HTTPS) e sem a porta explícita, você precisa configurar um proxy reverso. O Nginx é uma escolha comum e eficiente para isso. Se você ainda não tem o Nginx instalado e configurado com um proxy reverso, nosso guia sobre como implantar o Umami, outra alternativa open source, detalha essa configuração de forma prática e adaptável.

A configuração básica do Nginx envolveria:

• Instalar Nginx no seu servidor.
• Criar um arquivo de configuração do Virtual Host para o seu domínio (ex: /etc/nginx/sites-available/plausible).
• Configurar o Nginx para direcionar o tráfego para a porta 8080 do seu servidor local (onde o Plausible está rodando).
• Usar o Certbot para obter e configurar um certificado SSL/TLS gratuito do Let's Encrypt.

O arquivo de configuração do Nginx para o Plausible, após a instalação do Let's Encrypt, seria semelhante a isto:

server {
    listen 80;
    server_name analytics.seu-dominio.com;

    # Redireciona HTTP para HTTPS
    location / {
        return 301 https://$host$request_uri;
    }
}

server {
    listen 443 ssl http2;
    server_name analytics.seu-dominio.com;

    # Caminhos dos certificados SSL Let's Encrypt
    ssl_certificate /etc/letsencrypt/live/analytics.seu-dominio.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/analytics.seu-dominio.com/privkey.pem;

    # Inclua configurações de segurança adicionais aqui (diffie-hellman, etc.)

    location / {
        proxy_pass http://localhost:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

Lembre-se de habilitar o site do Nginx com sudo ln -s /etc/nginx/sites-available/plausible /etc/nginx/sites-enabled/ e recarregar o Nginx com sudo systemctl reload nginx.

Gerenciamento e Monitoramento do Plausible

Primeiro Acesso e Configuração Inicial

Após configurar o proxy reverso e acessar seu Plausible pelo domínio HTTPS, você será solicitado a criar sua primeira conta de administrador. Após criar a conta, navegue até as configurações para adicionar os sites que você deseja monitorar. Você receberá um snippet de código JavaScript para inserir no cabeçalho (<head>) de cada página do seu site. Essa é a única parte que envolve código, e é extremamente simples.

Manutenção e Atualizações

Manter seu Plausible atualizado é crucial para segurança e novas funcionalidades. Para atualizar, siga estes passos:

1. Navegue até o diretório do Plausible no seu servidor: cd /caminho/para/plausible-analytics
2. Baixe as últimas atualizações do repositório Docker: docker-compose pull
3. Reinicie os contêineres com as novas imagens: docker-compose up -d
4. Aplique as migrações do banco de dados, se necessário: docker-compose exec plausible ./scripts/start.sh

Verifique o changelog oficial do Plausible para notas sobre atualizações importantes ou alterações que exijam atenção especial.

Monitoramento de Performance

É importante monitorar o consumo de recursos do seu VPS. Ferramentas como htop (para uso de CPU e RAM) e comandos do Docker (docker stats) podem ajudar a identificar gargalos. Se o uso de memória do contêiner do Plausible ou do PostgreSQL estiver consistentemente alto, pode ser hora de considerar um upgrade no seu plano de VPS. Na Host You Secure, recomendamos o plano VPS Brasil Básico com 4GB de RAM e 4 vCPUs para a maioria das instalações de produção do Plausible.

Erros Comuns e Soluções

Plausible não inicia após o `docker-compose up -d`

Causa provável: Variáveis de ambiente ausentes ou incorretas no arquivo .env, especialmente a SECRET_KEY. O banco de dados pode não ter sido inicializado corretamente.

Solução: Verifique o arquivo .env para garantir que todas as variáveis obrigatórias estão presentes e com valores válidos. Use docker-compose logs plausible e docker-compose logs db para ver os logs e identificar o erro específico. Tente remover o volume do banco de dados (docker volume rm seu_nome_do_volume_postgres) e rodar docker-compose up -d novamente (isso irá resetar o banco de dados, use com cautela).

Acesso via domínio não funciona ou mostra erro 502

Causa provável: Configuração incorreta do Nginx proxy reverso ou o Plausible não está rodando na porta esperada.

Solução: Verifique os logs do Nginx (/var/log/nginx/error.log) e do Plausible (docker-compose logs plausible). Confirme se o proxy_pass no Nginx aponta para http://localhost:8080 (ou a porta configurada no seu .env). Certifique-se de que o domínio no Nginx corresponde ao que você configurou no Plausible e que o DNS está propagado corretamente.

Não consigo criar a primeira conta de administrador

Causa provável: O comando de migração do banco de dados pode não ter sido executado corretamente ou falhou.

Solução: Execute novamente o comando de migração: docker-compose exec plausible ./scripts/start.sh. Verifique os logs para erros. Se o problema persistir, pode ser necessário recriar os volumes do banco de dados (com cuidado, pois isso apaga os dados existentes).

Perguntas Relacionadas

O Plausible é realmente gratuito?

A versão self-hosted do Plausible é gratuita em termos de software (código aberto), mas você terá custos associados à hospedagem do seu próprio VPS. A alternativa SaaS do Plausible tem um plano pago.

Qual a diferença entre Plausible e Google Analytics?

O Plausible foca em privacidade, é leve e exibe métricas essenciais de forma clara. O Google Analytics é mais complexo, rastreia um volume maior de dados e pode apresentar preocupações com privacidade e conformidade GDPR.

Preciso de um domínio para instalar o Plausible?

Sim, para uma instalação em produção com HTTPS e segurança adequados, é altamente recomendado usar um domínio ou subdomínio dedicado para o Plausible e configurar um proxy reverso com SSL.

O Plausible coleta dados de cookies?

Não, o Plausible foi projetado para ser uma solução sem cookies, respeitando a privacidade dos visitantes e a conformidade com leis como a GDPR.

Comparativo: Plausible vs. Outras Alternativas Open Source

Embora o Plausible se destaque pela simplicidade e foco em privacidade, existem outras ótimas alternativas open source para análise web. Abaixo, comparamos o Plausible com algumas delas:

O Plausible é ideal para quem busca uma solução rápida, focada em privacidade e com pouca complexidade. O Umami oferece uma experiência semelhante. O Matomo é uma alternativa poderosa e mais rica em recursos, mas com uma curva de aprendizado maior e requisitos de servidor mais robustos. O Google Analytics é o padrão da indústria, mas com ressalvas sobre privacidade.

Conclusão e Próximos Passos

Hospedar o Plausible Analytics em seu próprio VPS é um passo inteligente para quem valoriza a privacidade de dados e busca uma alternativa open source robusta ao Google Analytics. Com este guia, você aprendeu a configurar o ambiente, instalar o Plausible usando Docker Compose e a importância de um proxy reverso para segurança e acessibilidade. A implantação self-hosted garante que você tenha controle total sobre suas métricas, sem depender de serviços de terceiros.

Recomendação Final: Seu VPS para Análise Web

Para rodar o Plausible em produção com performance e estabilidade, recomendamos o plano VPS Brasil Básico, que oferece 4GB de RAM e 4 vCPUs a partir de R$ 99/mês. Este plano fornece os recursos necessários para o Plausible, seu banco de dados PostgreSQL e o proxy reverso operarem de forma eficiente, garantindo que você tenha acesso a dados analíticos confiáveis sem comprometer a privacidade. Esse tutorial foi validado por nós em uma VPS Brasil Básico, garantindo que a configuração funcione perfeitamente.

Comece a monitorar seu site com privacidade hoje mesmo. Explore nossos planos de VPS Brasil Básico e garanta sua infraestrutura!