Demo
Demo
База знаний PMTA›Блок <virtual-mta>›Директива§ 3.3.12.5

host-name

<virtual-mta>критично

Имя в приветствии для писем с этого адреса отправки
в конфигурации это строкаhost-nameвнутри блока <virtual-mta>
То же имя ещё 1:Global<virtual-mta>— часть из них другие настройки, часть та же самая
Имя этого адреса отправки — и его место в разборе

Синтаксис тот же, что на уровне узла. Меняется область: имя действует только на письма, уходящие через этот адрес отправки.

Но перекрытие общего имени — не последнее слово. Разбор имени для приветствия смотрит раньше на имя, привязанное к самому адресу, — второе слово smtp-source-host. Пока оно там есть, эта строка ни на что не влияет.

Отсюда её настоящее место. Она нужна там, где имя к адресу не привязано: адрес задан диапазоном, или строка адреса вовсе пропущена и наследуется от узла. В обычном парке, где у каждого адреса отправки своя пара «адрес плюс имя», директива не требуется вовсе.

Главная ловушка. Строка выглядит как прямой способ задать имя потоку — и молчит, если имя уже привязано к адресу. Правка применяется без ошибок и не меняет ничего; ищут причину в DNS, а она в порядке разбора.
Что делает Хаб. Не пишет ни здесь, ни на уровне узла: имя задаётся вторым словом smtp-source-host у каждого адреса отправки. Прямую и обратную записи Хаб сверяет до ввода адреса в работу — несовпадение показывает предупреждением, ввести адрес при этом можно.
Рекомендуемые значения

Значение то же — полное доменное имя. Вопрос здесь другой: нужна ли строка вообще.

Как задан адрес отправки Нужна ли эта строка
пара «адрес плюс имя» в smtp-source-host нет: имя берётся оттуда, разбор сюда не дойдёт
адрес диапазоном CIDR да: у диапазона одно имя на все адреса, и задать его больше негде
строка адреса пропущена да, но лучше не пропускать строку адреса

Имя обязано сходиться с обратной записью того адреса, с которого письмо уходит. У диапазона это условие выполнимо не для всех адресов сразу — ещё одна причина не задавать адреса диапазонами.

Место директивы в разборе — из руководства (§ 3.3.1.35). Вывод «в парке она не нужна» — наш.
Пример в конфигурации
# имя нужно здесь ровно потому, что адрес задан диапазоном
<virtual-mta bulk>
    smtp-source-host 203.0.113.0/28
    host-name mail.example.com</virtual-mta>
У диапазона имени во второй позиции нет, и разбор идёт дальше — до этой строки. Все шестнадцать адресов представятся одним именем, и сойтись с обратной записью оно сможет в лучшем случае у одного из них.
жёлтым — — имена директив, голубым — блоки. Так же они подсвечены и в тексте карточки.
▲

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

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

Задают имя здесь при уже привязанном к адресу

§ 3.3.1.35

Чем чреватоРазбор берёт имя адреса раньше. Строка применяется без ошибок и не влияет ни на что; при этом создаёт впечатление, что имя задано, — и следующий человек будет искать ошибку не там.
Как заметитьВ конфигурации имя одно, в EHLO другое, ошибок при применении нет.
Как правильноЛибо править вторым словом smtp-source-host, либо, если строка здесь действительно нужна, убрать имя из пары адреса.

Одно имя на диапазон адресов

наш опыт

Чем чреватоОбратные записи у адресов диапазона разные, а имя в приветствии одно. Сойтись оно может максимум у одного адреса; для остальных получатель видит расхождение.
Как заметитьЧасть писем одного адреса отправки доставляется заметно хуже остальных, и разница совпадает с адресом доставки в учёте.
Как правильноРазвести диапазон на строки smtp-source-host — по адресу и своему имени в каждой.
Совместимость
PowerMTA 6.0
описана в руководстве этой версии · платформа: любая
С какой версии директива доступна, вендор указывает не для всех — здесь пометки нет. Имя встречается и в издании руководства 5.0.
Справочные данные
Синтаксис
host-name <see-global>
Значения
полное доменное имя
Применение
reload, перезапуск не нужен
Очередь
уже поставленное в очередь не затронет
Где писать
<virtual-mta>
Сколько раз
можно повторять
Всё здесь — из руководства, с разделом.
Наследование
Здесь запись перекрывает общее имя узла для писем этого адреса отправки, а пуловая — промежуточный уровень: <virtual-mta-pool> раздаёт своё значение участникам, участник перекрывает его своим. Но весь этот порядок применяется только тогда, когда разбор до него дошёл: имя, привязанное к адресу в smtp-source-host, сильнее любого из трёх уровней.
⇄

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

2 связи

То же имя в других блоках

host-nameGlobalОпределение директивы руководство даёт на уровне узла; здесь — только то, что меняет запись внутри адреса отправки. § 3.3.1.35

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

Адрес отправки — из чего он складываетсяОдна из настроек, из которых складывается отправляющая личность. § 3.3.12.5

Как проверить на узле
Смотреть надо не в конфигурацию, а в то, чем узел представляется на самом деле:
swaks --server 203.0.113.10 --to probe@example.net --quit-after HELO
Имя из EHLO сверяется с dig -x 203.0.113.10 +short. Если оно не то, что стоит здесь, — разбор взял его раньше, у пары «адрес плюс имя», и править надо smtp-source-host.
◇

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

3 статьи

◇Заголовки, которыми отправитель управляет доставкойШесть служебных заголовков позволяют подающей стороне выбрать поток, пометить письмо заданием, задать настройки и ключ подписи, идентификатор конверта и расписание; каждый разрешается отдельно и по источникам.◇Щадящий режим — вторая личность очередиОчередь, которой приёмник начал отказывать, переключается на параллельный набор лимитов, повторов и маршрутов — десять директив, действующих только в этом режиме.◇Прогрев, встроенный в MTAПрогретый адрес отдаёт первые N писем дня каждому получателю своему холодному напарнику; тот отправляет их сам и набирает историю.

В Хабе
Цена ошибки
обратимо: вредит, пока стоит
Сценарии
Ротация адресов отправки
Важность
критично
Соседние настройки блока <virtual-mta>:smtp-source-hostdomain-keyproxy-include-tlvproxy-protocolinclude-headers-fromВсе 15 директив блока →