Prueba los emails de Node.js en local con Nodemailer

Apunta Nodemailer a un servidor SMTP local en tu Mac y captura cada email que envía tu app Node.js en desarrollo. Funciona con Express, NestJS, Next.js y más.

Ya uses Express, NestJS, rutas de API de Next.js o un simple script, la mayoría de las apps Node.js envían email a través de Nodemailer. En desarrollo quieres que esos emails se capturen, no que se entreguen. Mailbox ejecuta un servidor SMTP local en tu Mac: apunta Nodemailer hacia él y cada mensaje aparece al instante, renderizado, con cabeceras y adjuntos.

1. Inicia un servidor en Mailbox

Abre Mailbox. La primera vez que lo abres crea un servidor en el puerto 2525 — asegúrate de que esté iniciado. Si en su lugar añades otro servidor, Mailbox le asigna un puerto libre; usa ese puerto en los pasos siguientes.

2. Crea el transporte

import nodemailer from "nodemailer";

export const transporter = nodemailer.createTransport({
  host: "127.0.0.1",
  port: 2525,
  secure: false,
});

secure: false significa SMTP sin cifrar, que es lo que habla Mailbox. Nodemailer solo pasa a TLS cuando el servidor lo ofrece, así que no hacen falta opciones adicionales. Omite el objeto auth: Mailbox no usa autenticación SMTP. Los ejemplos usan 127.0.0.1 porque Mailbox escucha en IPv4.

Un patrón habitual es leer estos valores del entorno, para que producción siga usando su proveedor real:

const transporter = nodemailer.createTransport({
  host: process.env.SMTP_HOST ?? "127.0.0.1",
  port: Number(process.env.SMTP_PORT ?? 2525),
  secure: false,
});

3. Envía un email de prueba

Guarda esto como send-test.mjs y ejecuta node send-test.mjs:

import nodemailer from "nodemailer";

const transporter = nodemailer.createTransport({ host: "127.0.0.1", port: 2525, secure: false });

const info = await transporter.sendMail({
  from: '"My App" <app@example.com>',
  to: "test@example.com",
  subject: "Hello from Node.js",
  text: "It works!",
  html: "<h1>It works!</h1>",
});

console.log("Sent", info.messageId);

El email aparece en Mailbox al instante.

¿Usas los SDK de SendGrid, Postmark o Resend?

Si tu app habla con una API de email en lugar de SMTP, Mailbox Pro también puede sustituirla: expone endpoints locales que aceptan las mismas solicitudes que SendGrid, Postmark, Resend, Mailgun, Brevo y Mailtrap, así que solo cambias la URL base. Consulta la sección de la API para más detalles.

Ejecutar Node en Docker

Dentro de un contenedor, 127.0.0.1 es el propio contenedor. Usa host.docker.internal como host en su lugar.

Si el contenedor sigue sin poder conectarse, activa Permitir acceso a la red en Mailbox (Configuración → General) y reinicia el servidor para que acepte conexiones desde fuera de la interfaz de loopback.

Solución de problemas

  • ECONNREFUSED 127.0.0.1:2525 — el servidor de Mailbox no está en ejecución o el puerto no coincide.
  • Errores de TLS o de certificado — asegúrate de que secure sea false y de que no haya ninguna opción requireTLS configurada.

Qué revisar a continuación

Usa la verificación de compatibilidad HTML de Mailbox para ver qué CSS de tus plantillas no admiten clientes de correo como Outlook, y la vista previa móvil para revisar los diseños responsive. ¿Pruebas varios servicios? Con Mailbox Pro, dale a cada uno su propio servidor y puerto.

Más guías