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

rewrite-list

<virtual-mta-pool>

Список правил переписывания, общий для адресов пула
в конфигурации это строкаrewrite-listвнутри блока <virtual-mta-pool>
То же имя ещё 1:<virtual-mta><virtual-mta-pool>— часть из них другие настройки, часть та же самая
Одни правила переписывания на всю группу

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

Смысл записи здесь один — не повторять. Волна адресов, которая обязана переписывать обратный адрес одинаково, описывается одной строкой вместо повторения у каждого.

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

И то же замечание, что у определения: руководство подключает список к <source>, и в парке это правильнее — обратный адрес зависит от домена отправки, а не от того, каким адресом узла письмо ушло.

Главная ловушка — ждать сложения. Собственная строка участника заменяет пуловую целиком. Добавив адресу «свой» список, вы молча отключаете для него общий — и обнаруживается это по обратным адресам в учёте, а не по ошибке в конфигурации.
Что делает Хаб. Не пишет: список подключается к источникам, как советует руководство. Строка при этом — очередной пример того, ради чего пул стоит использовать как область: сегодня общие настройки Хаб повторяет каждому адресу отправки отдельно.
Рекомендуемые значения

Значение — имя объявленного списка, как и у адреса отправки. Решается здесь одно — где держать правила:

Где Кому достаётся Осторожно
в пуле всем участникам своя строка участника заменит целиком
у участника только ему пуловая для него перестаёт действовать
в <source> всей подаче, до выбора потока применяется раньше и независимо
Наследование участниками — из руководства (§ 3.3.13). Правило «заменяет, а не дополняет» — общее для наследования директив.
Пример в конфигурации
# одинаковое переписывание на всю волну адресов
<virtual-mta-pool warmup-wave-3>
    rewrite-list abc    virtual-mta mta1
    virtual-mta mta2
</virtual-mta-pool>
Оба участника получат список abc. Появится у mta1 собственная строка — пуловая для него перестанет действовать целиком, а не дополнится.
жёлтым — — имена директив, голубым — блоки. Так же они подсвечены и в тексте карточки.
▲

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

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

Добавляют участнику свой список поверх пулового

§ 3.3.13

Чем чреватоСтрока участника заменяет пуловую целиком. Общие правила для этого адреса перестают применяться, и обратный адрес уходит не тот.
Как заметитьОдин адрес группы отправляет с другим обратным адресом.
Как правильноПеречислять у участника все нужные правила в одном списке — списки при наследовании не складываются.

Настраивают переписывание здесь при уже настроенном в источнике

§ 3.3.18

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

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

2 связи

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

rewrite-list<virtual-mta>Определение руководство даёт для адреса отправки; здесь — только то, что меняет запись на уровне пула. § 3.3.12.13

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

Группа адресов отправки с долями трафикаОдна из директив, записываемых на уровне пула; собственная строка участника её перекрывает. § 3.3.13.7

Как проверить на узле
Что действует у участника, видно по обратному адресу в учёте:
pmtaacctfind --output csv[orig,vmta,rcpt] /var/log/pmta/acct-*.csv | head -20
Если у одного участника обратный адрес не такой, как у остальных, у него своя строка — она заменила пуловую. Искать надо в блоке самого адреса отправки.
◇

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

3 статьи

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

В Хабе
Цена ошибки
обратимо: вредит, пока стоит
Сценарии
Ротация адресов отправки
Соседние настройки блока <virtual-mta-pool>:virtual-mtadomain-keymax-smtp-msg-ratemax-smtp-outsuppression-listsВсе 9 директив блока →