База знаний PMTA›Блок <domain>›Директива§ 3.3.10.87

max-smtp-out-per-source-ip

<domain>устарела

Устарела в пользу source-ip-max-smtp-out

в конфигурации это строкаmax-smtp-out-per-source-ipвнутри блока <domain>

Прежнее имя, оставленное только ради старых конфигураций

Руководство отводит этой строке две строчки: пометку «устарела» и отсылку к source-ip-max-smtp-out. Ни синтаксиса, ни умолчания, ни описания поведения там больше нет — вендор считает вопрос закрытым.

Что делать, если встретили её в конфигурации. Заменить на новое имя один в один: смысл тот же — потолок одновременных соединений к получателю с отдельного адреса отправки. Заодно проверить enable-source-ip-limits-on-sending-ip: он появился позже и решает, какой адрес при этом считается исходящим.

Оставлять как есть не стоит. Директива без описания в руководстве — это директива, поведение которой никто не обещает: в следующем издании она может просто перестать читаться, и узел откажется стартовать с непонятной строкой в конфигурации.

Главная ловушка. Строка не вызывает ошибки при проверке конфигурации и потому переживает переезды с версии на версию незамеченной. Ищется только поиском по имени — специально её никто не показывает.

Что делает Хаб. Не пишет и не будет: он вообще не разбирает лимиты по адресам, потому что у каждого адреса отправки ровно один исходящий адрес — smtp-source-host, а у адресов прокси-гейта smtp-proxy-source-host. Если строка нашлась на узле — она пришла из конфигурации, написанной до Хаба.

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

Рекомендуемых значений нет и быть не может. Единственное верное действие — замена на source-ip-max-smtp-out с сохранением прежнего числа, а дальше уже считать по правилам новой директивы.

Из руководства здесь только пометка об устаревании и имя замены; всё остальное — наше указание, что делать со строкой в унаследованной конфигурации.

Пример в конфигурации

# было — в конфигурации, доставшейся по наследству
<domain comcast.net>
    max-smtp-out-per-source-ip 1.2.3.4 10
</domain>

# стало
<domain comcast.net>
    source-ip-max-smtp-out 1.2.3.4 10</domain>

Замена дословная: маска и число переносятся как есть. Проверьте заодно переключатель — он появился позже и меняет то, какой адрес считается исходящим.

жёлтым — — имена директив, голубым — блоки. Так же они подсвечены и в тексте карточки.

▲

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

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

Оставляют строку, потому что она не мешает

§ 3.3.10.87

Чем чреватоКонфигурация принимается без ошибок, и строка живёт годами. Но руководство её больше не описывает: ни синтаксиса, ни умолчания, ни обещания, что следующая версия её прочитает.

Как заметитьПри обновлении MTA узел не стартует, и в файле ошибок старта — непонятная строка конфигурации.

Как правильноЗаменить на source-ip-max-smtp-out заранее, а не в момент обновления.

Совместимость

PowerMTA 6.0

описана в руководстве этой версии · платформа: любая

С какой версии директива доступна, вендор указывает не для всех — здесь пометки нет. Имя встречается и в издании руководства 5.0.

Справочные данные

Синтаксис: max-smtp-out-per-source-ip <cidr-and-limit>
Значения: руководство синтаксис не приводит — только пометку об устаревании
Применение: reload, перезапуск не нужен
Очередь: уже поставленное в очередь не затронет
Где писать: <domain>
Сколько раз: один раз в блоке

Всё здесь — из руководства, с разделом.

Наследование

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

⇄

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

1 связь

Чем заменена

source-ip-max-smtp-out<domain>Замена, которую называет само руководство: тот же смысл, новое имя. § 3.3.10.87

Как проверить на узле

Единственная нужная проверка — есть ли она в конфигурации узла вообще, вместе с подключаемыми файлами:

grep -rn max-smtp-out-per-source-ip /etc/pmta/

Пустой ответ — хорошо. Если строка нашлась, замените её на source-ip-max-smtp-out и перечитайте конфигурацию. Хаб такие строки не ищет: сверки конфигураций узлов с каталогом у него нет, а свою конфигурацию он перезаписывает целиком — после применения из Хаба строки на узле не останется.

◇

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

3 статьи

◇Принять, направить, доставитьПуть письма внутри узла: принять, решить куда, доставить — и между этими тремя шагами живут все настройки.◇Четыре типа значений, на которых написан весь конфигЛогическое, образец домена, регулярное выражение и промежуток времени — определены один раз в § 3.2 и дальше используются всеми директивами.◇Перезагрузка настроек против перезапуска службыКонфигурация читается при старте, дальше правки подхватываются командой перезагрузки — кроме тех директив, которые руководство помечает как требующие перезапуска.

В Хабе

Цена ошибки: безопасно: неверное значение ничего не ломает
Сценарии: Жизненный цикл конфигурации

Соседние настройки блока <domain>:max-smtp-out max-msg-rate max-connect-rate backoff-max-smtp-out backoff-max-msg-rate Все 135 директив блока →