Que vous utilisiez Express, NestJS, les routes API de Next.js ou un simple script, la plupart des apps Node.js envoient leurs emails via Nodemailer. En développement, vous voulez que ces emails soient interceptés, pas livrés. Mailbox fait tourner un serveur SMTP local sur votre Mac : pointez Nodemailer vers lui, et chaque message apparaît instantanément, avec son rendu, ses en-têtes et ses pièces jointes.
1. Démarrez un serveur dans Mailbox
Ouvrez Mailbox. Au premier lancement, l’app crée un serveur sur le port 2525 — vérifiez qu’il est bien démarré. Si vous préférez ajouter un autre serveur, Mailbox lui attribue un port libre ; utilisez alors ce port dans les étapes suivantes.
2. Créez le transport
import nodemailer from "nodemailer";
export const transporter = nodemailer.createTransport({
host: "127.0.0.1",
port: 2525,
secure: false,
});
secure: false correspond à du SMTP simple, c’est-à-dire ce que parle Mailbox. Nodemailer ne passe en TLS que si le serveur le propose : aucune option supplémentaire n’est donc nécessaire. Omettez l’objet auth — Mailbox n’utilise pas d’authentification SMTP. Les exemples utilisent 127.0.0.1 car Mailbox écoute en IPv4.
Une pratique courante consiste à lire ces valeurs depuis l’environnement, pour que la production conserve son vrai fournisseur :
const transporter = nodemailer.createTransport({
host: process.env.SMTP_HOST ?? "127.0.0.1",
port: Number(process.env.SMTP_PORT ?? 2525),
secure: false,
});
3. Envoyez un email de test
Enregistrez ceci sous send-test.mjs et lancez 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);
L’email apparaît aussitôt dans Mailbox.
Vous utilisez les SDK de SendGrid, Postmark ou Resend ?
Si votre app communique avec une API d’emails plutôt qu’en SMTP, Mailbox Pro peut aussi prendre sa place : il expose des endpoints locaux qui acceptent les mêmes requêtes que SendGrid, Postmark, Resend, Mailgun, Brevo et Mailtrap, si bien que vous ne changez que l’URL de base. Consultez la section API pour plus de détails.
Exécuter Node dans Docker
Dans un conteneur, 127.0.0.1 désigne le conteneur lui-même. Utilisez plutôt host.docker.internal comme hôte.
Si le conteneur ne parvient toujours pas à se connecter, activez Autoriser l’accès réseau dans Mailbox (Réglages → Général) et redémarrez le serveur : il acceptera alors les connexions venant de l’extérieur de l’interface loopback.
Dépannage
ECONNREFUSED 127.0.0.1:2525— le serveur Mailbox n’est pas démarré, ou le port ne correspond pas.- Erreurs TLS ou de certificat — vérifiez que
securevautfalseet qu’aucune optionrequireTLSn’est définie.
Que vérifier ensuite
Utilisez la vérification de compatibilité HTML de Mailbox pour voir quel CSS de vos templates n’est pas pris en charge par des clients de messagerie comme Outlook, et l’aperçu mobile pour contrôler vos mises en page responsive. Vous testez plusieurs services ? Avec Mailbox Pro, attribuez à chacun son propre serveur et son propre port.