Zurück zu Mail

Per Code senden

Senden Sie E-Mails aus Ihrer Anwendung über eine beliebige SMTP-Bibliothek. Wir zeigen den Ablauf Node.js / nodemailer, da er am gebräuchlichsten ist – jede andere Sprache verwendet genau dieselben Felder.

Nodemailer installieren

terminal
npm install nodemailer
# or
pnpm add nodemailer
# or
bun add nodemailer

Minimaler Transporter

mailer.ts
import nodemailer from "nodemailer";

export const transporter = nodemailer.createTransport({
  host: process.env.SMTP_HOST!,        // smtp host from the right rail
  port: Number(process.env.SMTP_PORT), // 587
  secure: false,                       // STARTTLS upgrades after connect
  requireTLS: true,                    // refuse if TLS upgrade is unavailable
  auth: {
    user: process.env.SMTP_USER!,      // your full email address
    pass: process.env.SMTP_PASS!,      // postmaster password - keep in .env
  },
});
Warum Port 587 + STARTTLS statt 465 + secure: true? Beide funktionieren. 587/STARTTLS ist der moderne Einreichungsstandard und wird von den meisten Kunden gewählt. 465 (implizites TLS) wird ebenfalls unterstützt – eingestellt port: 465, secure: true und entfernen requireTLS.

Senden Sie eine Nachricht

send.ts
import { transporter } from "./mailer";

await transporter.sendMail({
  from: '"Your App" <[email protected]>',
  to: "[email protected]",
  subject: "Hello from your self-hosted mail server",
  text: "Plain-text body.",
  html: "<p>HTML body too - clients pick whichever they prefer.</p>",
});

Überprüfen Sie zunächst die Verbindung

Pingen Sie beim Booten den Server an, damit eine defekte Konfiguration schnell fehlschlägt, anstatt auf die Zeitüberschreitung der ersten sendMail zu warten:

boot.ts
await transporter.verify();
console.log("SMTP ready");

Aus anderen Sprachen

Die Form ist in allen Bibliotheken identisch – Host, Port, TLS-Modus, Benutzername, Passwort.

python · smtplib
import smtplib
from email.message import EmailMessage

msg = EmailMessage()
msg["From"] = "[email protected]"
msg["To"] = "[email protected]"
msg["Subject"] = "Hello"
msg.set_content("Plain text body")

with smtplib.SMTP("smtp.yourdomain.com", 587) as s:
    s.starttls()
    s.login("[email protected]", "PASSWORD")
    s.send_message(msg)
go · net/smtp
auth := smtp.PlainAuth("",
  "[email protected]",
  "PASSWORD",
  "smtp.yourdomain.com",
)
err := smtp.SendMail(
  "smtp.yourdomain.com:587",
  auth,
  "[email protected]",
  []string{"[email protected]"},
  []byte("Subject: Hello\r\n\r\nbody"),
)

Checkliste für die Produktion

  1. 1
    Geben Sie niemals das Passwort fest. Benutzen Umgebungsvariablen zur Laufzeit geladen (Vercel/Railway/Fly alle tun dies; lokal verwenden .env.local).
  2. 2
    Behalten Sie eine Single Transporter Beispiel für die Lebensdauer Ihres Prozesses – das Öffnen eines neuen TCP+TLS-Handshakes per E-Mail führt zu Durchsatzverlusten.
  3. 3
    Stellen Sie die ein Von Adresse an ein Postfach, das auf diesem Server vorhanden ist. Ausländische Absenderadressen werden von Ihrer SPF + DMARC-Richtlinie abgelehnt.
  4. 4
    Führen Sie Folgendes aus, um das Transaktionsvolumen zu ermitteln: überprüfen() beim Booten und fügen Sie Wiederholungsversuche hinzu sendMail; Vorübergehende Netzwerkfehler sind normal.
  5. 5
    Überprüfen Sie die Registerkarte „Zustand“ in Ihrem OpenShip-Administrator, wenn der E-Mail-Versand stoppt – die Ausgangswarteschlange befindet sich dort.