Требования для коробочного размещения
Коробочное решение MoodRec — это развёртывание сервиса в собственном контуре компании. Такой формат выбирают организации, которым по требованиям информационной безопасности, внутренним регламентам или политике хранения данных не подходит облачная версия. В этом случае все данные и вычисления остаются внутри инфраструктуры заказчика.
Ниже описаны необходимые требования для корректного размещения сервиса.
Требования к ПК пользователя
Операционные системы
- Windows Vista / 7 / 8 / 10 / 11
- macOS 10.5 – 11.x
- Linux (любая ОС семейства)
Браузеры
- Google Chrome 120+
- Firefox 115+
- Microsoft Edge 120+
- Opera 106+
Требования к оборудованию
Развёртывание возможно как в виртуальном, так и в физическом окружении.
| Ресурс | Минимальные требования | Рекомендуемые требования |
|---|---|---|
| Нагрузка | До 1 млн визитов/мес | До 5 млн визитов/мес |
| CPU | 6 выделенных ядер | 12 выделенных ядер |
| ОЗУ | 16 GB | 32 GB |
| Диск | 1 TB SSD | 2 TB SSD |
Рекомендуется использование серверных SSD/NVME-дисков.
Скорость записи: от 450 MB/s (SATA SSD) или от 1500 MB/s (NVME).
Требования к инфраструктуре
Публичные IP-адреса
Минимальная конфигурация — 1 публичный IP:
- Панель управления
- Публичный API
- Раздача SDK
Рекомендуемая конфигурация — 2 публичных IP:
- IP-1 (Admin/UI) — панель управления
- IP-2 (Public/API) — API (события, рекомендации, импорты)
Домен и SDK
SDK загружается с домена, где развернут MoodRec.
В панели проекта настраивается allowlist разрешённых доменов.
Allowlist используется для:
- проверки источника SDK
- применения CORS-политик
- предотвращения несанкционированного использования API
SSL и безопасность
Все публичные точки доступа должны работать по HTTPS.
Для публичного API используются API-ключи.
API-ключи применяются для:
- передачи событий
- запроса рекомендаций
- импорта каталога
- импорта аудиторий
При отсутствии корректного ключа запрос отклоняется.
Доступ к серверам лицензий
Для работы приложения необходимо обеспечить постоянный доступ к:
- lic1.altkraft.com:443 TCP
- lic2.altkraft.com:443 TCP
- lic3.altkraft.com:443 TCP
При отсутствии доступа:
- невозможно создавать новые плейсменты и кампании
- невозможно импортировать каталог и аудитории
- продвинутые AI-модели недоступны
- действующие кампании переходят на базовые алгоритмы
Требования к программному обеспечению
Поддерживаемые ОС сервера
- Ubuntu Server 18.04 LTS
- Ubuntu Server 20.04 LTS
- Ubuntu Server 22.04 LTS
- Ubuntu Server 24.04 LTS
Используемое ПО
| ПО | Версия |
|---|---|
| MongoDB | 8.0.17 LTS |
| ClickHouse | 25.8 Stable+ |
| RocksDB | 8.X+ |
| Apache Kafka | 3.7.X+ |
Требования к портам TCP/IP
| Описание | Порт | Доступ |
|---|---|---|
| Панель управления | 443 (HTTPS) | Публичный или через VPN |
| Публичный API | 443 (HTTPS) | Публичный |
| MongoDB | 27017 | Внутренняя сеть |
| ClickHouse | 9000 | Внутренняя сеть |
| Kafka | 9092, 9093 | Внутренняя сеть |
| RocksDB / Kvrocks | 6666 | Внутренняя сеть |
| Сервис каталога | 1111 | Внутренняя сеть |
| Сервис задач | 2222 | Внутренняя сеть |
| Сервис расчёта представлений | 3333 | Внутренняя сеть |
| Сервис векторного индекса | 4444 | Внутренняя сеть |
| Сервис рекомендаций | 5555 | Внутренняя сеть |
| Сервис аудиторий | 7777 | Внутренняя сеть |
| Сервис авторизации | 8888 | Внутренняя сеть |
| Сервис событий | 9999 | Внутренняя сеть |
| SMTP | 25 или 465 | Для отправки уведомлений |
Все порты могут быть переназначены.