¿Cómo se conecta mi aplicación a Mailpit?

Configure el host SMTP de su aplicación en 127.0.0.1 y el puerto en 1025. Si su aplicación se ejecuta en el mismo VPS que Mailpit, alcanza el servidor a través de la interfaz loopback. No se requiere ningún usuario, contraseña ni TLS de forma predeterminada.

¿Por qué sustituir MailHog por Mailpit?

MailHog ya no recibe mantenimiento desde 2020 y arrastra una vulnerabilidad XSS almacenada sin corregir (Exploit-DB 50971). Mailpit es su sucesor activo, instalado de forma predeterminada en Laravel Sail y DDEV, y añade búsqueda de texto completo, puntuación antispam, comprobaciones de compatibilidad HTML y una API REST para la CI.

¿Cuántos mensajes conserva Mailpit?

De forma predeterminada, hasta 500 mensajes. Los más antiguos se eliminan automáticamente cuando se alcanza el límite. Ajústelo con la variable de entorno MP_MAX_MESSAGES.

¿Se puede usar Mailpit como relé SMTP en producción?

No. Mailpit es una herramienta de desarrollo que descarta deliberadamente todos los correos. Para el correo transaccional en producción, utilice un relé como Postfix, Brevo o Amazon SES. Mailpit está reservado a los entornos de desarrollo y de staging.

Poner en marcha rápidamente un proyecto de software.

Mailpit

Capture y previsualice los correos que envía su aplicación sin entregarlos. Sustituya MailHog — código abierto, un solo contenedor Docker.

50 MB mínimo RAM 1 vCPU Disponible

Mailpit es un servidor SMTP de pruebas para desarrolladores que intercepta cada correo que envía su aplicación y lo muestra en una interfaz web cuidada en lugar de entregarlo. Sustituye a MailHog (abandonado, con una vulnerabilidad XSS sin corregir desde 2020) con búsqueda de texto completo, compatibilidad con TLS, puntuación antispam, comprobaciones de compatibilidad HTML y vista previa móvil, todo ello en un binario Go de menos de 50 MB de RAM. Despliéguelo en el mismo VPS que su aplicación web, apunte su configuración SMTP a localhost:1025 y cada correo aterrizará en tiempo real en la bandeja de entrada de Mailpit.

Funcionalidades clave

Servidor SMTP en el puerto 1025 — configure su aplicación para enviar a localhost:1025, no se entrega ningún correo real.

Interfaz web en el puerto 8025 con búsqueda de texto completo en el asunto, el remitente, el destinatario y el cuerpo del mensaje.

API REST para los pipelines de CI — verifique el contenido de los correos, el número de archivos adjuntos y los destinatarios en sus pruebas automatizadas.

Puntuación antispam con las reglas de SpamAssassin — detecte los problemas de entregabilidad antes de que lleguen a producción.

Comprobación de compatibilidad HTML — identifique las propiedades CSS no compatibles con los principales clientes de correo.

Vista previa móvil y vista del código fuente sin procesar para las partes HTML y de texto plano.

Interfaz POP3 para recuperar los correos capturados con cualquier cliente de correo.

Un único binario Go, menos de 50 MB de RAM y base de datos SQLite en un volumen persistente.

¿Cuándo usar esta solución?

1

Probar el envío de correos durante el desarrollo

Ejecute su aplicación web y Mailpit en el mismo VPS. Configure su SMTP con el host localhost y el puerto 1025. Cada correo de restablecimiento de contraseña, notificación o factura aparece al instante en la bandeja de entrada de Mailpit — sin riesgo de enviarlo a usuarios reales.

2

Verificar los correos en los pipelines de CI

Consulte la API REST desde su suite de pruebas para comprobar que se envió el correo correcto, que el asunto coincide, que los archivos adjuntos están presentes y que el destinatario correcto recibió el mensaje — sin ningún relé SMTP real.

3

Detectar los problemas de entregabilidad antes de producción

Utilice el informe de puntuación antispam y de compatibilidad HTML para detectar cabeceras ausentes, HTML roto y propiedades CSS que Gmail u Outlook eliminarán — antes de que un correo llegue a una sola bandeja de entrada real.

Desplegar Mailpit en su VPS

Guía optimizada para los VPS Cloud ServOrbit.

01

Desplegar Mailpit desde el marketplace

Abra su panel de control ServOrbit, vaya a Marketplace → Desarrollo → Mailpit y haga clic en Desplegar. Docker descarga la imagen axllent/mailpit e inicia el servidor. La interfaz web está lista en menos de 10 segundos.

02

Configurar el SMTP de su aplicación

En las variables de entorno o en el archivo de configuración de su aplicación, defina el host SMTP en 127.0.0.1 y el puerto en 1025. No se requiere autenticación ni TLS. Si su aplicación se ejecuta en el mismo VPS, cada correo enviado será interceptado por Mailpit.

03

Abrir la interfaz web de Mailpit

Mailpit no tiene ninguna dirección pública: su interfaz no impone autenticación alguna y entrega TODOS los mensajes que envían sus aplicaciones. El acceso se realiza mediante un túnel SSH — ssh -L 8025:127.0.0.1:8025 root@<ip-de-su-vps> y luego http://localhost:8025; 8025 es el puerto del catálogo, utilice el que aparece en la ficha de su aplicación en el área de cliente. Verá la lista de los correos interceptados: haga clic en cualquier mensaje para inspeccionar su representación HTML, su versión en texto plano, su código fuente sin procesar, sus cabeceras y su puntuación antispam.

04

Conectarse por primera vez

Mailpit no impone ninguna autenticación de forma predeterminada: la interfaz se abre directamente después del despliegue. Por eso la receta del catálogo no le asocia ningún dominio — una bandeja de entrada pública entregaría a quien la encuentre los enlaces de restablecimiento de contraseña y los tokens que envían sus aplicaciones. Si desea publicarla, establezca antes una autenticación con MP_UI_AUTH_FILE: la receta podrá entonces volver a publicarse con dominio.

05

Usar la API REST en sus pruebas

Llame a GET /api/v1/messages para listar los correos interceptados. Filtre por destinatario, asunto o fecha. Verifique el contenido exacto que envió su aplicación — sin mock, sin stub: el correo real a través del SMTP real.

06

Revisar el informe de compatibilidad HTML

Abra cualquier correo HTML y haga clic en la pestaña Compatibilidad. Mailpit resalta las propiedades CSS no compatibles o parcialmente compatibles con Gmail, Outlook, Apple Mail y otros clientes principales, para que pueda corregirlas antes de la puesta en producción.

Preguntas frecuentes

No. Mailpit es un servidor trampa: acepta todas las conexiones SMTP en el puerto 1025 y almacena cada mensaje en su base de datos SQLite local sin reenviarlo a ninguna parte. Ningún correo llega a una bandeja de entrada real.

Integrar el botón de despliegue

¿Mantiene un proyecto que utiliza Mailpit? Este botón permite a sus lectores desplegarlo en un VPS con un clic, sin leer documentación de Docker.

Markdown

[![Deploy Mailpit on ServOrbit](https://servorbit.com/brand/deploy/button.svg)](https://servorbit.com/vps-cloud?template=mailpit&utm_source=deploy-badge&utm_medium=referral&utm_campaign=mailpit)

HTML

<a href="https://servorbit.com/vps-cloud?template=mailpit&utm_source=deploy-badge&utm_medium=referral&utm_campaign=mailpit"><img src="https://servorbit.com/brand/deploy/button.svg" alt="Deploy Mailpit on ServOrbit" height="40"></a>

El botón lleva al pedido de un VPS con la plantilla preseleccionada. La imagen se sirve desde servorbit.com: no tiene que alojar nada por su parte.