Настройка отправки email через SMTP-сервер
SMTP — базовый транспортный протокол для email. Используется, когда нет желания платить за ESP или когда приложение работает внутри корпоративной инфраструктуры с собственным почтовым сервером (Postfix, Exim, Microsoft Exchange).
Отправка через Nodemailer
npm install nodemailer
npm install -D @types/nodemailer
import nodemailer from 'nodemailer';
const transporter = nodemailer.createTransport({
host: process.env.SMTP_HOST, // smtp.gmail.com, smtp.yandex.ru, etc.
port: Number(process.env.SMTP_PORT ?? 465),
secure: true, // true для 465, false для 587
auth: {
user: process.env.SMTP_USER,
pass: process.env.SMTP_PASS,
},
// Для корпоративных SMTP с self-signed сертификатами
tls: {
rejectUnauthorized: process.env.NODE_ENV === 'production',
},
});
// Проверка соединения при старте сервера
await transporter.verify();
console.log('SMTP ready');
Отправка письма
async function sendEmail(params: {
to: string | string[];
subject: string;
html: string;
text?: string;
attachments?: nodemailer.Attachment[];
}) {
const info = await transporter.sendMail({
from: `"Acme Support" <[email protected]>`,
to: params.to,
subject: params.subject,
html: params.html,
text: params.text,
attachments: params.attachments,
headers: {
'X-Mailer': 'Acme App v2',
},
});
return info.messageId;
}
// Пример с PDF-вложением
await sendEmail({
to: '[email protected]',
subject: 'Ваш инвойс #INV-2026-042',
html: invoiceHtml,
attachments: [
{
filename: 'invoice-2026-042.pdf',
content: pdfBuffer,
contentType: 'application/pdf',
},
],
});
Пул соединений для высокой нагрузки
При большом количестве писем создаём pool вместо одного транспорта:
const poolTransporter = nodemailer.createTransport({
pool: true,
maxConnections: 5, // параллельных соединений
maxMessages: 100, // писем на соединение до переподключения
host: process.env.SMTP_HOST,
port: 465,
secure: true,
auth: { user: process.env.SMTP_USER, pass: process.env.SMTP_PASS },
});
Популярные SMTP-провайдеры
| Провайдер | SMTP host | Port | Лимит |
|---|---|---|---|
| Gmail | smtp.gmail.com | 465/587 | 500/день |
| Yandex | smtp.yandex.ru | 465 | 500/день |
| Mail.ru | smtp.mail.ru | 465 | 500/день |
| Mailgun | smtp.mailgun.org | 587 | по тарифу |
| Brevo | smtp-relay.brevo.com | 587 | 300/день free |
Тестирование в dev-режиме
В разработке удобно использовать Mailtrap или Ethereal — поддельные SMTP-серверы, которые перехватывают письма и показывают их в веб-интерфейсе:
// Ethereal для локального теста
if (process.env.NODE_ENV !== 'production') {
const testAccount = await nodemailer.createTestAccount();
transporter = nodemailer.createTransport({
host: 'smtp.ethereal.email',
port: 587,
auth: {
user: testAccount.user,
pass: testAccount.pass,
},
});
}
Сроки
Настройка Nodemailer + SMTP + тест-среда — полдня. С очередью на Bull и retry-логикой — 1 день.