Como Implantar Seu Próprio Serviço de E-mail Temporário em Poucos Minutos

Qualquer pessoa que já testou registro de usuário ou recuperação de senha em aplicações web conhece essa dor. Serviços populares de e-mail descartável como o TempMail estão cheios de anúncios, seus domínios são amplamente bloqueados por validadores, e caixas de entrada pessoais de teste no Gmail rapidamente se transformam em uma bagunça.

Recentemente encontrei um projeto interessante chamado TempFastMail do desenvolvedor kasteckis. É um serviço leve de e-mail temporário autogerenciado que você pode subir no seu próprio domínio com literalmente um comando docker compose.

Por que Ter Seu Próprio Serviço de E-mail Temporário

Caixas de entrada descartáveis públicas são convenientes até você encontrar limitações. Primeiro, serviços de terceiros podem ver os e-mails recebidos com todos os links de confirmação e tokens. Segundo, muitos sites bloqueiam endereços de domínios conhecidos de e-mail temporário.

Uma instância pessoal resolve ambos os problemas:

• Você usa qualquer domínio pessoal que não esteja listado em nenhum banco de dados de spam.
• Todas as mensagens recebidas permanecem sob o seu controle.
• Sem captchas, banners de anúncios ou rastreadores de terceiros.
• Os e-mails são automaticamente excluídos após 48 horas, então o banco de dados não cresce.

Como a Arquitetura Funciona

Por baixo dos panos, o projeto usa uma stack moderna: backend em PHP (baseado nas tags do repositório, é Symfony) roda via FrankenPHP, usa SQLite como banco de dados, e o frontend é construído com React.

O detalhe mais interessante aqui é como o autor resolveu o problema de receber e-mails entrants. Configurar um servidor SMTP completo como o Postfix e configurar registros MX se torna um pesadelo para muitas pessoas. O TempFastMail usa Cloudflare Email Routing e um Cloudflare Worker gratuito. Um e-mail chega no domínio, o Cloudflare intercepta e chama a API HTTP da sua instância. Simples, confiável, e não requer abrir a porta 25 no servidor.

Início Rápido

Para começar, você precisa de um servidor com Docker instalado e um domínio delegado para o Cloudflare.

Crie o arquivo docker-compose.yml:

services:
  tempfastmail:
    container_name: tempfastmail
    image: kasteckis/tempfastmail:latest
    environment:
      CREATE_RECEIVED_EMAIL_API_AUTHORIZATION_KEY: your-secret-api-token
      DEFAULT_URI: https://yourdomain.com
    ports:
      - "80:80"
    volumes:
      - ./sqlite:/app/sqlite

Depois disso, você só precisa configurar o worker gratuito no dashboard do Cloudflare seguindo as instruções do repositório e vinculá-lo ao seu container via um token de autenticação. Uma vez rodando, a interface web é acessível no navegador. Você pode gerenciar e-mails e limpar manualmente o banco de dados através do painel admin usando o login padrão [email protected].

Pontos a Considerar

O README no repositório ainda é breve, e o projeto não tem muitas estrelas, então pequenas imperfeições são possíveis. Como o SQLite é usado como armazenamento, o serviço é claramente projetado para uso pessoal ou uma pequena equipe de testadores, não para milhares de usuários simultâneos.

Para tarefas locais de QA, automação de testes e proteção contra spam pessoal, é uma ótima descoberta que te poupa de lidar com servidores de e-mail complexos.