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

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

САП «Клавдий» — система архивирования электронной почты. Она собирает письма из почтовых ящиков (через 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 не запускаются автоматически — их включают в панели управления после настройки хранилища и безопасности. Это намеренно: слушатели принимают внешние подключения, и их не следует поднимать до готовности системы.

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

• Установка узла — см. Установка узла.
• Развёртывание в Kubernetes — см. Развёртывание в Kubernetes.
• После установки — Первый вход и навигация, затем первичная настройка по порядку.