cluster-addressкритичноПишет ХабдирективаАдрес AMQP брокера, через который узлы объявляют о себе и велят друг другу перечитать настройки; по умолчанию тот же брокер, что везёт почту.database-addressкритичноПишет ХабдирективаСтрока подключения к базе, где живут все рабочие настройки кластера: лимиты, ключи DKIM, пулы, паузы, подавления, правила переписывания и реакции на ответы.licenseкритичноПишет ХабдирективаПуть к файлу лицензии, без которого MTA не запускается.rabbitmq-addressкритичноПишет ХабдирективаАдрес AMQP брокера, который везёт почту: хост, учётные данные и виртуальный хост одной строкой.rabbitmq-failureкритичнодирективаКлюч маршрутизации, под которым публикуется окончательно провалившееся письмо со всей историей попыток.rabbitmq-outboxкритичноПишет ХабдирективаКлюч маршрутизации, с которым письмо публикуется к отправке, — и в родной конфигурации он же имя очереди, которую читает MTA.rabbitmq-persistentкритичноПишет ХабдирективаПишет ли брокер сообщения на диск, чтобы почта в очереди пережила его падение; по умолчанию выключено, и намеренно.rabbitmq-queueкритичноПишет ХабдирективаИмя очереди, из которой MailerQ читает сообщения; если не задано, MTA берёт очередь, названную в rabbitmq-outbox.rabbitmq-successкритичнодирективаКлюч маршрутизации, под которым публикуется результат каждой успешной доставки.send-logкритичнодирективаТекстовый журнал каждой попытки доставки — единственная запись о промежуточных попытках, которые в очереди результатов не попадают.smtp-authкритичноПишет ХабдирективаГде проверяются предъявленные учётные данные; стоит назвать здесь любую схему — и логин становится обязательным для всех клиентов.smtp-default-ipsкритичноПишет ХабдирективаСписок адресов, с которых уходит поданная почта, — и если он задан, то заменяет отображение приёма, а не подстраховывает его.smtp-extractкритичноПишет ХабдирективаПревращаются ли заголовки x-mq-* поданного письма в указания к доставке и снимаются ли перед отправкой.smtp-ipкритичноПишет ХабдирективаСписок локальных адресов через точку с запятой, на которых принимается почта, — и тем самым адресов, с которых она будет отправлена.smtp-mappable-ipsкритичноПишет ХабдирективаДиапазоны локальных адресов, для которых поданная на адрес почта с него же и отправляется.smtp-rangeкритичноПишет ХабдирективаДиапазоны адресов, которым разрешено открыть сессию SMTP; жёсткий заслон, срабатывающий раньше всего остального в разговоре.www-authкритичноПишет ХабдирективаГде проверяются входы в консоль; как и на стороне SMTP, принимается семь схем, и так же, как там, поставочное значение — пароль, который знают все.www-ipкритичноПишет ХабдирективаЛокальные адреса, на которых отдаётся консоль; в поставке — все адреса машины.application-logважнодирективаКуда MTA пишет о самом себе: запуск, соединения с базой и брокером, перечитывание настроек, падения.cluster-exchangeважноПишет ХабдирективаИмя веерного обмена, через который узлы объявляют о себе и ходят управляющие сообщения.database-ttlважноПишет ХабдирективаЧерез сколько секунд MTA перечитывает базу настроек; внутри этого окна он работает целиком из памяти и не обращается к базе на каждое письмо.dns-attemptsважноПишет ХабдирективаСколько раз повторяется запрос, прежде чем домен считается неразрешимым.dns-nameserverважноПишет ХабдирективаСерверы имён, которые опрашивает MTA, — поверх того, что написано в системных настройках резолвера.download-blacklistважноПишет ХабдирективаДиапазоны адресов, с которых MTA отказывается качать ресурсы, — защита от шаблона письма, тянущегося в локальную сеть.max-attemptsважноПишет ХабдирективаСколько попыток доставки письмо может израсходовать, прежде чем от него откажутся.max-delivertimeважноПишет ХабдирективаЧерез сколько секунд после приёма письмо бросают, сколько бы попыток ни осталось.rabbitmq-consumersважноПишет ХабдирективаСколько потоков параллельно читают очередь отправки.rabbitmq-declareважноПишет ХабдирективаОбъявляет ли MailerQ нужные ему очереди и обмены при старте — или ждёт, что они уже есть.rabbitmq-durableважноПишет ХабдирективаДолговечны ли объявленные MTA очереди и обмены, то есть пересоздаёт ли их брокер после перезапуска.rabbitmq-exchangeважноПишет ХабдирективаОбмен, в который попадает каждое публикуемое сообщение; пусто — значит обмен RabbitMQ по умолчанию, где ключ маршрутизации это просто имя очереди.rabbitmq-inboxважноПишет ХабдирективаКуда публикуется письмо, принятое встроенным сервером SMTP; в поставке указывает на очередь отправки, так что принятое сразу уходит.rabbitmq-qosважноПишет ХабдирективаСколько сообщений один поток-читатель может держать неподтверждёнными одновременно.render-enabledважноПишет ХабдирективаМожет ли консоль показывать полностью отрисованные письма из живого потока.retry-intervalважноПишет ХабдирективаСписок ожиданий между попытками через запятую: дважды по десять минут, дважды по полчаса, дважды по часу, дальше по два часа.send-log-formatважноПишет ХабдирективаШаблон строки отправки, с доступом к любому полю письма и результата и с условиями.server-idважноПишет ХабдирективаЧисло, которым обозначен узел; нужно, чтобы создаваемые идентификаторы писем не совпадали в пределах кластера.smtp-certificateважноПишет ХабдирективаСертификат, предъявляемый для STARTTLS на приёме; без него не предлагается ни TLS, ни AUTH.smtp-connections-outважноПишет ХабдирективаСколько соединений к принимающим серверам MTA может держать открытыми разом, по всем доменам.smtp-portважноПишет ХабдирективаПорт или порты, на которых принимается почта; STARTTLS доступен, если настроен сертификат.smtp-privatekeyважноПишет ХабдирективаПриватный ключ к сертификату приёма.www-certificateважноПишет ХабдирективаСертификат, предъявляемый на порту консоли с TLS.www-portважноПишет ХабдирективаПорт TCP, на котором отдаётся консоль управления, без шифрования.www-privatekeyважноПишет ХабдирективаПриватный ключ к сертификату консоли.www-secure-portважноПишет ХабдирективаПорт, на котором консоль отдаётся по HTTPS вместо обычного HTTP.delayed-durableдирективаОбъявляются ли очереди-ступени долговечными.delayed-queuesдирективаСколько ступеней задержки объявляется при старте; каждая ждёт вдвое дольше предыдущей, так что их число задаёт самое долгое ожидание.dns-capacityПишет ХабдирективаСколько операций DNS может выполняться одновременно.dns-intervalПишет ХабдирективаЧерез сколько секунд неотвеченный запрос отправляется снова.dns-min-ttlПишет ХабдирективаНижняя граница времени жизни в кэше: записи с меньшим TTL всё равно держатся столько, чтобы домены с очень коротким TTL не вынуждали делать запрос на каждое письмо.dns-rotateПишет ХабдирективаРаскладываются ли запросы по заданным серверам имён вместо того, чтобы всегда предпочитать первый.dns-timeoutПишет ХабдирективаСколько секунд резолвер ждёт ответа после последней попытки, прежде чем сдаться.heartbeat-enabledдирективаОтчитывается ли MTA вендору об использовании; документировано как включённое и как то, что платная лицензия может выключить.lockПишет ХабдирективаФайл с идентификатором процесса — чтобы два MTA не запустились разом.plugin-directoryдирективаКаталог библиотек, которые MTA подгружает при старте, давая своему коду на C место внутри пути доставки.rabbitmq-lazyПишет ХабдирективаОбъявляет очереди ленивыми, чтобы брокер сразу писал приходящие сообщения на диск, а не держал их в памяти.rabbitmq-localПишет ХабдирективаКуда публикуется входящая почта на адрес, перечисленный как локальный, вместо пересылки дальше.rabbitmq-maxpriorityПишет ХабдирективаСколько уровней приоритета поддерживает читаемая очередь; ноль означает, что приоритеты не используются вовсе.rabbitmq-publishersПишет ХабдирективаСколько потоков публикуют результаты обратно в брокер.rabbitmq-reportsПишет ХабдирективаКуда публикуются входящие сообщения, распознанные как отчёты: уведомления об отказах, отчёты DMARC.rabbitmq-retriesдирективаКлюч маршрутизации, под которым временно провалившееся письмо публикуется ждать следующей попытки.received-logдирективаТекстовый журнал писем, принятых встроенным сервером SMTP.render-useragentдирективаОграничивает предпросмотр браузерами с определённой строкой user-agent, чтобы случайный просмотр не портил статистику кампании.smarthostдирективаИмя сервера, которому отдаётся каждое письмо вместо почтового сервера получателя.smtp-checkПишет ХабдирективаКакие проверки проходит принятая почта: SPF, DKIM, DMARC и оценка на спам.smtp-connectionsПишет ХабдирективаВерхний предел на все соединения SMTP, которые держит MTA, входящие и исходящие вместе.smtp-connections-inПишет ХабдирективаСколько клиентов может быть подключено к приёму одновременно.smtp-hostnameПишет ХабдирективаИмя, которым сервер SMTP представляется в баннере, поверх системного имени хоста.smtp-passwordдирективаПринимается бинарником; напарник smtp-username, вытесненный директивой smtp-auth.smtp-protectionдирективаБлокирует ли приём адреса, ведущие себя назойливо, — например, с повторяющимися неудачными входами.smtp-sink-addressдирективаПеренаправляет соединение TCP каждой доставки на один адрес, а всё остальное в MTA ведёт себя так, будто почта идёт настоящему получателю.smtp-threadsПишет ХабдирективаСколько потоков обслуживают входящий трафик SMTP; каждый открывает свой сокет на каждый адрес.smtp-unmappable-ipsПишет ХабдирективаДиапазоны, вычитаемые из отображаемого набора, — по умолчанию петлевые и частные адреса.smtp-usernameдирективаПринимается бинарником; способ требовать логин из времён до 5.x, вытесненный директивой smtp-auth.smtp-validate-addressesдирективаНасколько строго поданные адреса конверта и получателя сверяются со стандартом.spool-directoryдирективаКаталог, за которым MTA следит в ожидании файлов писем: читает каждый и публикует заданием.storage-addressдирективаСтрока подключения к внешнему хранилищу тел писем, чтобы задание, идущее через брокер, несло только ключ.storage-ttlдирективаСколько секунд тело письма живёт в хранилище до истечения.strict-email-addressesдирективаОбязаны ли адреса строго соответствовать стандарту; замена в 5.16 задокументированным validate-envelope и validate-recipient.temporary-expiresдирективаВремя жизни временной очереди: по его истечении почта, придержанная лимитом или паузой, возвращается в очередь отправки.userПишет ХабдирективаСистемная учётная запись, под которую MTA переходит, заняв привилегированные порты.www-logдирективаТекстовый журнал обращений к консоли управления, вместе с тем, кто был авторизован.www-passwordдирективаПринимается бинарником, нигде не печатается, в родном конфиге отсутствует.www-samesiteдирективаПолитика SameSite для cookie сессии консоли.www-urlПишет ХабдирективаПолный адрес, по которому другие узлы кластера ссылаются на консоль этого узла; в справке отсутствует, а в родном конфиге есть.cluster-timeoutдирективаСколько узел ждёт ответа других узлов на своё объявление, прежде чем продолжить.cluster-verifyдирективаПроверяется ли сертификат TLS брокера, когда кластерный адрес использует amqps; отключение — способ принять самоподписанный сертификат.database-validateдирективаПроверяет ли MTA при старте, что схема базы соответствует ожидаемой версии.delayed-declareдирективаОбъявляет ли MTA очереди-ступени задержки при старте.delayed-exchangeдирективаОбмен, через который письмо кладётся на ступень задержки; по умолчанию тот же, куда идут результаты.delayed-lazyдирективаОбъявляет ступени ленивыми очередями, чтобы ждущие письма писались на диск.delayed-replytoдирективаОбмен, в который отложенное письмо возвращается по окончании ожидания.delayed-routingkeyдирективаКлюч маршрутизации, с которым письмо кладётся на лестницу задержек.delayed-typeдирективаОбъявляются ли ступени задержки обычными очередями или кворумными.dns-buffersizeПишет ХабдирективаРазмер буфера сокета для трафика DNS.dns-socketsПишет ХабдирективаПо скольким сокетам резолвер раскладывает свои запросы.download-bin-logдирективаКомпактная машинная копия журнала загрузок.download-cacheПишет ХабдирективаХранилище загруженных ресурсов, чтобы одна и та же картинка не качалась под каждое письмо.download-logдирективаТекстовый журнал ресурсов, которые MTA скачал из интернета, собирая письма.download-log-formatдирективаШаблон строки журнала загрузок; в поставке — время и адрес.download-proxyдирективаПрокси именно для загрузки ресурсов, отдельный от общего прокси MTA.download-ttlПишет ХабдирективаСколько секунд загруженный ресурс отдаётся из кэша, прежде чем качаться заново.download-user-agentдирективаСтрока user-agent, которой MTA представляется при загрузке ресурсов.download-whitelistдирективаДиапазоны адресов, с которых только и можно качать ресурсы; пусто — значит такого ограничения нет.dsn-advertiseПишет ХабдирективаОбъявляет ли встроенный сервер SMTP расширение DSN, позволяя подающему запрашивать уведомления по каждому письму.dsn-notifyПишет ХабдирективаСобытия, порождающие уведомление о доставке по умолчанию: никогда, при провале, при успехе, при задержке — или их сочетание.dsn-retПишет ХабдирективаНесёт ли уведомление всё исходное письмо или только его заголовки.envelopeдирективаЗадаёт обратный адрес письму, поданному из командной строки.extract-recipientsдирективаКогда бинарник работает утилитой командной строки — брать получателей из заголовков самого письма, а не из аргументов.ignore-dotдирективаСчитать концом письма конец ввода, а не одинокую точку, когда письмо читается со стандартного входа.message-tracingдирективаВключает подробное отслеживание того, что происходит с отдельными письмами.proxy-serverдирективаПрокси HTTP или SOCKS для собственных сетевых запросов MTA — не для доставки почты.rabbitmq-dsnдирективаКуда MailerQ публикует отказы, которые создаёт сам.rabbitmq-encodingПишет ХабдирективаСжимаются ли публикуемые MTA сообщения и чем именно.rabbitmq-flushдирективаСколько сообщений поднимается разом, когда MTA вычерпывает очередь.rabbitmq-minqosдирективаНаименьшее окно, до которого MTA сжимает выборку под нагрузкой.rabbitmq-refusedдирективаКуда публикуются сообщения, отвергнутые сервером SMTP, — если их вообще нужно сохранять.rabbitmq-throttleдирективаСколько сообщений можно писать в сокет брокера одновременно.rabbitmq-unroutableдирективаКуда попадает опубликованное сообщение, если обмену некуда его отправить.rabbitmq-verifyдирективаПроверяется ли сертификат TLS брокера, когда адрес использует amqps.received-bin-logдирективаКомпактная машинная копия журнала приёма.received-log-formatдирективаШаблон строк приёма: обращается прямо к JSON входящего письма и закрывает идентификатор условием.send-bin-logдирективаКомпактная машинная копия журнала отправок.smarthost-passwordдирективаПароль, предъявляемый промежуточному серверу.smarthost-portдирективаПорт для подключения к промежуточному серверу; по умолчанию обычный порт SMTP.smarthost-usernameдирективаЛогин, предъявляемый промежуточному серверу, если тот требует авторизации.smtp-auth-resultsПишет ХабдирективаЗаписываются ли вердикты smtp-check в заголовок Authentication-Results и для каких получателей.smtp-ciphersдирективаНабор шифров OpenSSL для приёма; в поставке уже стоит осторожный список.smtp-defaultipдирективаПринимается бинарником; вариант в единственном числе, недокументированный и отсутствующий в родном конфиге.smtp-defaultipsдирективаПринимается бинарником; ни справка его не печатает, ни родной конфиг не содержит.smtp-keyдирективаПринимается бинарником; документация вендора зовёт этим именем то, что справка называет smtp-privatekey.smtp-maxsizeПишет ХабдирективаНаибольший размер письма, которое примет приём; объявляется клиентам в приветствии SMTP.smtp-proxyдирективаДиапазоны адресов, чьи соединения начинаются заголовком PROXY с настоящим адресом клиента.smtp-secure-portдирективаПорт, где соединение зашифровано с самого начала, без перехода через STARTTLS.smtp-sink-ipдирективаПринимается бинарником; нигде не печатается и в родном конфиге отсутствует.smtp-sink-passwordдирективаПароль, предъявляемый ловушке.smtp-sink-portдирективаПорт для подключения к ловушке; при пустом значении документация называет 25.smtp-sink-usernameдирективаЛогин, предъявляемый ловушке, если она требует авторизации.smtp-timeoutдирективаСколько секунд приём ждёт от клиента хоть какого-то слова, прежде чем закрыть сессию.smtp-validate-addressдирективаПринимается бинарником; вендор документирует это написание, а справка печатает множественное число.spamassassin-hostдирективаАдрес демона SpamAssassin, оценивающего входящую почту; пусто — значит оценки нет.spamassassin-portдирективаПорт демона SpamAssassin; в поставке стандартный 783.spool-delayдирективаСколько секунд файл должен пролежать нетронутым, прежде чем его прочитают, — чтобы недописанные файлы не ушли в отправку.spool-extractдирективаПревращаются ли заголовки x-mq-* в файле каталога в указания к доставке.spool-fail-directoryдирективаКаталог, куда попадают файлы, которые MTA не смог разобрать.spool-open-filesдирективаСколько файлов каталога MTA держит открытыми одновременно.spool-removeдирективаУдаляется ли файл после того, как он опубликован.spool-threadsдирективаСколько потоков параллельно читают и публикуют файлы каталога.storage-policyдирективаКакие тела писем попадают во внешнее хранилище: исходящие, входящие, все или никакие.storage-rescheduleдирективаЧерез сколько секунд повторяется письмо, тело которого не удалось забрать.storage-threadsдирективаСколько соединений к хранилищу MTA держит для чтения и записи тел.storage-timeoutдирективаСколько секунд ждать тело от хранилища, прежде чем счесть попытку неудачной.temporary-declareдирективаОбъявляется ли обмен для временных очередей при старте.temporary-durableдирективаОбъявляется ли обмен для временных очередей долговечным.temporary-exchangeдирективаОбмен, к которому MTA привязывает каждую создаваемую временную очередь.temporary-typeдирективаОбъявляются ли временные очереди обычными или кворумными.validate-envelopeдирективаПринимается бинарником и документирована с умолчанием strict, но в этой сборке вытеснена директивой strict-email-addresses.validate-recipientдирективаБлизнец validate-envelope со стороны получателя, в том же вытесненном состоянии.www-bin-logдирективаКомпактная машинная копия журнала обращений к консоли.www-cache-controlдирективаЗначение заголовка Cache-Control для статических файлов консоли.www-ciphersдирективаНабор шифров OpenSSL для порта консоли с TLS.www-connectionsПишет ХабдирективаСколько соединений HTTP консоль держит одновременно.www-dirдирективаКаталог, из которого отдаются HTML, JavaScript и переводы консоли.www-hostдирективаИмя хоста, которое узел публикует для кластерных ссылок на консоль, если полный адрес не задан.www-log-formatдирективаШаблон строк журнала консоли: адрес клиента, время, учётная запись, прошедшая проверку, и сам запрос.www-management-onlyдирективаПринимается MTA, нигде не печатается и никакого наблюдаемого действия не даёт — записана как находка, а не как настройка.Что открывает консоль и чем она закрытакритичноПишет ХабмеханизмКонсоль умеет останавливать отправку, переписывать письма, читать их тела и менять любой предел — и по умолчанию доступна откуда угодно, без шифрования, за паролем, который сама же и показывает вошедшему.Почему письмо уходит с того адреса, на который пришлокритичноПишет ХабмеханизмПочта, поданная встроенному серверу SMTP, уходит с того адреса, на который её подали, — если только не задан список адресов по умолчанию, который отменяет это правило целиком.Как настройка доходит до работающего узлакритичноПишет ХабмеханизмНастройка MailerQ лежит в базе и доходит до узла одним из двух способов: тихо, когда истечёт кэш узла, или сразу, если кто-то опубликует сообщение перечитывания в кластерный обмен.Как MailerQ ждёт между попыткамиважномеханизмОжиданием между попытками занимается брокер, а не MTA: письмо публикуется в очередь, где сообщения истекают через заданное время, а истечение возвращает их в очередь отправки.Почему резолвер — вопрос доставки, а не инфраструктурыважноПишет ХабмеханизмНеудачный запрос DNS — это окончательно проваленное письмо, поэтому резолвер узла относится к доставляемости, а не к сантехнике.Язык шаблонов, общий для всех журналовважноПишет ХабмеханизмСтроки журнала собираются из шаблонов, у которых есть доступ к целым объектам по пути и есть условия, — так что журнал может нести всё, что содержит письмо или результат, включая наши собственные поля.Три предела, которые заканчивают недоставленное письмоважноПишет ХабмеханизмПисьмо перестают повторять, когда кончился список повторов, исчерпаны попытки или вышел срок, — и поставочные значения этих трёх не сходятся между собой.Откуда берутся имена очередей и что их наследуетважноПишет ХабмеханизмЧитаемая очередь берёт имя из rabbitmq-queue, а при его отсутствии — из rabbitmq-outbox, и по нему же названа вся лестница задержек.Куда уходит придержанная почта и почему важны их именаважномеханизмПочта, придержанная лимитом, флуд-шаблоном, паузой или грейлистингом, уходит в очередь, созданную на месте и названную по тому, что её держит.Трафик узла MailerQ, который не является почтоймеханизмКроме почты узел отчитывается вендору об использовании, может слать отчёты о падениях и качает ресурсы, на которые ссылаются письма, — три исходящих канала, о которых клиент вправе спросить.Три места, где может лежать тело письма, и цена каждогомеханизмТело письма едет внутри задания через брокер, либо лежит во внешнем хранилище под ключом, либо приходит файлом в отслеживаемый каталог — и каждый выбор переносит узкое место в другое место.purge-databaseкритичноключ запускаОпустошает управляющую базу и создаёт пустую схему заново: все лимиты, ключи DKIM, пулы, паузы и подавления исчезают.repair-databaseкритичноПишет Хабключ запускаСоздаёт недостающие таблицы, доводит существующую схему до ожидаемой версии и завершается.list-ipsключ запускаПечатает локальные адреса, доступные для отправки, и завершается.pausedключ запускаЗапускает MTA в состоянии паузы: подключён и настроен, но ничего не отправляет.config-fileключ запускаЧитает настройки из указанного файла вместо /etc/mailerq/config.txt.daemonключ запускаОтвязывает процесс от терминала.disable-crash-postключ запускаНе отправлять отчёты о падениях вендору, продолжая создавать их локально.disable-crash-reportключ запускаНе создавать отчёт о падении, когда MTA умирает неожиданно.fetch-licenseключ запускаЗабирает файл лицензии у вендора по идентификатору и завершается.