Конфигурация MailerQ: config.json, или config.txt ?

Конфигурация MailerQ: config.json, или config.txt ?

Конфиг MailerQ: config.json, или config.txt ?

В MailerQ исторически использовались два формата конфигурации:

  1. config.json (JSON-формат) - современный вариант, поддерживаемый в актуальных версиях MailerQ.

  2. config.txt (текстовый формат с ключ=значение) - устаревший, но до сих пор встречающийся в документации и legacy-системах.


Почему рекомендуется config.json ?

  1. Актуальность: Начиная с версии 5.0, MailerQ рекомендует JSON-формат как основной.

  2. Гибкость: JSON позволяет:

    • Вложенные структуры (например, настройки DKIM внутри "dkim": {}).

    • Комментарии (через "$comment" поля, хотя не все парсеры их поддерживают).

    • Поддержка сложных типов данных (массивы IP-адресов, объекты правил роутинга).

  3. Документация: Официальная документация MailerQ сейчас ориентирована на JSON.


Когда использовать config.txt ?

  1. Устаревшие системы: Если вы используете MailerQ версии ниже 5.0.

  2. Простота: Для базовых сценариев, где не нужна сложная конфигурация.

  3. Совместимость: Некоторые плагины или инструменты могут ожидать config.txt.


Сравнение форматов

1. config.json (рекомендуемый)

Конфигурация MailerQ

2. config.txt (устаревший)

Конфигурация MailerQ

Какой формат конфигурации MailerQ выбрать?

  • Для новых проектов — однозначно config.json.

  • Для старых систем — можно остаться на config.txt, но стоит планировать миграцию.

  • Если критичен backward compatibility — проверьте, какие форматы поддерживает ваша версия MailerQ.


Пример гибридной настройки

Если у вас уже есть config.txt (как в вашем примере), но нужно добавить JSON-функции:

  1. Основные параметры оставьте в config.txt.

  2. Для сложных правил (роутинг, IP-пулы) создайте routing.json и подключите его через:

Важно!

  • MailerQ может читать оба формата одновременно, но приоритет зависит от версии.

  • В вашем примере config.txt корректный, но для современных возможностей (например, ClickHouse-интеграция) JSON удобнее.

MailerQ 5.14.4 в курсе НР 2025