Guia de Configuração do Serviço Mailpit no ServBay

O ServBay integra o pacote de software Mailpit, fornecendo um servidor de e-mail local conveniente, projetado especialmente para desenvolvedores testarem e depurarem o envio de e-mails em suas aplicações. Este artigo explicará em detalhes como instalar, ativar e configurar o Mailpit no ServBay, incluindo as quatro principais abas de configuração: Common, SMTP, POP3 e Relay.

Visão Geral do Mailpit

O Mailpit é uma ferramenta open source que oferece um servidor SMTP/POP3 local fácil de usar e uma interface web intuitiva. Ele captura todos os e-mails enviados pela sua aplicação, permitindo que você verifique o conteúdo, os cabeçalhos e anexos dos e-mails em um local centralizado, sem enviar mensagens de teste para uma caixa de entrada real. Isso simplifica muito o processo de desenvolvimento e debugging, especialmente ao trabalhar com registro de usuários, redefinição de senha, notificações e outras funcionalidades que exigem envio de e-mails.

No ServBay, o Mailpit está integrado como um pacote essencial, que pode ser facilmente instalado e gerenciado. Além disso, o robusto sistema PKI do ServBay configura automaticamente SSL/TLS para você, garantindo um ambiente de testes seguro.

Instalando e Ativando o Mailpit no ServBay

Antes de usar o Mailpit como servidor de e-mail local, é preciso instalar e ativar o pacote Mailpit no ServBay.

1. Abra o aplicativo ServBay.
2. No menu de navegação à esquerda, selecione Pacotes.
3. Na lista de pacotes, localize a categoria Serviços Comuns.
4. Encontre o pacote Mailpit.
5. Se o Mailpit ainda não estiver instalado, clique no botão verde de instalação à direita para instalar.
6. Após a instalação, ative o pacote clicando no botão de alternância ao lado.

Graças ao poderoso sistema PKI do ServBay, os certificados SSL necessários serão gerados e configurados automaticamente para a interface web administrativa do Mailpit, assim como para os serviços SMTP e POP3. Isso significa que você pode ativar a criptografia STARTTLS ou SSL/TLS imediatamente, sem solicitar ou configurar certificados manualmente.

Interface Web de Gerenciamento de E-mails

O Mailpit vem com uma interface web poderosa para visualizar e gerenciar os e-mails capturados. O ServBay já faz toda a configuração automaticamente, e assim que o pacote Mailpit estiver ativado, você poderá acessar essa interface diretamente pelo navegador:

Endereço de acesso: https://mail.servbay.host

Por meio desta interface, é possível navegar facilmente na lista de e-mails recebidos, visualizar o conteúdo detalhado de cada mensagem (HTML, texto simples e código fonte), pesquisar e-mails, excluir mensagens, entre outras ações.

Configurando o Pacote Mailpit

O ServBay oferece uma interface gráfica para configurar todos os parâmetros do Mailpit. No menu de navegação à esquerda do ServBay, selecione Mail e clique em Mailpit Service Config para acessar as configurações. Você encontrará quatro principais abas de configuração: Common, SMTP, POP3 e Relay.

1. Aba Common

A aba Common permite ajustar as configurações e comportamentos gerais do Mailpit:

• Max Messages: Define o número máximo de e-mails que o servidor Mailpit pode armazenar. Quando esse limite é atingido, os e-mails mais antigos serão automaticamente removidos.
• Max Age: Define o tempo máximo de retenção dos e-mails (em dias). Após esse período, as mensagens serão excluídas automaticamente.
• SpamAssassin: Ativa ou desativa o filtro de spam SpamAssassin. Se ativado, o Mailpit marcará e-mails suspeitos como spam.
• Webhook URL: Configura uma URL de webook. Quando um novo e-mail chega ao Mailpit, será feito automaticamente um POST HTTP para essa URL, notificando sistemas ou serviços externos. Isto é útil para integrações de testes automatizados ou notificações.
• Webhook Limit: Define o limite máximo de e-mails enviados como notificação pelo webhook.

2. Aba SMTP

TIP

Graças ao sistema PKI avançado do ServBay, os certificados SSL já são gerados e configurados por padrão. Você pode ativar as conexões seguras STARTTLS ou SSL/TLS sem necessidade de solicitar ou configurar certificados manualmente.

A aba SMTP permite configurar as principais opções do servidor SMTP do Mailpit. Sua aplicação se conectará a este servidor SMTP para enviar e-mails de teste:

• SMTP Port: Define a porta que o servidor SMTP do Mailpit escuta. Sua aplicação deve enviar os e-mails para 127.0.0.1 ou localhost nesta porta. O padrão é 1025.
• STARTTLS: Ativa ou desativa criptografia STARTTLS, permitindo a atualização para uma comunicação criptografada após a conexão.
• SSL/TLS: Ativa ou desativa criptografia SSL/TLS, estabelecendo a conexão já de forma criptografada.
• Username: Define o nome de usuário do SMTP (opcional). Caso ativo, sua aplicação deve fornecer este usuário para autenticação ao enviar e-mails.
• Password: Define a senha do SMTP (opcional), utilizada junto ao Username para autenticação.
• Max Recipients: Define o número máximo de destinatários permitidos por e-mail, evitando que uma mesma mensagem seja enviada para muitos destinatários.
• Allowed Recipients: Lista de e-mails ou domínios permitidos para receber as mensagens (opcional). Se deixado em branco, o Mailpit aceitará e-mails para qualquer endereço. Se preenchido, apenas destinatários listados ou desses domínios serão aceitos.

3. Aba POP3

TIP

Com o sistema PKI robusto do ServBay, os certificados SSL necessários já estão prontos e configurados. Você pode ativar conexões SSL/TLS para o POP3 sem configurações adicionais de certificado.

A aba POP3 permite configurar as opções do servidor POP3 do Mailpit. Se precisar testar o recebimento de e-mails, configure seu cliente para se conectar a este servidor:

• Enable POP3 Server: Ativa ou desativa a função de servidor POP3 no Mailpit.
• POP3 Server Port: Define a porta de escuta do servidor POP3. O padrão é 1110.
• Username: Define o usuário do POP3 (opcional). Se configurado, o cliente precisará informar este usuário para autenticação.
• Password: Define a senha do POP3 (opcional), usada junto ao Username para autenticação.
• SSL/TLS: Ativa ou desativa a criptografia SSL/TLS para as conexões POP3.

4. Aba Relay

A aba Relay é utilizada para configurar o encaminhamento de e-mails capturados para um servidor SMTP externo real, como um servidor de envio de produção:

• Enable SMTP Relay: Ativa ou desativa a função de relay SMTP.
• Host: Endereço do servidor SMTP externo para onde os e-mails serão encaminhados (por exemplo: smtp.gmail.com, smtp.sendgrid.net).
• Port: Porta do servidor SMTP externo. O padrão é 25 (SMTP), 465 (SMTPS) ou 587 (Submission).
• STARTTLS: Ativa ou desativa a criptografia STARTTLS para o relay.
• Allow Insecure: Permite conexões com servidores SMTP de relay que utilizam certificados inseguros (não recomendado para ambientes de produção).
• Auth: Método de autenticação com o servidor de relay. As opções mais comuns são Login (usuário e senha), Plain (similar ao Login) e CRAM-MD5 (autenticação por desafio/resposta).
• Username: Usuário para autenticar no servidor SMTP de relay.
• Password: Senha para autenticação no servidor de relay.
• Return Path: Endereço de retorno (Return-Path) para e-mails encaminhados.
• Allowed Recipients: Lista (opcional) de destinatários ou domínios que podem ser encaminhados.
• Blocked Recipients: Lista (opcional) de destinatários ou domínios bloqueados para o relay.
• Relay All: Se ativado, o Mailpit tentará encaminhar todos os e-mails capturados (respeitando Allowed/Blocked Recipients).
• Relay Matching: Se ativado, o Mailpit apenas encaminhará e-mails que coincidam com as regras de Allowed ou Blocked Recipients.

Salvando as Configurações

Após realizar qualquer alteração nas configurações do Mailpit, certifique-se de clicar no botão Salvar na parte inferior da interface para garantir que as alterações sejam aplicadas.

Se desejar restaurar as configurações padrões do Mailpit, clique no botão Resetar.

Perguntas Frequentes (FAQ)

• P: Por que os e-mails enviados pela minha aplicação não aparecem no Mailpit?
  • R: Verifique as configurações de envio de e-mail da sua aplicação (geralmente host e porta SMTP), garantindo que elas apontem para o endereço do Mailpit em execução no ServBay (127.0.0.1 ou localhost) e a porta SMTP configurada (por padrão, 1025). Também confira se o pacote Mailpit está ativado e em funcionamento no ServBay, o que pode ser visualizado na lista de pacotes.
• P: Preciso configurar certificados SSL para o Mailpit?
  • R: Não. O sistema PKI do ServBay gera e configura automaticamente os certificados necessários para a interface web e para os serviços SMTP e POP3 (STARTTLS/SSL/TLS). Basta ativar a opção de criptografia nas respectivas abas de configuração.
• P: Qual o usuário e senha padrão da interface web do Mailpit?
  • R: Por padrão, ao acessar https://mail.servbay.host, a interface web do Mailpit não exige usuário ou senha. Os serviços SMTP e POP3 também não exigem autenticação por padrão. Se desejar exigir autenticação para SMTP ou POP3, configure Username e Password nas abas correspondentes.

Resumo

Com o Mailpit integrado ao ServBay, você monta facilmente um ambiente de testes de e-mail local. Configurando as opções de SMTP, POP3 e Relay, e com a interface web intuitiva, o gerenciamento e verificação das funcionalidades de e-mail em seu desenvolvimento torna-se muito mais eficiente e prático.

Lembre-se: após modificar as configurações, pode ser necessário reiniciar o pacote Mailpit para que as alterações entrem em vigor. Você pode fazer isso pelo painel de gerenciamento de pacotes do ServBay, clicando em reiniciar ao lado do Mailpit.