Это руководство объясняет управление квотами пользователей и просмотр статистики сервера с помощью команд madmail.
/admin/
— без командной строки.
Вы можете управлять квотами хранения пользователей с помощью подкоманд madmail imap-acct quota.
Отображение использованного пространства и максимального лимита для конкретного пользователя.
Установка пользовательского лимита хранения (например, 1GB, 500MB или 10KB).
Удаление пользовательской квоты и возврат к системному значению по умолчанию. Дата создания аккаунта сохраняется.
Установка лимита хранения по умолчанию для всех пользователей без пользовательской квоты. Значение сохраняется в базе данных и имеет приоритет над настройкой в madmail.conf.
Отображение всех пользователей с использованным пространством и лимитами квот. В списке указано, является ли квота пользователя пользовательской или унаследованной от системного значения по умолчанию.
Команды для управления нагрузкой сервера и освобождения пространства путём удаления данных пользователей.
Удаление всех ожидающих сообщений в очереди отправки, связанных с конкретным пользователем (отправитель или получатель). Полезно для устранения заторов очереди, вызванных спамом или большими сообщениями.
Удаление всех писем пользователя из всех почтовых ящиков (Входящие, Отправленные и т.д.) без удаления аккаунта или настроек квоты. Полезно для быстрого освобождения дискового пространства.
Удаление всех писем на всём сервере для всех пользователей. Все данные электронной почты удаляются, но аккаунты, пароли и квоты сохраняются.
Удаление всех писем, отмеченных как прочитанные (Seen), на всём сервере. Новые непрочитанные сообщения сохраняются. Помогает оптимизировать пространство без потери новых сообщений.
Удаление непрочитанных сообщений старше указанной продолжительности (например, 30 дней). Полезно для очистки старых писем, которые пользователь никогда не открывал.
Вы можете открыть или закрыть регистрацию новых пользователей. При закрытой регистрации только пользователи с существующими аккаунтами могут войти в систему.
JIT-регистрация позволяет серверу автоматически создавать аккаунты пользователей при первой попытке входа. Вы можете управлять этой функцией независимо от общей настройки регистрации.
При включении аккаунты автоматически создаются при первом входе или получении первого письма.
При отключении аккаунты можно создать только через API (веб-интерфейс), а вход с незарегистрированными учётными данными отклоняется.
madmail accounts)Эти подкоманды читают madmail.conf и обращаются напрямую к файлам базы на диске (останавливать сервер не нужно). Укажите --cfg-block и --storage-cfg-block, если блоки не local_authdb / local_mailboxes.
Создаёт пароль в БД учётных данных и почтовый ящик в хранилище (как случайный пользователь в веб-панели).
Удаляет пароль, очищает IMAP и добавляет адрес в чёрный список. У ban второй аргумент — необязательная причина.
Сервер держит копии учётных данных и квот в памяти. После изменения БД через CLI выполните один раз POST /admin/cache/reload (тот же admin-токен). Формат запроса — в документации Admin API.
Вы можете включить или отключить сервер вызовов (TURN) для всех пользователей. При отключении информация о вызовах не отображается на странице информации.
Вы можете включить или отключить ведение журнала сервера. При отключении информация о действиях пользователей не записывается.
Для конфиденциальности пользователей и предотвращения хранения информации о действиях.
Вы можете изменить язык веб-интерфейса. Поддерживаемые языки: английский (en), фарси (fa), русский (ru), испанский (es). Изменения вступают в силу немедленно без перезапуска.
Переключить сайт на другой язык.
Удалить переопределение из базы данных и вернуться к языку, настроенному в madmail.conf.
Порты и настройки сервисов (hostname, secret, relay IP и т.д.) можно управлять через Admin API. Эти настройки хранятся в базе данных и имеют приоритет над значениями файла конфигурации.
Для управления этими настройками используйте Admin API. Соответствующие конечные точки описаны в разделах «Настройки портов» и «Настройки конфигурации» документации API.
Сервер Madmail может работать в режиме скрытности для повышения безопасности. В этом режиме для внешнего мира остаются открытыми только необходимые порты.
Необходимые порты:
Остальные порты (25, 143, 587, 993) можно закрыть через файервол для публичного доступа. Пользователи подключаются ко всем сервисам через прокси Shadowsocks, настроенный в приложении, что скрывает ваш сервер от интернет-сканеров.
Admin API включён по умолчанию. Для полного отключения через файл конфигурации для повышения безопасности установите следующую опцию в madmail.conf в разделе chatmail.
Установите admin_token в значение disabled:
После сохранения файла перезапустите сервис madmail. Это отключит все функции веб-панели администратора и Admin API.
Внутренняя система DNS-кэша позволяет перенаправлять маршрутизацию исходящей почты на пользовательские серверы без изменения DNS-настроек ОС. Правила перезаписи хранятся в основной базе данных программы. Изменения вступают в силу немедленно без перезапуска сервера.
Отображение всех правил перезаписи DNS, хранящихся в базе данных.
Установка правила перезаписи DNS. Если правило для этого адреса уже существует, оно будет обновлено.
Примеры:
Отображение деталей правила перезаписи DNS, включая адрес источника, назначение, комментарии и время создания.
Удаление правила перезаписи DNS. После удаления письма будут маршрутизироваться через обычный DNS ОС.
Отображение общего использованного хранилища на сервере и количества активных аккаунтов.
Команда madmail status показывает состояние сервера в реальном времени. Включает активные IMAP-подключения, TURN-реле (голосовые/видеозвонки), Shadowsocks, зарегистрированных пользователей и время работы.
Отображение сводки состояния сервера, включая активные подключения, зарегистрированных пользователей, время загрузки и аптайм.
Пример вывода:
IMAP connections: 27 unique IPs: 7 TURN relays: 1 Shadowsocks connections: 0 unique IPs: 0 Registered users: 42 Boot time: 2026-02-16 20:56:19 (up 5m 24s) Email servers seen (since last restart): Connection IPs: 1 Domain servers: 1 IP servers: 0
Используйте флаг --details (или -d) для просмотра деталей подключений по каждому порту.
Пример вывода:
PORT PROTO TYPE CONNECTIONS UNIQUE IPs 993 tcp IMAP TLS 25 7 143 tcp IMAP 0 0 3478 udp TURN UDP 1 relays - 3478 tcp TURN TCP 0 0 8388 tcp Shadowsocks 0 0 443 tcp ALPN (chatmail) 3 1