Demo
Demo
База знаний PMTA›Блок Global›Директива§ 3.3.1.47

use-proxy

Global

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

Строка называет список блоков <proxy>, через которые идёт отправка. Умолчания нет — без неё узел подключается к приёмникам сам.

🔴 Список строго запасной, а не балансирующий. Руководство говорит это дословно: второй прокси берётся, только когда соединение с первым не удалось, третий — когда не удались оба. Распределить нагрузку между прокси этой строкой нельзя.

Каждое имя обязано быть объявлено блоком <proxy> — иначе конфигурация не пройдёт проверку.

Несовместима с smtp-proxy-source-host — это второй способ настроить прокси, и вместе они не работают.

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

🔎 Запасного прокси у адреса отправки поэтому нет: раскладку трафика по прокси Хаб делает пулами наборов (proxy-pool-…), а не списком.

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

Список пишут в порядке предпочтения:

Значение Когда
не задавать (умолчание) узел выходит наружу сам
один прокси обычный случай
список нужен запасной на случай отказа
Порядок как строго запасной, требование объявить каждое имя блоком и несовместимость с smtp-proxy-source-host — из руководства (§ 3.3.1.47).
Пример в конфигурации
# список запасных, а не распределение: второй только при отказе первого
use-proxy mta-proxy-a, mta-proxy-b
Оба имени должны быть объявлены блоками <proxy> ниже или выше в файле.
жёлтым — — имена директив, голубым — блоки. Так же они подсвечены и в тексте карточки.
▲

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

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

Ждут распределения нагрузки по списку

наш опыт

Чем чреватоСписок строго запасной. Весь трафик идёт через первый прокси, пока он жив, и никакого разделения между ними не происходит.
Как заметитьНагрузка на первый прокси растёт, второй простаивает.
Как правильноРаспределять на стороне прокси либо разными списками у разных адресов отправки.
Совместимость
PowerMTA 6.0
описана в руководстве этой версии · платформа: любая
С какой версии директива доступна, вендор указывает не для всех — здесь пометки нет. Имя встречается и в издании руководства 5.0.
Справочные данные
Синтаксис
use-proxy PROXY-SERVER-LIST
Значения
имена блоков прокси через запятую
Применение
reload, перезапуск не нужен
Очередь
уже поставленное в очередь не затронет
Где писать
Global, <virtual-mta>
Сколько раз
один раз в блоке
Всё здесь — из руководства, с разделом.
Наследование
Строка пишется в корне файла, раздел Global, и достаётся всем адресам отправки, пока они не зададут своё. Самый точный уровень — одноимённая строка в самом блоке <proxy>.
⇄

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

3 связи

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

Прокси, через который узел выходит наружуКаждое имя из списка обязано быть объявлено таким блоком. § 3.3.1.47

Конфликтует

smtp-proxy-source-hostGlobalВторой способ настроить прокси; вместе с этим списком он не работает. § 3.3.1.47

Работают в паре

proxy-protocolGlobalВерсия протокола, с которой узел пойдёт к прокси из этого списка. § 3.3.1.48

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

use-proxy<virtual-mta>Уровень выше: не заданный здесь, список берётся оттуда. § 3.3.1.47Именованный прокси и три уровня его настроекСтрока, которой объявленный блок и назначается адресам отправки. § 3.3.22retry-attempts<proxy>Число попыток, после которых очередь переходит к следующему прокси из того списка. § 3.3.22.5

Как проверить на узле
Через какой прокси ушло письмо, видно по столбцам прокси в учёте — сначала найти их номера:
head -1 "$(ls -t /var/log/pmta/acct-*.csv | head -1)" | tr -d '\r' | tr ',' '\n' | grep -n '^dlvProxy'
Номер строки — номер столбца: по нему строки разбирают, например cut -d, -f1,N. Пусто — поля dlvProxy… не выбраны в record-fields, и прокси в учёте не видны. Постоянная работа через второй прокси означает, что основной недоступен.
◇

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

3 статьи

◇Ограничения облакаОблака ограничивают исходящую почту через порт 25, пока не попросишь снять лимит, а их диапазоны адресов почтовики встречают с подозрением.◇Адрес отправки — из чего он складываетсяИменованный набор всего, что является свойством адреса: с какого IP уходит письмо, чем узел представляется, чем подписывает и как быстро шлёт.◇Именованный прокси и три уровня его настроекБлок несёт адрес прокси, внешний адрес отправки, версию протокола, тип поля и число попыток; первые две строки обязательны.

В Хабе
Цена ошибки
с перерывом: применение прерывает работу узла
Сценарии
Отправка через прокси
Соседние настройки блока Global:smtp-proxy-source-hostproxy-include-tlvproxy-protocolhost-namedomain-keyВсе 108 директив блока →