Порядок установки Системы on xFP

Алгоритм однонодовой установки

Mon, 01 Jan 0001 00:00:00 +0000

Предварительно необходимо выполнить подготовку к установке – см.раздел "Подготовка к установке".
Выполнить команду распаковки архива с дистрибутивом из каталога установки ${MPPATH} (обычно /home/multicheck)

Важно: X.Y.Z необходимо заменить на устанавливаемую версию (например: 2.0.0) (сверить с именем архива на узле)

Важно: распаковка должна выполняться из-под пользователя multicheck БЕЗ SUDO

tar -xvf 2.0.0-PROD-2026-02-18T08-21-22Z.tar.gz

Перейти в каталог ./mp-pack `cd mp-pack

Заполнить конфигурационный файл install.conf,

# Режим установки: "cluster" - кластерный, "single" - одиночный
`INSTALL_MODE="single"

# Номер текущего узла в кластере
NODE_NUMBER="1"

# IP-адреса узлов кластера. Можно добавлять NODE_4_IP, NODE_5_IP и т.д.

NODE_1_IP="" # при однонодовой установку можно оставить пустым
NODE_2_IP=""
NODE_3_IP=""

# Полное доменное имя (FQDN) Docker-реестра для образов приложений
REGISTRY_FQDN="multicheck.ngrsoftlab.ru"

# Имя пользователя для аутентификации в Docker-реестре
REGISTRYUSER="multicheck"

# Пароль для аутентификации в Docker-реестре
REGISTRYPSW="multicheck"

# Резервировать место для брокера: "true" - резервировать, "false" - не резервировать

Внимание: если false, убедитесь, что брокер имеет выделенное хранилище - подробнее см.раздел "Резервирование места для брокера"

RESERVE_BROKER="false"

Алгоритм установки cluster-node

Mon, 01 Jan 0001 00:00:00 +0000

Предварительно необходимо выполнить подготовку к установке – см.раздел "Подготовка к установке".
Выполнить команду распаковки архива с дистрибутивом из каталога установки ${MPPATH} (обычно /home/multicheck)

Важно: X.Y.Z необходимо заменить на устанавливаемую версию (например: 2.0.0) (сверить с именем архива на узле)

Важно: распаковка должна выполняться из-под пользователя multicheck БЕЗ SUDO

tar -xvf 2.0.0-PROD-2026-02-18T08-21-22Z.tar.gz

Перейти в каталог ./mp-pack

cd mp-pack

Заполнить конфигурационный файл install.conf, только на первом узле кластера, например:

Алгоритм установки YARA на узел с Системой

Mon, 01 Jan 0001 00:00:00 +0000

Распаковать архив

tar -xvf 2.0.0-YARA-2026-02-27T11-48-08Z.tar

Перейти в папку с компонентом: cd yara
При необходимости, изменить конфигурацию .env.sample:

COMPOSE_PROJECT_NAME=yara-analyzer
DPREGISTRY=registry.ngrsoftlab.ru:8882
DOCKER_SERVICE_REGISTRY=registry-int.ngrsoftlab.ru:8888
DOCKER_DEV_REGISTRY=registry-int.ngrsoftlab.ru:9999

# Note: When using network_mode host, replace 'mp_yara_storage' with the actual IP address or 'localhost'
# Example: STORAGE_ADDRESS=127.0.0.1:6379 or STORAGE_ADDRESS=<host_ip>:6379
STORAGE_ADDRESS=mp_yara_storage:6379 # Адрес для обращения к Valkey
STORAGE_USERNAME=analyzer # Пользователь Valkey
# should be the same password as users.acl list
# TODO: create and pass int a container acl file with password from env

STORAGE_PASSWORD=4nalyzerPassw0rd # Пароль для пользователя Valkey

GOLANG_VERSION=1.25.7

### Service config
### Empty MODE is production mode.
MODE=development # Режим работы mp_analyzer:
# production - default mode, a few logging
# development - verbose logging
# always_init - the same as development + always runs flush and re-init DB each time when service running.

PORT=8079 # Внутренний порт для mp_analyzer
HOST=0.0.0.0

APP_PATH=/yara_analyzer
RULES_PATH=/yara_analyzer/rules
CERTS_PATH=/yara_analyzer/certs
CA_CERT_FILENAME=ca.crt
CA_KEY_FILENAME=ca.key
DNS_NAMES=yara.multicheck.ru,mp_analyzer # Используется в качестве дополнительного SAN в сертификате TLS
IP_ADDRESSES=$\{MP_IP} # Заполняется автоматически адресом хоста, используется в качестве дополнительного SAN в сертификате TLS
FILE_BUFFER_SIZE=24
MAPPING_FILE_PATH=/yara_analyzer/rules/mapping_settings.json
MAX_ANALYSIS_LIMIT=5

Алгоритм установки YARA на отдельный узел

Mon, 01 Jan 0001 00:00:00 +0000

Пункты 1-3 аналогичны алгоритму для установки на узел с Системой – см. раздел выше.

tar -xvf 2.0.0-YARA-2026-02-27T11-48-08Z.tar

3.1. Необходимо или добавить сеть Docker для MP:

docker network inspect multicheck >/dev/null 2>&1 \|\| docker network create --driver bridge --subnet 172.25.0.0/16 --gateway 172.25.0.1 multicheck`

или использовать сеть хоста, поменяв yara-docker-compose.yaml: (добавить network_mode: "host", убрать networks: - multicheck)

services:
  mp_analyzer:
    image: $\{MPREGISTRY}/mp_analyzer:latest
    container_name: mp_analyzer
    restart: unless-stopped
    #ЗАКОММЕНТИРОВАТЬ ЗДЕСЬ
    #ports:
    #  - "8079:8079"
    #networks:
    #  - multicheck
    network_mode: "host" # РАСКОММЕНТИРОВАТЬ ЗДЕСЬ
    env_file:
      - .env
    volumes:
        - $\{MPPATH}/bin/certs/multicheck_ca/ca_key.key:/yara_analyzer/certs/ca.key
        - $\{MPPATH}/bin/certs/multicheck_ca/ca_certificate.pem:/yara_analyzer/certs/ca.crt
        - ./rules:/yara_analyzer/rules
    deploy:
      resources:
        limits:
          cpus: '4'
          memory: 4G

Алгоритм установки CDR на узел с Системой

Mon, 01 Jan 0001 00:00:00 +0000

Распаковать архив tar -xvf 2.0.0-CDR-2026-02-27T18-07-16Z.tar.gz
Перейти в папку с компонентом: cd cdr
При необходимости изменить конфигурацию .env.sample:

COMPOSE_PROJECT_NAME=scanner-converter

DOCKER_SERVICE_REGISTRY=registry-int.ngrsoftlab.ru:8888
DOCKER_DEV_REGISTRY=registry-int.ngrsoftlab.ru:9999

CONTAINER_BUILD_IMAGE_NAME=python:3.13-slim

GOLANG_VERSION=1.25.7

###
MPPATH=/converter
MPREGISTRY=""
### Service config

EXTERNALHOSTNAME=multicheck.ngrsoftlab.ru
# Используется в качестве дополнительного SAN в сертификате TLS
EXTERNALIP= # Используется в качестве дополнительного SAN в сертификате TLS

PORT=8081 # Внутренний порт для mp_cdr
HOST=0.0.0.0

CA_CERT_FILENAME=ca.crt
CA_KEY_FILENAME=ca.key
CERTS_PATH=/file-converter/certs

CDR_CONTAINER_NAME=mp_cdr
GOTENBERG_CONTAINER_NAME=mp_gotenberg
GOTENBERG_HOST=$\{GOTENBERG_CONTAINER_NAME}
GOTENBERG_PORT=3000
CDR_HOST=$\{CDR_CONTAINER_NAME}
CDR_PORT=4000
MAX_FILE_SIZE=2147483648

Запустить скрипт установки (БЕЗ SUDO): bash yara-install.sh

Алгоритм установки CDR на отдельный узел

Mon, 01 Jan 0001 00:00:00 +0000

Пункты 1-3 аналогичный установке CDR на узел с Системой – см.раздел "Алгоритм установки CDR на узел с Системой"

3.1. Необходимо или добавить сеть Docker:

docker network inspect multicheck >/dev/null 2>&1 \|\| docker network create --driver bridge --subnet 172.25.0.0/16 --gateway 172.25.0.1 multicheck

или использовать сеть хоста, поменяв cdr-docker-compose.yaml: (добавить network_mode: "host", убрать networks: - multicheck)

services:
  # Gotenberg container  
  mp_gotenberg:
    image: $\{MPREGISTRY}/mp_gotenberg:latest
    container_name: mp_gotenberg
    restart: unless-stopped
    command:
      - "gotenberg"
      - "--libreoffice-auto-start"
      - "--api-tls-cert-file=/file-converter/certs/gotenberg.crt"
      - "--api-tls-key-file=/file-converter/certs/gotenberg.key"
    volumes:
      - $\{MPPATH}/bin/certs/tls/cdr/gotenberg_certificate.crt:/file-converter/certs/gotenberg.crt
      - $\{MPPATH}/bin/certs/tls/cdr/gotenberg_private_key.key:/file-converter/certs/gotenberg.key
      - $\{MPPATH}/bin/certs/multicheck_ca/ca_certificate.pem:/etc/ca-certificates/multicheck_ca_certificate.pem
    #ЗАКОММЕНТИРОВАТЬ ЗДЕСЬ
    #networks:
    #  - multicheck
    network_mode: "host"
    deploy:
      resources:
        limits:
          cpus: '2'
          memory: 2048M
 
  # CDR container
  mp_cdr:
    image: $\{MPREGISTRY}/mp_cdr:latest
    container_name: mp_cdr
    environment:
      PORT: 4000
      DEBUG: "true"
    restart: unless-stopped
    volumes:
      - $\{MPPATH}/bin/certs/tls/cdr/cdr_certificate.crt:/app/certs/cdr.crt
      - $\{MPPATH}/bin/certs/tls/cdr/cdr_private_key.key:/app/certs/cdr.key
      - $\{MPPATH}/bin/certs/multicheck_ca/ca_certificate.pem:/etc/ca-certificates/multicheck_ca_certificate.pem
    command:
      - "python"
      - "main.py"
    #ЗАКОММЕНТИРОВАТЬ ЗДЕСЬ
    #networks:
    #  - multicheck
    network_mode: "host"
    deploy:
      resources:
        limits:
          cpus: '2'
          memory: 2048M
 
  # Proxy container
  mp_file_converter:
    image: $\{MPREGISTRY}/mp_scanner_converter:latest
    env_file:
      - .env
    container_name: mp_scanner_converter
    #ЗАКОММЕНТИРОВАТЬ ЗДЕСЬ
    #ports:
    #  - "8081:8081"
    restart: unless-stopped
    #networks:
    #  - multicheck
    volumes:
      - $\{MPPATH}/bin/certs/multicheck_ca/ca_key.key:/file-converter/certs/ca.key
      - $\{MPPATH}/bin/certs/multicheck_ca/ca_certificate.pem:/file-converter/certs/ca.crt
    deploy:
      resources:
        limits:
          cpus: '2'
          memory: 1024M
#ЗАКОММЕНТИРОВАТЬ ЗДЕСЬ
#networks:
#  multicheck:
#    name: multicheck
#    external: true

Резервирование места для хранилища файлов

Mon, 01 Jan 0001 00:00:00 +0000

Невозможно достоверно спрогнозировать, какой из ресурсов будет исчерпан ранее: основное дисковое пространство или зарезервированный объем для брокеров. Поэтому данное решение не рекомендуется к применению и реализовано только для возможности функционирования Системы при критической нехватке ресурсов.

Лучшим решением будет выделение отдельных виртуальных дисков в директории:

/home/multicheck/mp-pack/data/mp_broker1 /home/multicheck/mp-pack/data/mp_broker2 /home/multicheck/mp-pack/data/mp_broker3

Функция setup_broker() в скрипте инсталляции предоставляет возможность создать зарезервированное дисковое пространство для компонента mp_broker .

Брокер сообщений при нехватке дискового пространства начитает удалять данные для освобождения места благодарю включению механизма экстренной остановки, в ходе которой намеренно удаляются RAFT метаданные кластера.

Масштабирование storage

Mon, 01 Jan 0001 00:00:00 +0000

Важно: на текущий момент нет способа сохранить данные при переходе от одной конфигурации кластера к другой.

Поэтому рекомендуется изменить конфигурацию кластера хранилища файлов после установки Системы.

К примеру, рассмотрим кластер из 4 нод:

10.130.5.77
10.130.5.78
10.130.5.79
10.130.5.80

По умолчанию кластер хранилища файлов, установленный на первых трёх нодах, будет расширен до 4х.

Вводные параметры: * Пользователь multicheck * Папка установки = MPPATH = /home/multicheck/mp-pack * Известно, какой пароль для storage был введен на этапе установки платформы

Действия после установки

Mon, 01 Jan 0001 00:00:00 +0000

После однонодовой установки необходимо выполнить проверки, описанные в таблице ниже.

Проверка Пояснения

Проверка	Пояснения
Проверка наличия требуемых контейнеров	`docker ps -a #список контейнеров: mp_frontend mp_reporter mp_scanner mp_core mp_collector mp_broker_1 mp_broker_2 mp_broker_3 mp_broker_dashboard mp_storage registry-mp`
Проверка корректной конфигурации Системы	cat $\{MPPATH}/bin/secrets/.env ######################## MP_SECRET_KEYS=1:... # Не пустая BROKER_URL=10.130.5.77:4222 # Адрес, соответствующий текущему хосту BROKER_USER=multicheck BROKER_PASSWORD=1:... # Не пустая BROKER_USE_TLS=true STORAGE_BUCKET=multicheck-storage STORAGE_ENDPOINT=10.130.5.77:9000 # Адрес, соответствующий текущему хосту STORAGE_ACCESS_KEY_ID=multicheck STORAGE_SECRET=1:... # Не пустая INSTANCE_HOSTNAME=astra-1-8-tpl INSTANCE_ADDRESS=10.130.5.77 # Адрес, соответствующий текущему хосту #MP_SCANNER option TO_SCAN_WORKERS=5 #MP_REPORTER option SCAN_RESULTS_WORKERS=5 #MP_COLLECTOR option MAX_FILE_SIZE=2147483648

Проверка наличия требуемых контейнеров

docker ps -a
#список контейнеров:
mp_frontend
mp_reporter
mp_scanner
mp_core
mp_collector
mp_broker_1
mp_broker_2
mp_broker_3
mp_broker_dashboard
mp_storage
registry-mp

Проверка корректной конфигурации Системы

cat $\{MPPATH}/bin/secrets/.env
########################
MP_SECRET_KEYS=1:... # Не пустая
BROKER_URL=10.130.5.77:4222 # Адрес, соответствующий текущему хосту
BROKER_USER=multicheck
BROKER_PASSWORD=1:... # Не пустая
BROKER_USE_TLS=true

STORAGE_BUCKET=multicheck-storage
STORAGE_ENDPOINT=10.130.5.77:9000 # Адрес, соответствующий текущему хосту
STORAGE_ACCESS_KEY_ID=multicheck
STORAGE_SECRET=1:... # Не пустая

INSTANCE_HOSTNAME=astra-1-8-tpl
INSTANCE_ADDRESS=10.130.5.77 # Адрес, соответствующий текущему хосту

#MP_SCANNER option
TO_SCAN_WORKERS=5

#MP_REPORTER option
SCAN_RESULTS_WORKERS=5

#MP_COLLECTOR option
MAX_FILE_SIZE=2147483648