command
<domain>
Работает у очереди вида pipe (type) и для неё обязательна. Задаёт командную строку, которой узел запускает программу-обработчик; письмо подаётся ей на стандартный вход. Запуск происходит на каждого нового получателя.
В строке раскрываются подстановки со свойствами письма: $envid — идентификатор конверта, $user — имя получателя до собаки (а если в нём есть + — часть слева от него), $domain — его домен, $from и $to — адреса конверта, $isodate, $ctime, $rfctime, $timet — время в четырёх видах, $bodytype — вид тела письма.
Обратная косая черта удваивается. Она же служит для экранирования пробелов, кавычек и знака доллара, поэтому путь в стиле Windows пишется через двойные слэши — или через обычные прямые, их MTA тоже принимает.
Каждую подстановку — в двойные кавычки. Это единственная защита от пробела в адресе.
Программа должна стартовать быстро. Она запускается на каждого получателя; полсекунды старта при тысяче писем в минуту — это уже нагрузка на узел, а не на почту.
Путь пишите абсолютным. Узел запускает программу не из вашего окружения, и относительный путь работает не так, как в оболочке.
# обработчик отказов: идентификатор конверта и имя получателя <domain bounces.example.com> type pipe command "/opt/bounce/parse --envid \"$envid\" \"$user\""</domain>
▲
Типичные ошибки и проблемы
что делают не так и чем это кончается3 ошибки▶
Пишут подстановки без кавычек
§ 3.3.10.111.1
Задают относительный путь к программе
наш опыт
Берут тяжёлый обработчик под поток
§ 11.21
- Синтаксис
- command <string>
- Значения
- полная командная строка запуска программы в кавычках; допускаются подстановки $envid, $user, $domain, $from, $to, $isodate, $ctime, $rfctime, $timet, $bodytype
- Применение
- reload, перезапуск не нужен
- Очередь
- уже поставленное в очередь не затронет
- Где писать
- <domain>
- Сколько раз
- один раз в блоке
Связанные директивы
1 связь
pmta show settings bounces.example.com/vmta1 | grep -E '^type|^command' pmta show queues | grep -i bounces.example.com
Что ещё почитать
3 статьи
◇Как письмо попадает в MTAШесть описанных способов подачи: расширенный SMTP, четыре языковые обвязки и каталог, за которым узел следит на диске.◇Кому разрешено сдавать почту и для кого её приниматьИз коробки узел принимает подачу только с самой машины; два разных вопроса — «кто может слать через нас» и «на чьи адреса мы принимаем» — решаются разными директивами.◇Заголовки, которыми отправитель управляет доставкойШесть служебных заголовков позволяют подающей стороне выбрать поток, пометить письмо заданием, задать настройки и ключ подписи, идентификатор конверта и расписание; каждый разрешается отдельно и по источникам.
- Цена ошибки
- опасно: последствия переживут откат
- Сценарии
- Подключить платформу отправки