Demo
Demo
База знаний PMTA›Блок <source>›Директива§ 3.3.7.48

jobid-prefix

<source>

Приставка, дописываемая к метке задания из письма
в конфигурации это строкаjobid-prefixвнутри блока <source>
Чужие метки перестают сталкиваться с вашими

Директива дописывает своё значение спереди к метке задания, которую подающая сторона прислала в заголовке. Умолчания у неё нет: не написана — приставки не будет.

Отдельно назван зарезервированный вид приставки — {auth}. С ним приставкой становится логин, под которым письмо подали. Руководство приводит и случай, ради которого это сделано: служба ретрансляции так отличает почту каждого своего пользователя, ничего не требуя от самих пользователей.

Приставка имеет смысл только там, где метка вообще появляется, — то есть при разрешённом чтении заголовка: process-x-job.

Главная ловушка — без приставки метки разных отправителей столкнутся. Значение метки придумывает подающая сторона, а не вы. Два клиента, назвавшие рассылку одинаково — campaign1, test, 2026-08, — окажутся одним заданием: остановка одного остановит и другого, отбор покажет чужие письма.

Зарезервированное {auth} закрывает это без переговоров с клиентами, но работает только там, где подача идёт под логином. На источнике без авторизации подставлять нечего.

Что делает Хаб. Не пишет — приставке нечего дописывать: чтение заголовка задания запрещено во всех источниках подачи, метки не появляются.

Логины подачи Хаб при этом выдаёт по одному на пару «домен плюс адрес отправки», так что зарезервированное значение здесь пришлось бы точно в цель, если бы метки задания вообще использовались.

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

Что ставить. Выбор из двух родов значений:

Значение Когда
{auth} подача идёт под логинами, и разделить нужно по подающему
своя строка подача с одного логина, а разделить нужно по узлу, площадке или клиенту
не писать метки задания не используются вовсе

Строку стоит держать короткой: она приписывается к каждой метке, а по меткам потом отбирают вручную в командной строке.

Синтаксис, отсутствие умолчания и зарезервированное значение с подстановкой логина — из руководства, § 3.3.7.48. Совет про длину строки наш.
Пример в конфигурации
# приставкой становится логин, под которым письмо подали
<source 10.0.0.0/24>
    process-x-job true
    jobid-prefix {auth}</source>
Письмо, поданное пользователем shop со строкой «x-job: sale-08», получит метку, начинающуюся с этого логина. Отбор в очереди по нему покажет письма только этого клиента.
жёлтым — — имена директив, голубым — блоки. Так же они подсвечены и в тексте карточки.
▲

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

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

Ставят приставку без разрешения читать заголовок

§ 3.3.7.48

Чем чреватоМетка не появляется вовсе, и дописывать не к чему. Строка в конфигурации при этом выглядит работающей.
Как заметитьСписок заданий узла пуст, хотя приставка задана.
Как правильноВыдать разрешение читать заголовок в том же блоке источника.

Рассчитывают на подстановку логина там, где логина нет

§ 3.3.7.48

Чем чреватоЗарезервированное значение подставляет пользователя, под которым письмо подали. На источнике, где авторизация не требуется, подставлять нечего.
Как заметитьМетки заданий не отличаются друг от друга, хотя приставка задана зарезервированным значением.
Как правильноЛибо потребовать авторизации на этом источнике, либо задать приставку своей строкой.
Совместимость
PowerMTA 6.0
описана в руководстве этой версии · платформа: любая
С какой версии директива доступна, вендор указывает не для всех — здесь пометки нет. Имя встречается и в издании руководства 5.0.
Справочные данные
Синтаксис
jobid-prefix <string>
Значения
строка
Применение
reload, перезапуск не нужен
Очередь
уже поставленное в очередь не затронет
Где писать
<source>
Сколько раз
один раз в блоке
Всё здесь — из руководства, с разделом.
Наследование
Директива живёт в <source> и подчиняется слиянию источников: соединение попадает под все адресные блоки, которые его накрывают, и узкий перекрывает широкий. Приставка, заданная в широком блоке, достанется и всем узким, которые сами не назвали своей, — здесь это скорее полезно, чем нет.
⇄

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

2 связи

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

process-x-job<source>Без разрешения читать заголовок приписывать нечего. § 3.3.7.48

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

Заголовки, которыми отправитель управляет доставкойРаботает поверх метки, пришедшей одним из шести служебных заголовков. § 3.3.7.48

Как проверить на узле
Приставку видно в конфигурации, результат — в списке заданий:
grep -n 'jobid-prefix' /etc/pmta/config /etc/pmta/virtualhost.txt
pmta show jobs --maxitems=20
Имена в списке заданий должны начинаться с приставки. Если не начинаются — либо строка стоит не в том блоке источника, либо метка пришла не заголовком, а переменной слияния.
◇

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

3 статьи

◇Умолчание источника — нижняя ступень, привязанная к тому, кто подключаетсяБлок источника, совпавший с адресом отправителя, может назвать поток по умолчанию; он применяется, когда выше по лестнице выбор не сделан.◇Как письмо попадает в MTAШесть описанных способов подачи: расширенный SMTP, четыре языковые обвязки и каталог, за которым узел следит на диске.◇Лицензия на парк, а не на серверЛицензия не привязана к серверу: её ставят на столько машин, сколько разрешает предел экземпляров, а узлы раз в час отправляют вендору статистику объёма.

В Хабе
Цена ошибки
обратимо: вредит, пока стоит
Сценарии
Подключить платформу отправки · Разделение отправителей
Соседние настройки блока <source>:process-x-joballow-mailmergeadd-date-headeradd-message-id-headeradd-received-headerВсе 74 директив блока →