Demo
Demo
База знаний PMTA›Блок <source>›Директива§ 3.3.7.73

auto-qualify-domain

<source>Хаб задаёт сам

Дополнять ли неполный домен адреса доменным суффиксом
в конфигурации это строкаauto-qualify-domain trueвнутри блока <source>
Достройка адресов, которые пришли без домена

Умолчание — true. Если в разговоре SMTP пришёл адрес, домен которого состоит из одной части (user@host), MTA достраивает его, приписывая доменный суффикс: на машине mail.foo.com адрес станет user@host.foo.com.

Достройка касается обоих адресов разговора — и MAIL FROM, и RCPT TO.

Суффикс задаётся отдельно, строкой domain-suffix в корне файла. Не задан — берётся от имени самой машины.

Главная ловушка — молчаливая подмена адреса. Достройка выглядит удобством для локальных отправителей, а на деле это правка того, что прислал клиент. Опечатка в домене (user@gmail вместо user@gmail.com) не отвергается, а превращается в существующий адрес вашего домена — и письмо уходит не туда, куда собиралось.

Второй край: суффикс по умолчанию берётся от имени машины. Значит на узле, чьё имя вы не выбирали, адреса достраиваются доменом, о котором вы не думали.

Что делает Хаб. Пишет auto-qualify-domain no в общем источнике <source 0/0> — с 29.08.2026.

Почему выключили. Достройка придумана для внутренних почтовых систем, где user@host — законная запись. У нас подача идёт от платформ рассылки со списками адресов, и неполный домен там означает ошибку в списке. Правильная реакция на ошибку — отказ при подаче, чтобы список почистили; достройка вместо этого делает адрес «правильным», письмо уходит в никуда и приносит отказ в статистику приёмника.

Побочно закрыт и второй случай: достроенный адрес мог попасть в обратный путь письма там, где переписывание не включено.

Рекомендуемые значения

Что ставить. Вопрос — доверяете ли вы адресам, которые приходят при подаче:

Значение Когда
true (умолчание) подают локальные скрипты в старом стиле, и адреса без домена законны
false подача идёт от платформы, которая всегда даёт полный адрес — тогда неполный это опечатка, и отвергнуть её честнее

Второе строже и почти всегда вернее для рассылки: письмо, ушедшее по достроенному адресу, никуда не жалуется — оно просто уходит не тому.

Умолчание true, разбор примера user@host и указание, что суффикс настраивается, — из руководства, § 3.3.7.73 и § 3.3.1.34. Разбивка случаев наша.
Пример в конфигурации
# неполный адрес — признак опечатки, а не сокращения
<source 0/0>
    auto-qualify-domain false</source>
С этим значением адрес вида user@gmail не достроится до вашего домена, а будет отвергнут как неполный — и отправитель об этом узнает.
жёлтым — — имена директив, голубым — блоки. Так же они подсвечены и в тексте карточки.
▲

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

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

Оставляют достройку там, где подают полные адреса

§ 3.3.7.73

Чем чреватоОпечатка в домене перестаёт быть ошибкой: неполный адрес достраивается вашим суффиксом и превращается в существующий. Письмо уходит не тому, и ни отправитель, ни узел об этом не сообщают.
Как заметитьВ учёте встречаются получатели в вашем домене, которых в рассылке не было.
Как правильноВыключить достройку там, где подающая сторона обязана давать полный адрес.

Полагаются на суффикс, которого не задавали

§ 3.3.1.34

Чем чреватоБез явной строки суффикс берётся от имени машины. На узле, чьё имя выдал хостер, адреса достраиваются доменом, к вашей рассылке отношения не имеющим.
Как заметитьДостроенные адреса оканчиваются доменом хостера.
Как правильноЛибо задать суффикс явно, либо выключить достройку.
Совместимость
PowerMTA 6.0
описана в руководстве этой версии · платформа: любая
С какой версии директива доступна, вендор указывает не для всех — здесь пометки нет. Имя встречается и в издании руководства 5.0.
Справочные данные
Синтаксис
auto-qualify-domain <boolean>
Значения
yes | no | true | false
Умолчание
true § 3.3.7.73
Применение
reload, перезапуск не нужен
Очередь
уже поставленное в очередь не затронет
Где писать
<source>
Сколько раз
один раз в блоке
Всё здесь — из руководства, с разделом.
Наследование
Директива живёт в <source> и подчиняется слиянию источников: соединение попадает под все адресные блоки, которые его накрывают, и узкий перекрывает широкий. Сам суффикс при этом задаётся в корне файла и на источники не делится — он один на всю установку.
⇄

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

1 связь

Без чего не работает

domain-suffixGlobalЧем именно достраивается адрес; не задан — берётся от имени машины. § 3.3.7.73

Как проверить на узле
Обе строки проверяются вместе: без суффикса достраивать нечем, кроме имени машины:
grep -n 'auto-qualify-domain\|^domain-suffix\|^host-name' /etc/pmta/config
Если суффикс не задан, достройка идёт от имени машины — стоит посмотреть, какое оно на самом деле. Сработала ли достройка, видно по адресам в учёте: они там уже полные.
◇

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

3 статьи

◇Как письмо попадает в MTAШесть описанных способов подачи: расширенный SMTP, четыре языковые обвязки и каталог, за которым узел следит на диске.◇Кому разрешено сдавать почту и для кого её приниматьИз коробки узел принимает подачу только с самой машины; два разных вопроса — «кто может слать через нас» и «на чьи адреса мы принимаем» — решаются разными директивами.◇Заголовки, которыми отправитель управляет доставкойШесть служебных заголовков позволяют подающей стороне выбрать поток, пометить письмо заданием, задать настройки и ключ подписи, идентификатор конверта и расписание; каждый разрешается отдельно и по источникам.

В Хабе
Значение
Хаб подбирает сам — темп, стадия прогрева, метрики
Цена ошибки
обратимо: вредит, пока стоит
Сценарии
Подключить платформу отправки
Соседние настройки блока <source>:allow-smtputf8disconnect-on-transient-errorallow-authaccept-invalid-recipientsalways-allow-api-submissionВсе 74 директив блока →