Перейти к основному контенту

Изменение ролей и конфигурации узла

  1. Нажмите по плитке узла, затем откройте редактирование.
  2. Укажите:
    • Название (или оставьте автоматическое).
    • Роли — отметьте нужные чекбоксами (веб-интерфейс — обязательно).
    • Вес в группе — вес узла при распределении данных.
    • Лимиты — Соединения и задачи (поля max_connections, max_tasks).
    • Размещение слушателей — для каждой включённой listener-роли задаются IP и порт:
      • IMAP IP / порт (роль IMAP);
      • SMTP IP / порт / сети (роль SMTP; сети — разрешённые CIDR для приёма, например 0.0.0.0/0, 10.0.0.0/8);
      • Веб (WUI) IP / порт (роль веб-интерфейса);
      • Хранилище IP / порт (роль хранилища).
  3. Нажмите [Сохранить] (или [Отмена]).

Порты слушателей: приоритет источников

Порт каждой listener-роли (IMAP, SMTP, веб, хранилище) задаётся отдельно для каждого узла. При разрешении порта источники проверяются по приоритету (от высокого к низкому):

  1. ENV — переменная окружения KLVD_*_LISTEN_PORT (KLVD_IMAP_LISTEN_PORT, KLVD_SMTP_LISTEN_PORT, KLVD_WEB_LISTEN_PORT, KLVD_STORAGE_LISTEN_PORT), заданная в настройках запуска (.env / docker-compose / k8s). Это deployment-уровневое переопределение.
  2. Значение узла — порт, сохранённый в «Размещении слушателей» (поля выше).
  3. Стандарт — 25 (SMTP), 993 (IMAP), 8001 (веб), 8444 (хранилище).

Если задана ENV-переменная порта, она перекрывает сохранённое значение узла. В интерфейсе это показано индикатором: «Сохранён <порт>, но используется из ENV (<значение>) пока не убран override». Чтобы вступило значение узла, удалите ENV-переменную из настроек запуска и перезапустите узел.

Миграция при обновлении

При обновлении версии порты слушателей переносятся в настройки каждого узла автоматически: если порт не был задан явно, он берётся из стандарта (25/993/8001/8444) и сохраняется в размещении узла. Прежние глобальные значения портов (config.settings smtp_listen_port/ imap_listen_port) больше не используются — порт настраивается только per-node (через WUI) либо через ENV (deployment-override). Существующие узлы продолжают работать без перенастройки.

Смена ролей, веса, лимитов, а также IP и портов слушателей применяются автоматически (в течение ~15 секунд, без перезапуска узла): роль-менеджер останавливает и перезапускает соответствующий слушатель. Переименование узла применяется сразу. Смена TLS-сертификата веб-интерфейса вызывает краткий перезапуск интерфейса.

Смена порта хранилища вызывает краткий (~секунда) перезапуск роли хранилища и обновление его URL в кластере (другие узлы увидят новый адрес).

При попытке выключить роль «Хранилище» на узле, остановка которого нарушит требуемую избыточность группы хранилищ, система откажется выполнять остановку. Это защищает от потери данных. См. {{ССЫЛКА:install.storage-overview|Установка → Хранилища и группы хранилищ}}.

Связанные материалы

  • {{ССЫЛКА:reference.roles|Роли узлов: справочник}}

Навигация по книге

  • Следующая статья: {{ССЫЛКА:maintenance.add-node|Добавление узла}}
Наверх