Demo
Demo
База знаний PMTA›Блок <address-list>›Директива§ 3.3.5.1

address

<address-list>Хаб задаёт сам

Адрес, локальная часть или образец в списке
в конфигурации это строкаaddressвнутри блока <address-list>
Три формы записи в одной строке

Самая гибкая из пяти строк списка. Что именно вы написали, MTA понимает по форме:

Полный адрес — foo@bar.com — совпадает с ним и только с ним. Локальная часть — foo без домена — совпадает с этим именем ящика в любом домене. Образец в косых чертах — /^bounce@/ — регулярное выражение диалекта Perl.

Разница между первой и второй формой стоит внимания. foo — это не «адрес без домена», а правило на все домены сразу; в списке подавления такая строка выключает foo@ у каждого получателя.

Строка повторяется столько раз, сколько нужно записей.

Главная ловушка — локальная часть, принятая за адрес. Строка info в списке подавления означает «никаких писем на info@ куда бы то ни было». Пишется она так же коротко, как имя ящика в разговоре, и разницы в конфигурации не видно.
Что делает Хаб. Пишет — образцами, внутри безымянных списков базовой конфигурации: /^bounce@bounce\./ и /^(dmarc|postmaster|abuse)@/ отбирают входящую почту для обработчика отказов, /^fbl@fbl\./ — для обработчика жалоб. Для подавления Хаб эту строку не пишет: чёрный список живёт в его базе, до узла.
Рекомендуемые значения

Три формы и когда какая:

Форма Что совпадёт Осторожно
foo@bar.com ровно этот адрес ничего
foo foo@ в любом домене шире, чем кажется
/^bounce@/ всё по образцу цена ошибки — та же, что у любого регулярного выражения

Точки в образце экранировать. /^bounce@bounce\./ и /^bounce@bounce./ — разные вещи: во втором точка означает любой знак.

Три формы — из руководства (§ 3.3.5.1). Предупреждение про локальную часть и экранирование — наши.
Пример в конфигурации
# три формы в одном списке — и все три значат разное
<address-list suppression1>
    address foo@bar.com
    address foo    address /^bounce@/
</address-list>
Подсвеченная строка — самая опасная из трёх: она означает foo@ в любом домене, а не адрес без домена. Пример руководства с его же комментариями.
жёлтым — — имена директив, голубым — блоки. Так же они подсвечены и в тексте карточки.
▲

Типичные ошибки и проблемы

что делают не так и чем это кончается2 ошибки▶

Пишут локальную часть, имея в виду один адрес

§ 3.3.5.1

Чем чреватоsupport в списке подавления выключает support@ у всех получателей разом, а не у одного домена. В коротком списке это незаметно, а действует широко.
Как заметитьПисьма не уходят получателям, которых в список не клали.
Как правильноПисать полный адрес, если имелся в виду один. Локальную часть использовать сознательно — там, где правило действительно про все домены.

Не экранируют точки в образце

наш опыт

Чем чреватоТочка означает любой знак. /^bounce@bounce./ совпадёт с bounce@bounceXexample.com, то есть с чужим доменом похожего вида.
Как заметитьВ список попадает больше, чем задумано; в обработчик отказов приходит чужая почта.
Как правильноЭкранировать: /^bounce@bounce\./. Именно так написано в конфигурации, которую собирает Хаб.
Совместимость
PowerMTA 6.0
описана в руководстве этой версии · платформа: любая
С какой версии директива доступна, вендор указывает не для всех — здесь пометки нет. Имя встречается и в издании руководства 5.0.
Справочные данные
Синтаксис
address <address-or-regex>
Значения
полный адрес, локальная часть без домена или регулярное выражение в косых чертах
Применение
reload, перезапуск не нужен
Очередь
уже поставленное в очередь не затронет
Где писать
<address-list>
Сколько раз
можно повторять
Всё здесь — из руководства, с разделом.
Наследование
Наследования у строки нет: она действует внутри своего блока <address-list>. Наследуется ссылка на список — suppression-lists в <source> сливается по правилу источников, в пуле достаётся участникам, а собственная строка участника пуловую перекрывает.
⇄

Связанные директивы

2 связи

Зависит от

Четыре типа значений, на которых написан весь конфигОбразец в косых чертах — регулярное выражение того же диалекта, что и везде в конфигурации. § 3.2

Где применяется

Списки адресов — именованные и безымянныеОсновная из пяти строк, которыми наполняют список. § 3.3.5.1

Сюда ссылаются

hashed-address<address-list>Та же запись в открытом виде: гибче, но читаема всеми, у кого есть доступ к конфигурации. § 3.3.5.2address-file<address-list>Та же запись, но по одной в строке файла, а не в конфигурации. § 3.3.5.3Диалект регулярных выраженийДиректива, которой этот механизм и включается. § 3.2

Как проверить на узле
Отдельной проверки у строки нет — смотреть надо, сработал ли список. В отказе стоит его имя:
pmtaacctfind --output csv[rcpt,dsnDiag] /var/log/pmta/acct-*.csv
Если совпадения нет, чаще всего дело в форме: незаэкранированная точка в образце или полный адрес там, где ожидалась локальная часть. Хешированные строки образцами не проверяются вовсе.
◇

Что ещё почитать

3 статьи

◇Списки адресов — именованные и безымянныеСписок адресов, доменов, образцов или хешей; именованный подключается директивами вроде подавления, безымянный живёт внутри процессора входящей почты.◇Кому разрешено сдавать почту и для кого её приниматьИз коробки узел принимает подачу только с самой машины; два разных вопроса — «кто может слать через нас» и «на чьи адреса мы принимаем» — решаются разными директивами.◇Два обработчика входящих отчётов и что с ними делатьОтказы письмом и жалобы разбираются двумя одинаково устроенными блоками; у каждого свой список адресов и своя пара решений о судьбе письма.

В Хабе
Управляется
Аналитика → Учёт узла
Значение
Хаб подбирает сам — темп, стадия прогрева, метрики
Цена ошибки
обратимо: вредит, пока стоит
Сценарии
Приём входящей почты · Подавление адресов
Соседние настройки блока <address-list>:hashed-addressaddress-filedomainhashed-address-fileВсе 5 директив блока →