Demo
Demo
База знаний PMTA›Блок Global›Директива§ 3.3.1.34

domain-suffix

Global

Чем достраивается неполный домен адреса
в конфигурации это строкаdomain-suffixвнутри блока Global
Вторая половина достройки адресов

Строка задаёт домен, который MTA приписывает к адресу, чей домен состоит из одной части — user@host вместо user@host.example.com.

Достройка касается адресов из разговора SMTP — MAIL FROM и RCPT TO, — и работает только тогда, когда включена сама достройка: auto-qualify-domain. Её умолчание — true.

Умолчания у суффикса нет. Не задан — достройка идёт от имени самой машины: на узле mail.foo.com адрес user@host станет user@host.foo.com.

Главная ловушка — умолчание берётся от имени машины, которое выбирали не вы. На арендованном сервере это имя выдал хостер, и адреса достраиваются его доменом — молча и без всякой ошибки.

Вторая половина хуже: достройка включена по умолчанию, и вместе с ней опечатка user@gmail перестаёт быть ошибкой. Она превращается в существующий адрес — вашего домена или хостерского, — и письмо уходит не туда. Ни отказа, ни записи в журнале.

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

Что делает Хаб. Не пишет — суффикс не нужен: достройку Хаб выключил, auto-qualify-domain no стоит в общем источнике 0/0 с 29.08.2026. Неполный адрес при подаче отвергается как ошибка, а не достраивается именем машины, выданным хостером.
Рекомендуемые значения

Что ставить. Решать надо не суффикс, а нужна ли достройка:

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

Третья строка — не рекомендация: так было у нас до 29.08.2026, пока достройку не выключили.

Назначение, условие «домен состоит из одной части» и связь с достройкой — из руководства, § 3.3.1.34 и § 3.3.7.73. Умолчания там не названо; вывод про имя машины — из примера § 3.3.7.73.
Пример в конфигурации
# либо задать суффикс осознанно, либо выключить достройку
domain-suffix bounce.example.com
<source 0/0>
    auto-qualify-domain true
</source>
Без первой строки достройка идёт от имени машины. Без второй — не идёт вовсе, и неполный адрес отвергается как ошибка.
жёлтым — — имена директив, голубым — блоки. Так же они подсвечены и в тексте карточки.
▲

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

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

Оставляют достройку без суффикса

§ 3.3.1.34

Чем чреватоАдреса достраиваются именем машины, которое на арендованном сервере выдал хостер. Опечатка в домене превращается в существующий адрес, и письмо уходит не туда — молча.
Как заметитьДостройка включена, строки суффикса нет, имя машины принадлежит хостеру.
Как правильноЛибо задать суффикс, либо выключить достройку в блоке источника.

Задают суффикс, не выключив достройку там, где она не нужна

наш опыт

Чем чреватоСуффикс делает достройку предсказуемой, но не отменяет её самой. Опечатка по-прежнему превращается в адрес вашего домена, а не в отказ.
Как заметитьВ учёте встречаются получатели вашего домена, которых в рассылке не было.
Как правильноТам, где подающая сторона обязана давать полный адрес, достройку выключать.
Совместимость
PowerMTA 6.0
описана в руководстве этой версии · платформа: любая
С какой версии директива доступна, вендор указывает не для всех — здесь пометки нет. Имя встречается и в издании руководства 5.0.
Справочные данные
Синтаксис
domain-suffix <domain>
Значения
имя домена
Применение
reload, перезапуск не нужен
Очередь
уже поставленное в очередь не затронет
Где писать
Global
Сколько раз
один раз в блоке
Всё здесь — из руководства, с разделом.
Наследование
Директива пишется в корне файла конфигурации и действует на весь узел: суффикс один на экземпляр. Сама достройка при этом включается в блоке источника и подчиняется его слиянию — то есть одну её половину можно развести по источникам, а вторую нет.
⇄

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

1 связь

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

auto-qualify-domain<source>Суффикс и есть то, чем достраивается неполный домен; выключите ту строку — и достройки не будет вовсе. § 3.3.1.34

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

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

3 статьи

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

В Хабе
Цена ошибки
безопасно: неверное значение ничего не ломает
Сценарии
Подключить платформу отправки
Соседние настройки блока Global:always-allow-relayingsmtp-listenerrelay-debugrelay-addresspickupВсе 108 директив блока →