Instale o Mailpit no CasaOS com a imagem Docker oficial axllent/mailpit, a porta 8025 para a caixa de entrada Web e a porta 1025 para SMTP. Persista /data apenas se quiser que as mensagens e as definições sobrevivam à recriação do contentor.
O antigo tutorial do BigBearCasaOS continua a ser útil como exemplo de instalação com um clique, mas a documentação atual do Mailpit disponibiliza agora a imagem Docker exata, a opção de base de dados persistente, as opções de autenticação e as definições de TLS/retransmissão. Estas devem servir de base ao guia de 2026.
Para Que Serve o Mailpit
O Mailpit é um servidor SMTP local para testes destinado a programadores. As aplicações enviam mensagens de teste para o Mailpit em vez de as enviarem para um fornecedor de correio real, e pode inspecionar as mensagens através de um navegador.
Não é uma caixa de correio de produção normal nem um servidor de correio exposto à Internet.
Utilize a Imagem Docker Oficial
O atual guia Docker do Mailpit documenta:
axllent/mailpitMapeamento de Portas no CasaOS
- 8025/TCP: interface Web do Mailpit
- 1025/TCP: recetor SMTP
Se outro serviço já utilizar uma destas portas do anfitrião, altere a porta do lado do anfitrião, mantendo inalterada a porta do lado do contentor.
Definições Básicas de uma Aplicação Personalizada no CasaOS
image: axllent/mailpit
restart: unless-stopped
ports:
- "8025:8025"
- "1025:1025"Depois do arranque, abra http://CASAOS-IP:8025.
Aponte a Sua Aplicação para o Mailpit
Para outro contentor na mesma rede Docker, utilize o nome do serviço/contentor do Mailpit e a porta 1025. Para uma aplicação na LAN, utilize o IP do anfitrião CasaOS e a porta SMTP do anfitrião publicada.
Persista as Mensagens Apenas se Precisar
A documentação atual do Mailpit permite utilizar uma base de dados SQLite em /data através de:
MP_DATABASE=/data/mailpit.dbMapeie uma pasta AppData do CasaOS para /data se quiser que o histórico de mensagens sobreviva à substituição do contentor.
Mantenha o Mailpit Privado
Uma caixa de entrada de testes pode conter ligações de reposição de palavras-passe, notificações de API e dados de aplicações. Não exponha diretamente a interface Web nem o recetor SMTP sem autenticação à Internet.
O atual guia de configuração do Mailpit documenta a autenticação HTTP, SMTP e POP3, além das opções de TLS.
Quando Não Precisa de Publicar a Porta 1025
Se apenas os contentores na mesma rede Compose enviarem correio para o Mailpit, pode omitir a publicação da porta do anfitrião para SMTP e mantê-la interna ao Docker.
O guia de redes Docker explica o mesmo modelo de isolamento.
Teste o Percurso SMTP Antes de o Ligar à Sua Aplicação
Depois de o Mailpit arrancar, confirme que a interface Web abre e envie uma mensagem de teste a partir de um cliente SMTP simples ou da sua aplicação. Se a mensagem aparecer instantaneamente na caixa de entrada do Mailpit, tanto o percurso de rede como o recetor SMTP estão a funcionar.
Se a aplicação indicar que a ligação foi recusada, confirme que está a utilizar o nome do anfitrião correto no seu próprio contexto de rede. Um contentor deve normalmente utilizar o nome do serviço Mailpit; um portátil na LAN deve utilizar o IP do anfitrião CasaOS.
Utilize a Autenticação Apenas Quando o Seu Teste o Exigir
O Mailpit pode aceitar SMTP sem autenticação para um desenvolvimento local simples, mas as opções de configuração atuais também suportam autenticação SMTP e autenticação da interface. Ative-as quando vários utilizadores partilharem o laboratório ou quando o serviço estiver acessível para além de uma única rede Docker de confiança.
Mantenha o Correio de Teste Separado do Correio de Produção
O Mailpit foi concebido para capturar mensagens, evitando que cheguem acidentalmente a utilizadores reais. Aponte explicitamente as aplicações de desenvolvimento e de preparação para o Mailpit e mantenha as credenciais SMTP de produção numa configuração separada. Isto impede que uma mensagem de teste de reposição de palavra-passe ou uma inundação de notificações chegue aos clientes.
Defina um Limite de Mensagens para Laboratórios de Longa Duração
O Mailpit pode conservar milhares de mensagens. Num ambiente de CI ou laboratório doméstico em execução contínua, defina um limite máximo sensato e persista apenas aquilo de que realmente precisa. Caso contrário, uma pequena ferramenta de testes pode lentamente transformar-se noutra base de dados que terá de manter.
Perguntas Frequentes
Quais são as portas predefinidas do Mailpit?
8025 para a interface Web e 1025 para SMTP.
O Mailpit envia correio eletrónico real?
A sua principal função é capturar localmente correio de teste. Pode ser configurado para encaminhamento/retransmissão, mas essa é uma configuração explícita separada.
Preciso de uma base de dados?
Não para testes temporários. Utilize a opção de base de dados SQLite se quiser um histórico de mensagens persistente.
Devo expor o Mailpit publicamente?
Não. Mantenha-o numa rede de confiança ou proteja-o com autenticação e TLS.
