D/ DOBBYDEV DOCS

BLACKHOLE / DOCUMENTATION

Документация Blackhole

Понятные инструкции по настройке, работе и обслуживанию системы.

Руководство / 16

Доставка, журналы и диагностика

Как проследить письмо и отличить конфигурацию, очередь, аудит и системный журнал.

Проверить доставку

  1. Зафиксируйте время с часовым поясом, отправителя, получателя и Message-ID тестового сообщения. Не пересылайте полное письмо или секреты без необходимости.
  2. Откройте «Почтовый поток → Почтовая очередь». Проверьте состояние и последнюю ошибку ожидающих отправки сообщений. Успешно доставленное письмо уже может отсутствовать в текущей очереди: его ищут по сохранённым журналам. Queue-ID — идентификатор в очереди, а Message-ID — заголовок письма; это не одно и то же.
  3. Откройте «Поиск писем» (/ui/mail/search), задайте известные условия и нажмите «Найти письма». Найденные письма показываются слева; выберите сообщение, чтобы справа увидеть «Путь письма». Для известного идентификатора используйте «Прохождение письма» (/ui/mail/trace).
  4. Сопоставьте события приёма, обработки, маршрутизации и ответа удалённого сервера. Уточняйте условия или продолжайте чтение, если ответ неполный. После устранения причины отправьте новое контрольное письмо и проверьте итог у получателя.

Условия поиска писем

Все заполненные условия выполняются вместе для одного письма: «От кого», «Кому», тема, домен и период. Отправителя и получателя можно задавать независимо или вместе; адрес, имя и тема ищутся по вхождению. Домен задаётся без @ и * и проверяется как точное совпадение домена отправителя или получателя. Адреса и домен берутся из SMTP-конверта, имена — из заголовков письма. Даты необязательны: без них проверяются все сохранённые журналы; только начало — от него до момента запуска поиска, только конец — сохранённая история до него. Можно выбрать обе границы через календарь или ввести дату и время; календарь использует UTC, конец периода не включается. Для старых строк без часового пояса отдельно показано принятое смещение UTC; оно сохраняется между страницами. Тема и имена старых писем могли не сохраняться: неполнота обозначается явно. «Нет совпадений» в прочитанной части или ограниченной странице не доказывает, что письмо не отправлялось.

Маршруты и ретрансляторы

Настройки реле и транспорта определяют путь отправки, но не исправляют пароль клиента или DNS автоматически. Перед изменением запишите исходный маршрут, целевой узел, порт, TLS и способ авторизации. Проверьте доставку в затронутый домен и контрольный домен, который менять не планировали. Не создавайте открытый relay и не снимайте проверку TLS из-за одной ошибки соединения.

Аудит, системные журналы и syslog

Эти инструменты находятся в «Мониторинг». Аудит показывает административное действие, субъект и результат; системный журнал — работу компонентов. Внешний syslog требует доступного получателя и соответствующего транспорта. Отсутствие строк может означать неверный период, права или недоступный источник, а не отсутствие событий. В выгрузках маскируйте токены, пароли, cookie и ненужные персональные данные; сохраняйте время, компонент и идентификатор корреляции.

Подключения и внешние адреса

Раздел подключений — диагностическое представление: он не обещает возможность принудительно завершить любое соединение. Список внешних IP и статистика не заменяют проверку фактического исходящего адреса и NAT. Информационные рассылки или другие пункты, явно помеченные недоступными, не становятся рабочими функциями из-за присутствия в меню.

Типовые развилки

Если письмо не принято — изучите SMTP-ответ клиента и доступ к службе. Если принято и задержано — очередь и следующий узел. Если доставлено сервером, но не видно пользователю — папки, правила, квоту и клиентскую синхронизацию. Удаление из очереди не равно повторной доставке; выполняйте доступные опасные действия только после проверки точного сообщения и последствий.

Экран аудита

Журнал административного аудита с фильтрами и результатами действий
Реальный интерфейс; демонстрационные данные example.org.