Налаштування SMTP-сервера для відправки email з сайту

Налаштування відправлення 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 з Nodemailer — 1–2 дня.