- 03.04.2025
- MailerQ
Конфиг MailerQ: config.json, или config.txt ?
В MailerQ исторически использовались два формата конфигурации:
config.json
(JSON-формат) - современный вариант, поддерживаемый в актуальных версиях MailerQ.config.txt
(текстовый формат с ключ=значение) - устаревший, но до сих пор встречающийся в документации и legacy-системах.
Почему рекомендуется config.json
?
Актуальность: Начиная с версии 5.0, MailerQ рекомендует JSON-формат как основной.
Гибкость: JSON позволяет:
Вложенные структуры (например, настройки DKIM внутри
"dkim": {}
).Комментарии (через
"$comment"
поля, хотя не все парсеры их поддерживают).Поддержка сложных типов данных (массивы IP-адресов, объекты правил роутинга).
Документация: Официальная документация MailerQ сейчас ориентирована на JSON.
Когда использовать config.txt
?
Устаревшие системы: Если вы используете MailerQ версии ниже 5.0.
Простота: Для базовых сценариев, где не нужна сложная конфигурация.
Совместимость: Некоторые плагины или инструменты могут ожидать
config.txt
.
Сравнение форматов
1. config.json
(рекомендуемый)

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


Какой формат конфигурации MailerQ выбрать?
Для новых проектов — однозначно
config.json
.Для старых систем — можно остаться на
config.txt
, но стоит планировать миграцию.Если критичен backward compatibility — проверьте, какие форматы поддерживает ваша версия MailerQ.
Пример гибридной настройки
Если у вас уже есть config.txt
(как в вашем примере), но нужно добавить JSON-функции:
Основные параметры оставьте в
config.txt
.Для сложных правил (роутинг, IP-пулы) создайте
routing.json
и подключите его через:

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