Практически у каждого разработчика на Битрикс при переходе с уровня "сайт из 5 страничек" на уровень "крупный проект с 10к+ пользователями" возникает потребность производить отладку отправки почты, но при этом чтобы фактически пользователи эту почту не получали. Так как случайная отправка отладочного сообщения пользователям сайта из 5 страничек, которых обычно 5-6 человек, как правило ощутимых репутационных издержек не несет, что нельзя сказать о крупном проекте с большой пользовательской базой. Когда задачи не связаны с почтовой подсистемой, многие разработчики просто отключают отправку исходящей почты на своем dev окружении, также как то давно я выходил из этой ситуации переконфигурированием почтового сервера для безусловной отправки всех писем на определенный ящик. Не совсем удобное, даже "костыльное" решение на мой взгляд, так как в приходящих сообщениях получаем измененный заголовок получателя и проверить правильность в полной мере по сути невозможно, только с точки зрения контента отправляемого письма.

Недавно я начал искать, какие решения есть сейчас для отладки отправки почты без ее фактической отправки, при этом решение должно ставиться локально на сервер, так как большинство проектов у меня связаны с разработкой порталов на Битрикс24 Энтерпрайз, поэтому за использование внешних сервисов можно получить очень большой "нагоняй" от службы ИБ заказчиков. Если же вам больше подходит онлайн-сервис, который не нужно как-то устанавливать, а просто прописать в настройках msmtp окружения - можете посмотреть в сторону DebugMail, MailSlurp, TestMail. Их "гуглится" масса, можно выбрать на свой вкус, по функционалу, цене, длине шерсти и хвоста :) Единственный недостаток - сервисы в большинстве иностранные, поэтому платную версию из России будет купить проблематично.

Я же искал приложение, которое можно установить прямо на локальный сервер или компьютер. И после непродолжительных поисков нашел довольно интересный и устраивающий меня вариант - MailCatcher. Решение OpenSource (MIT Licence), соответственно с трансграничными оплатами заморачиваться не нужно, представляет из себя простой эмулятор SMTP сервера с web GUI, где письма отображаются. Написан на Ruby.

Подробно останавливаться на функционале приложения не буду - это прекрасно сделал на Хабре еще в 2014 году камрад @kriptomen в переведенной статье Отладка электронной почты при помощи MailCatcher. Я же подробно разберу процесс установки этого решения на типовом окружении BitrixEnv с точки зрения не Ruby разработчика :)

Установка и настройка MailCatcher на окружении BitrixEnv 7.5.5 операционной системы CentOS 7 X64

^{P.S. кто не любит читать вступления и прочую "воду" - статья "по существу" начинается отсюда :)}

Для начала давайте условимся, что у нас уже есть сервер с установленным окружением BitrixEnv 7.5.5 (актуальная стабильная версия на момент написания статьи). Подробно установку окружения Битрикс на сервер в рамках статьи разбирать не будем - на эту тему есть много материалов в том числе от компании-разработчика Битрикс. Также сервер имеет доступ в Интернет, виден с нашего ПК в браузере и через ssh. IP адрес сервера для примера будет 10.0.0.1.

Итак, заходим по SSH с правами root на сервер где у нас установлено окружение, закрываем стандартное меню окружения "Manage server pool" для перехода в командную строку - либо нажимаем Ctrl+C либо 0 затем Enter.

Устанавливаем необходимые для сборки системные библиотеки, репозиторий и Ruby версии 3

yum update

yum install -y gcc gcc-c++ sqlite-devel centos-release-scl-rh centos-release-scl

yum --enablerepo=centos-sclo-rh  install -y rh-ruby30 rh-ruby30-ruby-devel

Нужно на момент написания статьи устанавливать именно 3 версию Ruby, на версиях ниже MailCatcher собираться отказывается.

Активируем Ruby для командной строки bash

scl enable rh-ruby30 bash

Это активирует ruby только на время текущего сеанса пользователя. Если для каких-то целей ruby в командной строке нужен постоянно, необходимо прописать команду в скриптах инициализации сеанса (например .bashrc):

source scl_source enable rh-ruby30

Собираем MailCatcher

gem install mailcatcher

Начнется довольно небыстрый процесс загрузки всех необходимых зависимостей и их сборки. У меня заняло примерно 5 минут. Обязательно нужно дождаться окончания данного процесса.

Разрешаем порт MailCatcher в iptables

Встроенный в окружение iptables будет по умолчанию блокировать порт приложения при попытке подключиться из браузера. Для этого вводим следующие правила:

iptables -I INPUT -p tcp -m tcp --sport 1080 -j ACCEPT

iptables -I INPUT -p tcp -m tcp --dport 1080 -j ACCEPT

service iptables save

Данные правила актуальны если вы запускаете GUI MailCatcher на порту 1080. Если же собираетесь для этих целей использовать другой порт - в командах выше указываете его.

Прописываем MailCatcher как SMTP сервер для сайтов окружения

Сделать это можно как через меню окружения (под админом выполнить cd ~ и далее ./menu.sh), выбрав пункт 6. Configure pool sites далее 4. Change a site's email settings, указываем название сайта для которого хотим прописать настройки, после чего вводим:

Enter From email address (ex. bob@example.org):test@test.ru

Вводим адрес который будет проставляться в заголовок from. В нашем случае можно ввести любое значение.

Enter server address or DNS (127.0.0.1):10.0.0.1

Вводим адрес сервера с BitrixEnv.

Enter server port (25):1025

Здесь указываем SMTP порт на который будем вешать SMTP эмулятор MailCatcher. По умолчанию - 1025.

Do you want to use SMTP authentication on 127.0.0.1:1025? (N|y) N

Авторизация по SMTP не нужна

Do you want to enable TLS for 127.0.0.1:1025 (n|Y):n

Шифрование тоже не нужно. После этого Битрикс будет отправлять всю исходящую почту для указанного сайта на порт эмулятора SMTP mailCatcher. Если нужно прописать настройки для всех сайтов, то в меню окружения выбираем сайт default, либо можно "руками" создать под пользователем bitrix файл /home/bitrix/.msmtprc и положить туда следующий текст настроек:

account default
logfile /home/bitrix/msmtp.log
host 10.0.0.1 
port 1025 
from test@test.ru
keepbcc on
auth off

Запускаем MailCatcher

Для запуска mailcatcher в виде фоновой службы (демона) достаточно выполнить следующую команду:

mailcatcher --ip 10.0.0.1 --no-quit --messages-limit 10000

Если все запустилось корректно - в команднйо строке отобразятся адреса и порты эмулятора SMTP сервера и адрес для входа в веб-интерфейс браузера.

Также я указал дополнительные команды по своему конкретному "вкусу", а именно:

--no-quit - скрывает кнопку Quit из веб-интерфейса, при нажатии которой Mailcatcher полностью останавливается. В моем случае приложение стоит на сервере где тестировщики проверяют корректность выполнения задач разработчиками, и очень часто по незнанию нажимали кнопку Quit думая что это обычная "разавторизация". В итоге после каждого такого случая демона приходилось перезапускать вручную, что не удобно. Вы для себя уже сами решайте нужна вам эта функция или нет.

--messages-limit 10000 - устанавливает максимальное количество сообщений которое хранит MailCatcher. На мой взгляд для теста 10000 сообщений вполне достаточно. Вы уже для своей ситуации решайте сами. Логика работы настройки - если писем становится больше 10000 - старые письма удаляются из списка.

Все доступные настройки запуска можно посмотреть выполнив команду:

mailcatcher --help

Проверяем все ли установилось корректно

Для начала проверяем корректность работы msmtp:

echo -e "test message" | /usr/bin/msmtp --debug -t -i name@site.ru

В ответ на эту команду в терминале не должно быть ошибок. Если они есть, то как правило связаны с некорректными правами на файл конфигурации .msmtprc и файл журнала, указанный в файле конфигурации в параметре logfile.

Далее для финальной проверки зайдите через браузер в административную часть Битрикс, установленного в окружении, далее перейдите в раздел "Проверка системы" и запустите проверку. Напротив пунктов "Отправка почтового сообщения" и "Отправка сообщения больше 64 Кб" должна отразиться зеленая строка "Успешно".

Далее тестовые письма должны отобразиться в интерфейсе MailCatcher:

Можно посмотреть как текст письма в виде HTML либо PlainText, так и исходники с заголовками, что очень удобно при отладке. В правом верхнем углу есть строка поиска по письмам и кнопка Clear - очищающая список писем.

Таким образом, мы интегрировали отладчик почты MailCatcher в стандартное окружение Битрикс - BitrixEnv. Всем спасибо за внимание!