Листи, відправлені з сайту, потрапляють до спаму? Клієнти не отримують сповіщення про замовлення? Знайома ситуація. Найчастіше причина — неправильне налаштування SMTP-сервера або відсутність SPF/DKIM записів. Ми, команда веб-розробників з багаторічним досвідом, щодня стикаємося з такими проблемами. У цій статті розберемо, як налаштувати відправку email через SMTP за допомогою Nodemailer — це повноцінне налаштування SMTP сервера, організувати пул з'єднань для високого навантаження та уникнути проблем з доставкою. Налаштування під ключ займає від 1 до 5 днів залежно від складності. Якщо хочете отримати готове рішення — зв'яжіться з нами, оцінимо проєкт безкоштовно.
Ось покроковий план налаштування:
- Обрати SMTP-провайдера.
- Налаштувати DNS-записи (SPF, DKIM, DMARC).
- Встановити Nodemailer і створити транспорт.
- Додати пул з'єднань для високого навантаження.
- Налаштувати чергу Bull з retry-логікою.
- Протестувати доставку через Mailtrap або Ethereal.
- Перейти в продакшн та моніторити доставку.
Чому листи потрапляють до спаму?
Основних причин три. Перша — відсутність SPF (Sender Policy Framework) запису в DNS: SMTP-сервер не авторизований відправляти листи від вашого домену. Друга — погана репутація IP-адреси, з якої йде розсилка. Третя — неправильні заголовки листа (відсутня DKIM-підпис, неправильний From). Навіть якщо ви використовуєте безкоштовний SMTP (Gmail, Yandex), необхідно налаштувати ці три компоненти. Інакше листи гарантовано потрапляють до Promotions або спаму.
Як ми налаштовуємо SMTP: кейс з нашої практики
Нещодавно з нашої практики: налаштовували відправку для інтернет-магазину — це кейс нашого клієнта, з 10 000 транзакційних листів на день: підтвердження замовлень, рахунки, статуси доставки. Використовували SMTP-релей Mailgun з наступними параметрами:
- Пул з'єднань: 5 паралельних, 100 листів на конект
- Черга на Bull з retry-логікою: 3 спроби із затримкою 30 секунд
- Повний набір DNS-записів: SPF, DKIM, DMARC (політика quarantine)
- Моніторинг bounced листів через вебхуки Mailgun
Результат: доставка в Inbox — 99,2% (проти 40% до налаштування). Витрати на відправку знизилися на 30% (близько 2000 грн/міс). Досвід показав, що правильна конфігурація SMTP окупається вже в перший місяць.
Яку технологію обрати: Nodemailer vs сторонні SDK?
Nodemailer виграє в 2-3 рази за швидкістю впровадження: одна бібліотека покриває всі популярні SMTP-сервери. SDK від SendGrid або Mailgun прив'язують вас до одного провайдера. Для гнучкості використовуємо Nodemailer + Bull для черги. А пул з'єднань підвищує пропускну здатність у 5 разів порівняно з одним з'єднанням.
Відправка через 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-00042', html: invoiceHtml, attachments: [ { filename: 'invoice-00042.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 }, }); Як налаштувати DNS-записи для доставки?
| Тип запису | Приклад | Призначення |
|---|---|---|
| SPF | v=spf1 include:mailgun.org ~all | Дозволяє SMTP-серверу відправляти пошту від домену |
| DKIM | Селектор default._domainkey з публічним ключем | Підпис листа, що підтверджує домен відправника |
| DMARC | v=DMARC1; p=quarantine; rua=mailto:[email protected] | Політика обробки листів, що не пройшли SPF/DKIM |
Популярні 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, }, }); } Типові помилки при налаштуванні SMTP
- Не налаштовані SPF/DKIM/DMARC — листи потрапляють до спаму
- Використання безкоштовних SMTP для комерційних розсилок — швидке блокування
- Відсутність пулу з'єднань при навантаженні >1000 листів/день — втрата листів
- Ігнорування bounced-сповіщень — падіння репутації
- Відправка з неправильного From — листи відхиляються
Що входить у налаштування під ключ
- Аудит поточної поштової конфігурації
- Вибір оптимального SMTP-провайдера
- Налаштування DNS: SPF, DKIM, DMARC
- Інтеграція Nodemailer з пулом та чергою (Bull)
- Налаштування моніторингу bounced та вебхуків
- Документація з експлуатації
- Навчання команди (1 година онлайн-консультації)
- Гарантія доставки 99% + підтримка 2 тижні
Строки
Налаштування Nodemailer + SMTP + тест-середовище — півдня. З чергою на Bull та retry-логікою — 1 день. Повний цикл (аналітика → проєктування → реалізація → тест → деплой) — від 1 до 5 днів залежно від обсягу трафіку. Наша компанія має 10+ років досвіду, реалізувала 200+ проєктів, на ринку з 2016 року. Якщо у вас виникли питання щодо налаштування SMTP, зв'яжіться з нами — ми допоможемо. Оцінимо проєкт безкоштовно.