База знаний PMTA›Блок <smtp-listener>›Директива§ 3.3.17.17

inbound-proxy-timeout

<smtp-listener>

Сколько ждать заголовок балансировщика на входе почтовой подачи

в конфигурации это строкаinbound-proxy-timeout 5sвнутри блока <smtp-listener>

То же имя ещё 1:<smtp-listener><transmissions-api-listener>— часть из них другие настройки, часть та же самая

Терпение в начале соединения

Заголовок балансировщика должен прийти первым, до всего остального. Строка задаёт, сколько его ждать. Умолчание — 5s, и по истечении узел разрывает соединение.

Значение 0 равносильно never — то есть ждать сколько угодно. Это опасная настройка: подвисшее соединение будет держать слот приёма неограниченно долго.

Применима только вместе с use-inbound-proxy. Без него заголовка не ждут вовсе, и ждать нечего.

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

Главная ловушка — поставить ноль «чтобы не рвать соединения». Каждое зависшее подключение займёт слот приёма насовсем. При исчерпании слотов встанет вся подача, и связать это с настройкой ожидания будет непросто.

Что делает Хаб. Не пишет: балансировщика перед узлами нет.

🔎 Когда появится, умолчания хватит: заголовок приходит первым же пакетом, и пять секунд — уже с запасом.

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

Меньше значит быстрее отсекать чужих:

Значение	Когда
5s (умолчание)	всегда
1s	балансировщик в той же сети
0 или never	никогда: слоты приёма займутся навсегда

Умолчание 5s, равносильность нуля и never, разрыв соединения по истечении и условие «только при включённом приёме заголовка» — из руководства (§ 3.3.17.17).

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

# балансировщик в той же сети — секунды хватает
<smtp-listener 0/0:2525>
    use-inbound-proxy yes
    inbound-proxy-timeout 1s</smtp-listener>

Значение 0 здесь читается как «ждать вечно» и занимает слот приёма на каждом зависшем подключении.

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

▲

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

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

Ставят ноль, чтобы соединения не рвались

наш опыт

Чем чреватоНоль означает «ждать всегда». Каждое зависшее подключение занимает слот приёма навсегда, и при их исчерпании подача останавливается.

Как заметитьЧисло открытых входящих соединений растёт и не падает.

Как правильноВернуть конечное значение — пяти секунд хватает с запасом.

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

PowerMTA 6.0

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

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

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

Синтаксис: inbound-proxy-timeout <time-interval>
Значения: интервал времени либо never; 0 равносилен never
Умолчание: 5s § 3.3.17.17
Применение: reload, перезапуск не нужен
Очередь: уже поставленное в очередь не затронет
Где писать: <smtp-listener>
Сколько раз: один раз в блоке

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

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

Наследования нет: строка живёт внутри своего <smtp-listener>. Такая же строка есть у второго вида входа — входы разные, а не уровни одного.

⇄

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

2 связи

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

use-inbound-proxy<smtp-listener>Ожидание считается только тогда, когда приём заголовка вообще включён. § 3.3.17.17

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

smtp-listenerGlobalСтрока живёт внутри слушателя и касается соединений его адреса и порта. § 3.3.17.17

Сюда ссылаются

inbound-proxy-timeout<transmissions-api-listener>Одноимённая строка у слушателя почты; здесь она про отдельный вход, свой у API. § 3.3.21.14

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

Подключаемся и молчим — соединение должно закрыться по истечении:

time nc NODE 2525 </dev/null

Время до закрытия должно совпасть с заданным. Соединение, висящее дольше, означает либо ноль в значении, либо что приём заголовка выключен вовсе.

◇

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

3 статьи

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

В Хабе

Цена ошибки: обратимо: вредит, пока стоит
Сценарии: Безопасность узла · Подключить платформу отправки

Соседние настройки блока <smtp-listener>:use-inbound-proxy source tls-certificate await-slot immediate-tls Все 18 директив блока →