Retour au courrier
Envoyer par code
Envoyez du courrier depuis votre application en utilisant n'importe quelle bibliothèque SMTP. Nous montrons le flux Node.js / nodemailer car c'est le plus courant : toutes les autres langues utilisent exactement les mêmes champs.
Installer Nodemailer
terminal
npm install nodemailer
# or
pnpm add nodemailer
# or
bun add nodemailerTransporteur minimal
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
},
});Pourquoi le port 587 + STARTTLS au lieu de 465 + sécurisé : vrai ? Les deux fonctionnent. 587/STARTTLS est la norme de soumission moderne et c'est ce que choisissent la plupart des clients. 465 (TLS implicite) est également pris en charge - définissez
port: 465, secure: true et supprimer requireTLS.Envoyer un message
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>",
});Vérifiez d'abord la connexion
Au démarrage, envoyez une requête ping au serveur pour qu'une configuration cassée échoue rapidement au lieu d'attendre l'expiration du premier sendMail :
boot.ts
await transporter.verify();
console.log("SMTP ready");D'autres langues
La forme est identique dans toutes les bibliothèques : hôte, port, mode TLS, nom d'utilisateur, mot de passe.
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"),
)Liste de contrôle de production
- 1Ne commettez jamais le mot de passe. Utiliser variables d'environnement chargé au moment de l'exécution (Vercel/Railway/Fly font tous cela ; utiliser localement
.env.local). - 2Gardez-en un seul transporteur par exemple pendant toute la durée de vie de votre processus - l'ouverture d'une nouvelle poignée de main TCP+TLS par e-mail tue le débit.
- 3Réglez le De adresse à une boîte aux lettres qui existe sur ce serveur. Les adresses d’origine étrangère sont rejetées par votre politique SPF + DMARC.
- 4Pour le volume transactionnel, exécutez vérifier() au démarrage et ajouter des tentatives envoyerMail; Les anomalies transitoires du réseau sont normales.
- 5Vérifiez l'onglet Santé dans votre administration OpenShip si le courrier cesse d'être envoyé : la file d'attente sortante se trouve là.