26.02.2026

Настройка 1С:Сервера взаимодействия с медиасервером Janus - для 8.5.1

Установка и первичная настройка серверных компонентов

Важно. Данный документ содержит тестовые учётные данные. Перед вводом системы в промышленную эксплуатацию замените все логины и пароли на безопасные значения.

Общие сведения

Состав разворачиваемых компонентов

В ходе установки разворачиваются следующие программные компоненты:

Используемые сетевые порты

Убедитесь, что указанные порты открыты в межсетевом экране.

Требования безопасности

• заменить все тестовые логины и пароли на надёжные значения;
• настроить HTTPS-доступ (обратный прокси-сервер, TLS-сертификаты);
• вынести СУБД и объектное хранилище на отдельные серверы;
• ограничить сетевой доступ к служебным портам (межсетевой экран, ACL).

1. Установка Java 11 (AxiomJDK)

Установка среды выполнения Java 11 необходима для работы Java-компонентов Системы взаимодействия (Hazelcast, Elasticsearch, CS).

Порядок выполнения

Шаг 1. Установите пакет AxiomJDK:

rpm -i axiomjdk-jre-pro11.0.28+12-linux-amd64.rpm

Шаг 2. Определите путь к установленной Java:

readlink $(readlink $(which java))

Ожидаемый результат:

/usr/lib/jvm/axiomjdk-java11-pro-runtime.x86_64/bin/java

Шаг 3. Создайте профиль окружения для переменной JAVA_HOME:

tee /etc/profile.d/java.sh << 'EOF' export JAVA_HOME=/usr/lib/jvm/axiomjdk-java11-pro-runtime.x86_64 export PATH=$JAVA_HOME/bin:$PATH EOF chmod +x /etc/profile.d/java.sh source /etc/profile.d/java.sh

Шаг 4. Перезагрузите сервер:

reboot

2. Установка ECS (компоненты Системы взаимодействия)

На данном этапе устанавливается дистрибутив ECS, включающий утилиту ring и базовые компоненты: Hazelcast, Elasticsearch, CS.

Порядок выполнения

Шаг 1. Распакуйте архив дистрибутива:

tar -xzf 1c-cs-30.0.32-linux-x86_64.tar.gz

Шаг 2. Перейдите в каталог дистрибутива и запустите установку:

./1ce-installer-cli install --ignore-signature-warnings

Ожидаемое сообщение:

Установка продукта завершена успешно.

sed -i 's/^SELINUX=.*/SELINUX=permissive/' /etc/selinux/config reboot

3. Установка PostgreSQL 15

PostgreSQL используется для хранения данных Системы взаимодействия.

Порядок выполнения

Шаг 1. Получите серверные пакеты для установки. Сборку PostgreSQL с патчем от 1С можно получить с ресурса https://releases.1c.ru/project/AddCompPostgre

Шаг 2. Установите серверные пакеты:

yum update -y yum install -y bzip2 mkdir -p "/tmp/postgresql-distrib-1c" tar --extract --directory "/tmp/postgresql-distrib-1c" --file ./postgresql-15.15-1-centos-7-x86_64-package.tar.bz2 yum install -y \ /tmp/postgresql-distrib-1c/postgresql15-15.15-1.1C.x86_64.rpm \ /tmp/postgresql-distrib-1c/postgresql15-contrib-15.15-1.1C.x86_64.rpm \ /tmp/postgresql-distrib-1c/postgresql15-libs-15.15-1.1C.x86_64.rpm \ /tmp/postgresql-distrib-1c/postgresql15-server-15.15-1.1C.x86_64.rpm

Команды для установки в вашей ОС опубликованы в файле «Поддерживаемые операционные системы и команды для установки дистрибутива».

Шаг 3. Инициализируйте кластер:

postgresql-15-setup initdb

Шаг 4. Включите автозапуск и запустите сервис:

systemctl enable postgresql-15.service --now

Шаг 5. Убедитесь, что PostgreSQL принимает подключения на порту 5432:

lsof -iTCP -sTCP:LISTEN -P | grep postgres

Ожидаемый результат:

postmaste 6572 postgres 6u IPv6 50128 0t0 TCP localhost:5432 (LISTEN) postmaste 6572 postgres 7u IPv4 50129 0t0 TCP localhost:5432 (LISTEN)

4. Базовая конфигурация компонентов 1С:Сервера системы взаимодействия (ECS)

На данном этапе создаются экземпляры компонентов, настраивается подключение к PostgreSQL и параметры WebSocket.

4.1. Создание экземпляра Hazelcast

Порядок выполнения

Шаг 1. Создайте пользователя и каталог:

useradd hc_user mkdir -p /var/cs/hc_instance chown hc_user:hc_user /var/cs/hc_instance

Шаг 2. Создайте экземпляр:

ring hazelcast instance create \ --dir /var/cs/hc_instance \ --owner hc_user

Шаг 3. Создайте systemd-сервис:

ring hazelcast --instance hc_instance service create \ --username hc_user \ --java-home $JAVA_HOME \ --stopped

4.2. Создание экземпляра Elasticsearch

Порядок выполнения

Шаг 1. Создайте пользователя и каталог:

useradd es_user mkdir -p /var/cs/es_instance chown es_user:es_user /var/cs/es_instance

Шаг 2. Создайте экземпляр:

ring elasticsearch instance create \ --dir /var/cs/es_instance \ --owner es_user

Шаг 3. Создайте сервис:

ring elasticsearch --instance es_instance service create \ --username es_user \ --java-home $JAVA_HOME \ --stopped

4.3. Создание экземпляра CS

Порядок выполнения

Шаг 1. Создайте пользователя и каталог:

useradd cs_user mkdir -p /var/cs/cs_instance chown cs_user:cs_user /var/cs/cs_instance

Шаг 2. Создайте экземпляр CS:

ring cs instance create \ --dir /var/cs/cs_instance \ --owner cs_user

Шаг 3. Создайте сервис:

ring cs --instance cs_instance service create \ --username cs_user \ --java-home $JAVA_HOME \ --stopped

4.4. Подготовка базы данных PostgreSQL

Порядок выполнения

Шаг 1. Перейдите в сессию postgres и запустите psql:

su - postgres psql

Шаг 2. Создайте пользователя, базу данных и расширение:

CREATE USER db_user WITH PASSWORD 'db_user_pwd' CREATEDB; CREATE DATABASE cs_db OWNER db_user; \c cs_db; CREATE EXTENSION IF NOT EXISTS "uuid-ossp";

Шаг 3. Завершите работу:

\q exit

4.5. Привязка CS к PostgreSQL (JDBC-пулы)

Порядок выполнения

Настройте параметры пула common:

ring cs --instance cs_instance jdbc pools --name common set-params \ --url "jdbc:postgresql://localhost:5432/cs_db?currentSchema=public" ring cs --instance cs_instance jdbc pools --name common set-params --username db_user ring cs --instance cs_instance jdbc pools --name common set-params --password db_user_pwd

Настройте параметры пула privileged:

ring cs --instance cs_instance jdbc pools --name privileged set-params \ --url "jdbc:postgresql://localhost:5432/cs_db?currentSchema=public" ring cs --instance cs_instance jdbc pools --name privileged set-params --username db_user ring cs --instance cs_instance jdbc pools --name privileged set-params --password db_user_pwd

4.6. Параметры WebSocket CS

Порядок выполнения

ring cs --instance cs_instance websocket set-params --hostname 0.0.0.0 ring cs --instance cs_instance websocket set-params --port 8086

5. Запуск сервисов и проверка

После создания экземпляров необходимо запустить все сервисы и проверить доступность портов.

5.1. Запуск Hazelcast

ring hazelcast --instance hc_instance service start

Проверка:

lsof -iTCP -sTCP:LISTEN -P | grep hc_user

Ожидаемый результат (порт 5701):

launcher 867 hc_user 17u IPv6 23694 0t0 TCP *:5701 (LISTEN)

5.2. Запуск Elasticsearch

ring elasticsearch --instance es_instance service start

Проверка:

lsof -iTCP -sTCP:LISTEN -P | grep es_user

Ожидаемый результат (порты 9200, 9300):

launcher 866 es_user 162u IPv6 27828 0t0 TCP localhost:9200 (LISTEN) launcher 866 es_user 135u IPv6 24300 0t0 TCP localhost:9300 (LISTEN)

5.3. Запуск CS

ring cs --instance cs_instance service start

Проверка:

lsof -iTCP -sTCP:LISTEN -P | grep cs_user

Ожидаемый результат (порты 8086, 8443, 8444):

launcher 2915 cs_user 482u IPv6 38441 0t0 TCP *:8086 (LISTEN) launcher 2915 cs_user 370u IPv6 38348 0t0 TCP *:8443 (LISTEN) launcher 2915 cs_user 375u IPv6 38352 0t0 TCP localhost:8444 (LISTEN)

6. Инициализация базы данных (REST API)

Регистрация основной базы данных в сервере взаимодействия выполняется через административный REST API.

Порядок выполнения

curl -Sf -X POST -H "Content-Type: application/json" \ -d '{ "url": "jdbc:postgresql://localhost:5432/cs_db", "username": "db_user", "password": "db_user_pwd", "enabled": true }' \ -u admin:admin http://localhost:8087/admin/bucket_server

Ожидаемый результат — JSON-ответ с параметрами зарегистрированной БД:

{"id":"1d17a146-...","url":"jdbc:postgresql://localhost:5432/cs_db", "username":"db_user","enabled":true,"deleted":false}

7. Настройка TURN/STUN сервера

ICE-сервер (TURN/STUN) необходим для обеспечения медиасоединений через NAT и межсетевые экраны.

Пример регистрации тестового сервера 1С

curl -Sf -X POST -H "Content-Type: application/json" \ -d '{ "url": "turn:stun-test.1cdialog.com:3478", "username": "video_module", "password": "SamplePassword", "enabled": true }' \ -u admin:admin http://localhost:8087/admin/bucket_server

8. Проверка общей работоспособности

Для проверки состояния всех компонентов используется эндпоинт /rs/health.

curl http://localhost:8087/rs/health

Пример ответа (до регистрации медиасервера):

{ "status": "UP", "mainDbOk": true, "allShardsOk": true, "hazelcast": {"available": true, "members": ["127.0.0.1:5701"]}, "elasticsearchOk": true, "mediaClusterOk": false, "pushOk": false }

9. Объектное хранилище S3 (MinIO)

MinIO обеспечивает S3-совместимое хранилище для файлов Системы взаимодействия.

9.1. Установка MinIO

Порядок выполнения

Шаг 1. Создайте пользователя и каталоги:

useradd minio_user mkdir -p /opt/minio /var/minio chown -R minio_user:minio_user /opt/minio /var/minio

Шаг 2. Скачайте и установите MinIO:

cd /opt/minio wget https://dl.min.io/server/minio/release/linux-amd64/minio chmod +x minio

Шаг 3. Создайте файл параметров окружения:

tee /etc/default/minio << 'EOF' MINIO_VOLUMES="/var/minio/" MINIO_ROOT_USER=minio MINIO_ROOT_PASSWORD=minio123 EOF

Шаг 4. Создайте systemd unit-файл:

tee /etc/systemd/system/minio.service << 'EOF' [Unit] Description=MinIO Documentation=https://docs.min.io Wants=network-online.target After=network-online.target AssertFileIsExecutable=/opt/minio/minio [Service] WorkingDirectory=/usr/local/ User=minio_user Group=minio_user EnvironmentFile=/etc/default/minio ExecStartPre=/bin/bash -c "if [ -z \"${MINIO_VOLUMES}\" ]; then echo \"Variable MINIO_VOLUMES not set\"; exit 1; fi" ExecStart=/opt/minio/minio server $MINIO_OPTS $MINIO_VOLUMES Restart=always LimitNOFILE=65536 TimeoutStopSec=infinity SendSIGKILL=no [Install] WantedBy=multi-user.target EOF

Шаг 5. Запустите сервис:

systemctl enable minio.service systemctl start minio.service journalctl -efu minio

9.2. Создание бакетов в MinIO

Порядок выполнения

Шаг 1. Откройте веб-интерфейс MinIO по адресу из журнала.

Шаг 2. Выполните вход (логин/пароль из /etc/default/minio).

Шаг 3. Создайте бакет с именем cs-bucket.

9.3. Регистрация хранилища в ECS

Замените 10.70.129.16 на внешний адрес вашего сервера MinIO:

curl -Sf -X POST -H 'Content-Type: application/json' \ -d '{ "apiType": "AMAZON", "storageType": "DEFAULT", "baseUrl": "http://10.70.129.16:9000", "containerUrl": "http://10.70.129.16:9000/cs-bucket", "containerName": "cs-bucket", "region": "eu-west-1", "accessKeyId": "minio", "secretKey": "minio123", "signatureVersion": "V2", "uploadLimit": 1073741824, "downloadLimit": 1073741824, "fileSizeLimit": 1073741824, "bytesToKeep": 0, "daysToKeep": 31, "pathStyleAccessEnabled": true }' \ -u admin:admin http://localhost:8087/admin/storage_server

9.4. Регистрация в информационной базе 1С:Предприятие

Для связи сервера взаимодействия с информационной базой используется обработка CollaborationSystemRegister.epf.

Порядок выполнения

Шаг 1. Скачайте обработку CollaborationSystemRegister.epf (версия 10.0.47 и выше).

Шаг 2. В клиенте 1С:Предприятие: Файл ? Открыть ? CollaborationSystemRegister.epf.

Шаг 3. Заполните поля формы:

Шаг 4. Нажмите кнопку Зарегистрировать.

• корректность регистрации S3-хранилища (раздел 9.3);
• доступность порта 8086 с клиентского компьютера.

10. Медиасервер Janus

Janus обеспечивает работу видеоконференций в Системе взаимодействия.

10.1. Установка Janus

Порядок выполнения

Шаг 1. Распакуйте дистрибутив janus-amd64-1.0.4.25.

Шаг 2. Ознакомьтесь с README.md.

Шаг 3. Запустите установку:

./install.sh

Проверьте порты:

lsof -iTCP -sTCP:LISTEN -P | grep janus

Ожидаемый результат:

janus 11064 root 8u IPv4 122113 0t0 TCP *:8188 (LISTEN) janus 11064 root 11u IPv4 122115 0t0 TCP localhost:7188 (LISTEN)

10.2. Регистрация Janus в ECS

Порядок выполнения

Замените 10.70.129.16 на адрес узла Janus (если ECS и Janus на одном хосте — допустимо 127.0.0.1):

curl -Sf -X POST -H 'Content-Type: application/json' \ -d '{ "url": "http://10.70.129.16:8188/janus/", "name": "Janus 1", "confereeLimit": 1000, "enabled": true }' \ -u admin:admin http://localhost:8087/admin/media_server

Проверьте через health-эндпоинт:

curl http://localhost:8087/rs/health

В ответе ожидается:

"mediaClusterOk": true "mediaServers": {"f2d9...": true}

10.3. Настройка параметров видеоконференций

Порядок выполнения

Шаг 1. Создайте конфигурационный файл video.yml:

tee /var/cs/cs_instance/config/video.yml << 'EOF' video: enabled: true conference-server-based-member-limit: 34 conference-server-based-threshold: 3 max-bandwidth: 2000 max-reference-width: 1280 max-reference-height: 720 max-reference-fps: 30 EOF

Описание параметров:

Шаг 2. Перезапустите CS:

ring cs --instance cs_instance service stop ring cs --instance cs_instance service start

10.4. Проверка соединений Janus

Порядок выполнения

Инициируйте видеозвонок с 3+ участниками и проверьте соединения:

netstat -antp | grep -i janus

Ожидаемый результат — наличие ESTABLISHED-соединений:

tcp 0 0 0.0.0.0:8188 0.0.0.0:* LISTEN 11064/./janus tcp 0 0 127.0.0.1:7188 0.0.0.0:* LISTEN 11064/./janus tcp 0 0 10.70.129.16:8188 10.70.129.16:59788 ESTABLISHED 11064/./janus

11. Подключение к установленному серверу взаимодействия

В том случае, если прикладное решение использует для своей работы сервер взаимодействия, развёрнутый самостоятельно (не сервис «1С:Диалог»), то для регистрации информационной базы в сервисе следует использовать не стандартную функцию Управление системой взаимодействия, а внешнюю обработку CollaborationSystemRegister.epf, которая поставляется вместе с сервером системы взаимодействия.

Значение поля Адрес сервера взаимодействия состоит из трёх частей:

• протокол: WS или WSS;
• адрес сервера;
• сетевой порт сервера.

Получить настройки конкретного экземпляра сервера взаимодействия (включая параметры подключения) можно с помощью команды:

ring cs --instance <cs_instance> websocket list-params

В данном примере:

• <cs_instance> — название экземпляра сервера взаимодействия.

Также параметры подключения можно получить в конфигурационном файле websocket.yml:

• Протокол определяется по значению параметра wss. Если этот параметр установлен в значение true — значит используется протокол WSS, в противном случае — протокол WS.
• Адрес сервера определяется по значению параметра hostname.
• Сетевой порт сервера определяется по значению параметра port.

Конфигурационный файл сервера взаимодействия расположен:

12. Подключение использования внешних пользователей

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

После установки администратор должен выполнить определённые настройки, чтобы включить возможность использования внешних пользователей.

Порядок выполнения

Шаг 1. После установки сайта перейдите в каталог сайта и внесите изменения в файл config.json. В этом файле необходимо указать адрес сервера взаимодействия, с которым будет взаимодействовать сайт для работы внешних пользователей. Адрес указывается в свойстве serverURL:

{ "serverURL": "wss://cs.host.com" }

В данном примере указан сервер взаимодействия, доступный по протоколу wss://cs.host.com с использованием стандартного сетевого порта.

Шаг 2. Настройте веб-сервер, с помощью которого будет осуществляться доступ к сайту. После настройки веб-сервера станет понятен адрес сайта для работы внешних пользователей. Допустим, адрес этого сайта https://host.com.

Шаг 3. Подключите сайт к системе взаимодействия, выполнив следующую команду:

ring cs --instance cs site set-params --public-url https://host.com

В данном примере выполняется подключение экземпляра сервера взаимодействия к ранее развёрнутому сайту для работы внешних пользователей. Указанный в команде адрес сайта будет использоваться в электронном письме, которое отправляется внешнему пользователю.