العودة إلى البريد
إرسال عبر الرمز
أرسل بريدًا من تطبيقك باستخدام أي مكتبة SMTP. نعرض تدفق Node.js/nodemailer لأنه الأكثر شيوعًا - حيث تستخدم كل لغة أخرى نفس الحقول بالضبط.
قم بتثبيت Nodemailer
terminal
npm install nodemailer
# or
pnpm add nodemailer
# or
bun add nodemailerالحد الأدنى من الناقل
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
},
});لماذا المنفذ 587 + STARTTLS بدلاً من 465 + Secure: صحيح؟ كلاهما يعمل. 587/STARTTLS هو معيار التقديم الحديث وهو ما يختاره معظم العملاء. 465 (TLS الضمني) مدعوم أيضًا - تم ضبطه
port: 465, secure: true وإزالة requireTLS.أرسل رسالة
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>",
});تحقق من الاتصال أولاً
عند التمهيد، قم باختبار اتصال الخادم حتى يفشل التكوين المعطل بسرعة بدلاً من انتظار انتهاء مهلة إرسال البريد الأول:
boot.ts
await transporter.verify();
console.log("SMTP ready");من اللغات الأخرى
الشكل متطابق عبر المكتبات - المضيف والمنفذ ووضع TLS واسم المستخدم وكلمة المرور.
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"),
)قائمة مرجعية الإنتاج
- 1لا تلتزم أبدًا بكلمة المرور. استخدم متغيرات البيئة تم تحميلها في وقت التشغيل (Vercel/Railway/Fly الكل يفعل هذا؛ استخدم محليًا
.env.local). - 2احتفظ بواحدة الناقل مثال طوال عمر العملية - يؤدي فتح مصافحة TCP+TLS جديدة لكل بريد إلكتروني إلى قتل الإنتاجية.
- 3تعيين من عنوان لصندوق بريد موجود على هذا الخادم. تم رفض العناوين الخارجية من خلال سياسة SPF + DMARC الخاصة بك.
- 4بالنسبة لحجم المعاملات، قم بتشغيل التحقق () عند التمهيد وأضف عمليات إعادة المحاولة sendMail; تعد نبضات الشبكة العابرة أمرًا طبيعيًا.
- 5تحقق من علامة التبويب "الحالة" في مشرف OpenShip إذا توقف البريد عن الإرسال - حيث توجد قائمة انتظار البريد الصادر هناك.