Ob Express, NestJS, Next.js-API-Routen oder ein einfaches Skript: Die meisten Node.js-Apps versenden E-Mails über Nodemailer. In der Entwicklung sollen diese E-Mails abgefangen und nicht zugestellt werden. Mailbox betreibt einen lokalen SMTP-Server auf Ihrem Mac: Richten Sie Nodemailer darauf aus, und jede Nachricht erscheint sofort — gerendert, mit Headern und Anhängen.
1. Server in Mailbox starten
Öffnen Sie Mailbox. Beim ersten Start legt Mailbox einen Server auf Port 2525 an — stellen Sie sicher, dass er gestartet ist. Wenn Sie stattdessen einen weiteren Server hinzufügen, wählt Mailbox dafür einen freien Port; verwenden Sie dann diesen Port in den folgenden Schritten.
2. Transport erstellen
import nodemailer from "nodemailer";
export const transporter = nodemailer.createTransport({
host: "127.0.0.1",
port: 2525,
secure: false,
});
secure: false bedeutet unverschlüsseltes SMTP — genau das, was Mailbox spricht. Nodemailer wechselt nur dann zu TLS, wenn der Server es anbietet, daher sind keine weiteren Optionen nötig. Lassen Sie das auth-Objekt weg — Mailbox verwendet keine SMTP-Authentifizierung. Die Beispiele nutzen 127.0.0.1, weil Mailbox auf IPv4 lauscht.
Ein gängiges Muster ist, diese Werte aus der Umgebung zu lesen, damit die Produktion ihren echten Anbieter behält:
const transporter = nodemailer.createTransport({
host: process.env.SMTP_HOST ?? "127.0.0.1",
port: Number(process.env.SMTP_PORT ?? 2525),
secure: false,
});
3. Test-E-Mail senden
Speichern Sie Folgendes als send-test.mjs und führen Sie node send-test.mjs aus:
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);
Die E-Mail erscheint sofort in Mailbox.
Sie nutzen die SDKs von SendGrid, Postmark oder Resend?
Wenn Ihre App statt SMTP eine E-Mail-API anspricht, kann Mailbox Pro auch diese ersetzen: Es stellt lokale Endpunkte bereit, die dieselben Anfragen akzeptieren wie SendGrid, Postmark, Resend, Mailgun, Brevo und Mailtrap, sodass Sie nur die Basis-URL ändern. Details finden Sie im API-Abschnitt.
Node in Docker betreiben
In einem Container ist 127.0.0.1 der Container selbst. Verwenden Sie stattdessen host.docker.internal als Host.
Falls der Container weiterhin keine Verbindung herstellen kann, aktivieren Sie in Mailbox Netzwerkzugriff erlauben (Einstellungen → Allgemein) und starten Sie den Server neu, damit er auch Verbindungen von außerhalb des Loopback-Interfaces annimmt.
Fehlerbehebung
ECONNREFUSED 127.0.0.1:2525— der Mailbox-Server läuft nicht, oder der Port stimmt nicht überein.- TLS- oder Zertifikatsfehler — stellen Sie sicher, dass
secureauffalsesteht und keinerequireTLS-Option gesetzt ist.
Als Nächstes prüfen
Mit der HTML-Kompatibilitätsprüfung von Mailbox sehen Sie, welches CSS in Ihren Templates E-Mail-Clients wie Outlook nicht unterstützen, und mit der Mobilvorschau prüfen Sie responsive Layouts. Sie testen mehrere Dienste? Mit Mailbox Pro geben Sie jedem seinen eigenen Server und Port.