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

Введение и требования

Что такое САП "Клавдий"

САП «Клавдий» — система архивирования электронной почты. Она собирает письма из почтовых ящиков (через EWS, IMAP, приём SMTP-потока или импорт файлов PST/EML/MSG), сохраняет их в защищённом хранилище и обеспечивает быстрый полнотекстовый поиск по содержимому писем и вложений. Пользователи получают доступ к архиву через веб-интерфейс или привычную почтовую программу по протоколу IMAP.

Архитектура

Каждый Клавдий — это узел (или кластер узлов), который объединяет несколько служб:

Компонент Назначение
Веб-интерфейс (WUI) панель администрирования и пользовательский интерфейс; всегда включена
Служба импорта сбор писем из источников (EWS/IMAP/SMTP/API)
Хранилище физическое размещение тел писем и вложений с шифрованием и избыточностью
Индексатор полнотекстовый поиск (Solr) по письмам и вложениям, распознавание текста (OCR)
Сервер IMAP доступ пользователей к архиву из почтовых программ
Приёмник SMTP приём копии SMTP-трафика для архивации
Планировщик фоновые задачи: сбор, индексация, перебалансировка, очистка по сроку, оповещения

Узел работает с двумя внешними зависимостями:

  • PostgreSQL — база данных (метаданные писем, конфигурация, пользователи, задачи, аудит). Версия 14+.
  • Solr — поисковый индекс (полнотекстовый поиск по письмам и вложениям). Версия 9.x.

Оба компонента могут быть локальными (рядом с узлом, для одиночной установки) или внешними (для кластера).

Режимы установки

Режим Описание Когда применять
Сам по себе первый сервер «всё в одном»: узел + локальные PostgreSQL и Solr небольшое развёртывание, первое знакомство, тестовый стенд
Часть кластера новый узел подключается к существующему кластеру; PostgreSQL и Solr — внешние горизонтальное масштабирование
Kubernetes (Helm) узел в существующем k8s-кластере, внешние PostgreSQL и Solr развёртывание в контейнерной инфраструктуре

Системные требования

Для установки через docker-compose (Linux)

  • Операционная система: Ubuntu 22.04 LTS+ или Debian 12+ (другие дистрибутивы Linux — при наличии Docker).
  • Docker: устанавливается скриптом install.sh при необходимости.
  • Права: root (или sudo) для установки.
  • Сеть: доступ к registry-ru-2.afi-d.ru (образы) и static.afi-d.ru (артефакты установки). Для изолированных сетей — офлайн-режим (перенос образов на флешке).
  • Диск: зависит от объёма архива. Рекомендуется отдельный диск для данных хранилища писем и поискового индекса.

Рекомендуемые ресурсы (ориентировочно)

Объём архива RAM CPU Диск
до 100 тыс. писем 4 ГБ 2 ядра 50 ГБ
до 1 млн писем 8 ГБ 4 ядра 200 ГБ
свыше 1 млн 16+ ГБ 8+ ядер от 500 ГБ + отдельные узлы хранилища

Требования зависят от объёма вложений, включённого распознавания текста (OCR), числа источников и интенсивности поиска. Детальные рекомендации по подбору сервера под ожидаемый объём архива — см. 1b. Рекомендации по ресурсам (сайзинг). Для крупных развёртываний используйте кластер с разделением ролей по узлам.

Роли узла

Роль определяет, какие службы запустятся на узле. Роли задаются при установке (переменная KLVD_ROLES) и могут включаться и отключаться позже через панель управления.

Роль Служба
ui веб-интерфейс (включён принудительно, отключить нельзя)
storage хранилище писем
importer сбор писем из источников
indexer индексация и полнотекстовый поиск
imap сервер IMAP для доступа пользователей
smtp приёмник SMTP для архивации потока

На чистом узле слушатели IMAP и SMTP не запускаются автоматически — их включают в панели управления после настройки хранилища и безопасности. Это намеренно: слушатели принимают внешние подключения, и их не следует поднимать до готовности системы.

Дальнейшие шаги

Наверх