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

retain-x-virtual-mta

<source>

Оставлять ли обработанный заголовок X-Virtual-MTA в письме
в конфигурации это строкаretain-x-virtual-mta falseвнутри блока <source>
Снимать заголовок или оставить его получателю

Умолчание — false, то есть снимать. Заголовок сделал своё дело — выбрал поток — и дальше получателю не нужен.

Строка действует только в паре. Она имеет смысл лишь там, где process-x-virtual-mta стоит yes и заголовок в письме есть. Без обработки заголовок и так остаётся в письме, но по другой причине — его просто не читали.

Зачем вообще оставлять. Единственный практический повод — разбор по копии письма, снятой где-то ниже по пути: имя потока видно прямо в исходном коде. Плата за это — получатель тоже его видит.

Главная ловушка. Имена потоков в парке говорящие — домен, роль, номер адреса. Оставленный заголовок показывает получателю устройство инфраструктуры, ничего не давая взамен: для разбора то же имя уже лежит в учёте, в поле vmta.
Что делает Хаб. Не пишет — оставляет вендорское умолчание, то есть снимает. Имя потока по каждому письму Хаб и так получает из учёта, а показывать его получателю незачем. Заодно это согласуется с общим подходом рабочей конфигурации: служебные заголовки платформы снимаются, add-received-header выключен.
Рекомендуемые значения

Что ставить. Практически всегда умолчание:

Значение Когда
no (умолчание) всегда, если нет причины обратного
yes временно, на разборе, когда нужна копия письма с именем потока

Держать yes постоянно смысла нет: то же имя есть в учёте, и там его удобнее искать.

Умолчание false и условие «только при включённой обработке» — из руководства. Совет держать выключенным — наш.
Пример в конфигурации
# на время разбора: письмо доедет с именем потока в заголовке
<source 10.0.0.0/24>
    process-x-virtual-mta yes
    retain-x-virtual-mta yes</source>
Без строки process-x-virtual-mta эта не значит ничего. И это временная настройка: после разбора её возвращают к умолчанию, иначе имена потоков уезжают каждому получателю.
жёлтым — — имена директив, голубым — блоки. Так же они подсвечены и в тексте карточки.
▲

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

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

Оставляют включённым после разбора

§ 3.3.7.53

Чем чреватоКаждое письмо уносит получателю имя потока, которым оно ушло. Для парка с говорящими именами это описание внутренней структуры, выданное бесплатно.
Как заметитьВ исходном коде доставленного письма виден X-Virtual-MTA с понятным именем.
Как правильноВернуть умолчание. Для разбора пользоваться учётом — поле vmta есть у каждой записи и ищется быстрее.

Видят заголовок в письме и думают, что дело в этой строке

§ 3.3.7.52

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

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

2 связи

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

process-x-virtual-mta<source>Действует только там, где заголовок вообще обрабатывается и в письме присутствует. § 3.3.7.53

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

Заголовки, которыми отправитель управляет доставкойОдин из служебных заголовков подачи; у каждого своя пара «обрабатывать» и «оставлять». § 3.3.7.53

Как проверить на узле
Быстрее всего проверяется по самому письму — отправить на свой ящик и посмотреть исходный код. По конфигурации:
grep -n -B5 retain-x-virtual-mta /etc/pmta/config
Если строки нет вовсе, действует умолчание no и заголовок снимается. Если заголовок всё-таки виден в доставленном письме, а этой строки нет, — значит его не обрабатывали: проверьте process-x-virtual-mta.
◇

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

3 статьи

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

В Хабе
Цена ошибки
обратимо: вредит, пока стоит
Сценарии
Ротация адресов отправки · Подключить платформу отправки
Соседние настройки блока <source>:process-x-virtual-mtadefault-virtual-mtareject-invalid-virtual-mtaallow-empty-x-virtual-mtaretain-x-dkim-keyВсе 74 директив блока →