Адреса, которые есть на машине

/getlocalips
Не те, что в конфигурации, а те, что на самом деле

Перечисляет IP-адреса, которые сейчас назначены самой машине.

Вызов — GET /getlocalips. Параметра формата руководство для этой точки не показывает — в примере её открывают браузером.

Адреса отправки привязываются к IP; эта выдача показывает, какие из них на узле действительно есть. Адрес в smtp-source-host, которого на машине нет, — частая причина того, что адрес отправки не работает.

Доступ решает http-access по адресу, откуда пришёл запрос, — для чтения хватает уровня monitor. Ключ из http-api-key в заголовке X-API-Key даёт полный доступ с любого адреса.

Главная ловушка — принять список за адреса, видные миру. Точка отвечает, какие адреса назначены машине. За трансляцией адресов у хостера на интерфейсе стоит внутренний адрес, и именно его знает MTA — внешний в ответ не попадёт.
Что делает Хаб. Не спрашивает: адреса узла он читает по SSH командой системы — при подключении узла, после добавления адреса и по кнопке обновления списка в карточке узла.
Рекомендуемые значения

О чём спрашивать эту точку:

Вопрос Она ли
какие адреса назначены машине да
есть ли на машине адрес из smtp-source-host да — сверкой с ответом
какие адреса видит мир нет — это вопрос сети хостера
Адрес вызова — из руководства (§ 5.12). Разграничение вопросов и сверка с адресами отправки — наши.
Пример в конфигурации
# адреса машины
curl -s 'http://127.0.0.1:8080/getlocalips'
Ответ сверяют с адресами в строках smtp-source-host: адрес, которого нет на машине, отправку с него не даст.
жёлтым — — имена директив, голубым — блоки. Так же они подсвечены и в тексте карточки.
Совместимость
PowerMTA 6.0
описана в руководстве этой версии · платформа: любая
С какой версии директива доступна, вендор указывает не для всех — здесь пометки нет. Имя встречается и в издании руководства 5.0.
Как проверить на узле
Сравнить ответ с тем, что видит система:
curl -s 'http://127.0.0.1:8080/getlocalips'
ip -o addr show scope global | awk '{print $4}'
Второй список — взгляд самой системы. Адрес из конфигурации, которого нет ни там, ни там, — лишний.
В Хабе
Цена ошибки
безопасно: неверное значение ничего не ломает
Сценарии
Ротация адресов отправки · Подготовить узел к отправке