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

Django

Инструкция для проектов на Django (4.2 LTS и 5.x). Mailexam подключается через встроенный SMTP-бэкенд django.core.mail — достаточно настроек в settings.py и вызова send_mail.

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

  • Аккаунт Mailexam и проект с SMTP-учётными данными.
  • Python 3.10+ и установленный Django-проект.

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

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

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

python3 -m venv .venv
source .venv/bin/activate
pip install django python-dotenv

Файл requirements.txt:

django>=5.0
python-dotenv>=1.0

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

Файл .env в корне проекта (рядом с manage.py, не коммитьте пароли в git):

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

Хост в настройках Django: {MAILEXAM_LOGIN}.mailexam.ru.

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

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

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

MAILEXAM_PORT=587

В settings.py: EMAIL_USE_TLS = True.

MAILEXAM_PORT=2525

EMAIL_USE_TLS = True.

MAILEXAM_PORT=25

EMAIL_USE_TLS = False.

3. Настройка settings.py

В начале файла загрузите .env (опционально, для локальной разработки):

from pathlib import Path

from dotenv import load_dotenv

BASE_DIR = Path(__file__).resolve().parent.parent
load_dotenv(BASE_DIR / ".env")

Блок почты Mailexam:

import os

MAILEXAM_LOGIN = os.environ["MAILEXAM_LOGIN"]
MAILEXAM_PASSWORD = os.environ["MAILEXAM_PASSWORD"]
MAILEXAM_PORT = int(os.environ.get("MAILEXAM_PORT", "587"))

EMAIL_BACKEND = "django.core.mail.backends.smtp.EmailBackend"
EMAIL_HOST = f"{MAILEXAM_LOGIN}.mailexam.ru"
EMAIL_PORT = MAILEXAM_PORT
EMAIL_USE_TLS = MAILEXAM_PORT in (587, 2525)
EMAIL_HOST_USER = MAILEXAM_LOGIN
EMAIL_HOST_PASSWORD = MAILEXAM_PASSWORD
DEFAULT_FROM_EMAIL = os.environ.get("MAIL_FROM", "noreply@example.test")

4. Отправка тестового письма

Через shell

python manage.py shell

from django.core.mail import send_mail

send_mail(
    "Django + Mailexam",
    "Тест Mailexam из Django",
    None,  # from DEFAULT_FROM_EMAIL
    ["user@example.test"],
)

Через view

# myapp/views.py
import json

from django.conf import settings
from django.core.mail import send_mail
from django.http import JsonResponse
from django.views.decorators.http import require_POST


@require_POST
def mail_test(request):
    data = json.loads(request.body or "{}")
    send_mail(
        subject=data.get("subject", "Django + Mailexam"),
        message=data.get("body", "Тест Mailexam из Django"),
        from_email=settings.DEFAULT_FROM_EMAIL,
        recipient_list=[data.get("to", "user@example.test")],
    )
    return JsonResponse({"status": "ok"})

# myapp/urls.py
from django.urls import path

from . import views

urlpatterns = [
    path("mail/test", views.mail_test, name="mail_test"),
]

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

python manage.py runserver

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

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

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

Среда Рекомендация
local .env + load_dotenv или экспорт переменных в shell
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.

Для unit-тестов без сети используйте EMAIL_BACKEND = "django.core.mail.backends.locmem.EmailBackend".

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

Ошибка TLS или подключения

  • EMAIL_HOST должен быть {логин}.mailexam.ru, где {логин} — то же значение, что EMAIL_HOST_USER / MAILEXAM_LOGIN.
  • Логин и пароль — пара из письма; не комбинируйте данные разных проектов.
  • Для порта 587 включите EMAIL_USE_TLS = True.

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

  • Убедитесь, что смотрите входящие того же проекта Mailexam.
  • Проверьте, что в production не переопределён EMAIL_BACKEND на консольный или файловый.

Настройки не применяются

  • Перезапустите runserver после изменения settings.py.
  • В production задайте переменные окружения в процессе (gunicorn/uwsgi), а не только в .env на диске.

См. также