Перейти к содержанию

Fastify

Инструкция для приложений на Fastify (Node.js 18+). Mailexam подключается как SMTP через Nodemailer.

Не путать с FastAPI

FastAPI — Python-фреймворк. Здесь — Fastify для Node.js.

Что понадобится

  • Аккаунт Mailexam и проект с SMTP-учётными данными.
  • Node.js 18+ и npm.

Скопируйте из приветственного письма (или кабинета) для вашего проекта:

  • ВАШ_ЛОГИН — SMTP-логин (например, xxxxx);
  • ВАШ_ПАРОЛЬ — SMTP-пароль (уникальная пара к логину);
  • хост — ВАШ_ЛОГИН.mailexam.ru (совпадает с логином).

1. Зависимости

npm init -y
npm install fastify nodemailer dotenv

Файл package.json:

{
  "type": "commonjs",
  "scripts": {
    "start": "node server.js"
  },
  "dependencies": {
    "dotenv": "^16.0.0",
    "fastify": "^5.0.0",
    "nodemailer": "^6.9.0"
  }
}

2. Переменные окружения

Файл .env в корне проекта (не коммитьте пароли в git):

MAILEXAM_LOGIN=ВАШ_ЛОГИН
MAILEXAM_PASSWORD=ВАШ_ПАРОЛЬ
MAILEXAM_PORT=587
MAIL_FROM=noreply@example.test

Хост SMTP: ВАШ_ЛОГИН.mailexam.ru.

Адрес отправителя

MAIL_FROM может быть любым тестовым адресом — письмо попадёт в Mailexam, а не реальному получателю.

Альтернативные порты

MAILEXAM_PORT=587

В транспорте: secure: false.

MAILEXAM_PORT=2525

MAILEXAM_PORT=465

В транспорте: secure: true.

3. Транспорт Nodemailer

// mail.js
const nodemailer = require('nodemailer');

function createTransport() {
  const login = process.env.MAILEXAM_LOGIN;
  const port = Number(process.env.MAILEXAM_PORT || 587);

  return nodemailer.createTransport({
    host: `${login}.mailexam.ru`,
    port,
    secure: port === 465,
    auth: {
      user: login,
      pass: process.env.MAILEXAM_PASSWORD,
    },
  });
}

async function sendTest({ to, subject, text }) {
  const transport = createTransport();

  await transport.sendMail({
    from: process.env.MAIL_FROM || 'noreply@example.test',
    to: to || 'user@example.test',
    subject: subject || 'Fastify + Mailexam',
    text: text || 'Тест Mailexam из Fastify',
  });
}

module.exports = { sendTest };

4. Маршрут Fastify

// server.js
require('dotenv').config();

const Fastify = require('fastify');
const { sendTest } = require('./mail');

const app = Fastify({ logger: true });

app.post('/mail/test', async (request) => {
  const { to, subject, text } = request.body ?? {};

  await sendTest({ to, subject, text });

  return { status: 'ok' };
});

const start = async () => {
  try {
    await app.listen({ port: 3000, host: '127.0.0.1' });
  } catch (err) {
    app.log.error(err);
    process.exit(1);
  }
};

start();

Запуск и проверка:

npm start

curl -X POST http://127.0.0.1:3000/mail/test \
  -H 'Content-Type: application/json' \
  -d '{"to":"user@example.test","subject":"Проверка","text":"Привет"}'

Письмо появится в кабинете Mailexam → ваш проект → входящие.

5. Локальная разработка и CI

Среда Рекомендация
local .env + require('dotenv').config()
CI Секреты MAILEXAM_LOGIN, MAILEXAM_PASSWORD в GitLab CI/CD Variables

Пример для .gitlab-ci.yml:

variables:
  MAILEXAM_LOGIN: $MAILEXAM_LOGIN
  MAILEXAM_PASSWORD: $MAILEXAM_PASSWORD
  MAILEXAM_PORT: "587"
  MAIL_FROM: "noreply@example.test"

После интеграционного теста проверьте доставку через API Mailexam.

6. Типичные проблемы

Connection timeout / authentication failed

  • host должен быть {логин}.mailexam.ru, auth.user — тот же логин из письма.
  • Логин и пароль — пара из письма одного проекта.

Порт 587 и TLS

  • Для 587: secure: false (STARTTLS). Для 465: secure: true.

Пустое тело запроса

  • Отправляйте JSON с заголовком Content-Type: application/json.

Письмо не в кабинете

  • Смотрите входящие того же проекта Mailexam.
  • Смотрите лог Fastify (logger: true) при ошибке SMTP.

См. также