Документооборот для BPMSoft

  1. Главная
  2. Документы
  3. Документооборот для BPMSoft
  4. Установка продукта Документооборот для BPMSoft
  5. Дополнительные подключения
  6. Онлайн-редакторы и хранилища файлов
  7. Прямое подключение ONLYOFFICE Docs

Прямое подключение ONLYOFFICE Docs

Подготовьте сервер и выберите версию

Для прямого подключения разверните ONLYOFFICE Docs. Сопоставьте версию Документооборота и его коннектора, платформу BPMSoft, редакцию и версию сервера документов по условиям поставки. Актуальные теги образа Community Edition доступны в официальном репозитории ONLYOFFICE Docs на Docker Hub. Выберите точный тег совместимой версии и, если требуется, лицензию для этой редакции. До установки уточните имя заголовка JWT и режим передачи токена, которые поддерживает коннектор.

На Linux-узле редактора нужны Docker Engine, плагин Docker Compose, OpenSSL, DNS-имя и сертификат TLS. Войдите под администратором узла. Команды Docker выполняйте из сеанса с разрешением управлять Docker. Проверьте доступность Compose командой docker compose version. Для существующего сервера сохраните его конфигурацию и данные перед изменением.

Создайте конфигурацию Compose

В терминале выполните команды. Они создают отдельный каталог и файл настроек, доступный владельцу. Пример рассчитан на новый каталог.

umask 077
mkdir -p "$HOME/onlyoffice-docs"
cd "$HOME/onlyoffice-docs"
touch .env
chmod 600 .env
openssl rand -hex 32

Последняя команда генерирует случайный общий секрет JWT. Сохраните его в защищённом хранилище и подставьте в файл .env. В JWT_HEADER задайте заголовок из профиля коннектора. В примере используется Authorization.

JWT_SECRET=REPLACE_WITH_GENERATED_SECRET
JWT_HEADER=Authorization
JWT_IN_BODY=false

В ONLYOFFICE Docs переменная JWT_IN_BODY задаёт передачу токена в теле запроса. Для согласованного профиля с передачей в заголовке укажите false, для профиля с передачей в теле — true. Проверьте также соответствие входящих, исходящих и браузерных токенов коннектору.

В том же каталоге сохраните следующий текст в compose.yaml. В строке image указан пример с опубликованным тегом Community Edition. Перед запуском сверьте тег с версией, согласованной для вашего коннектора. Если в поставке указана другая редакция, замените имя образа целиком. Параметры JWT берутся из .env. Именованные тома сохраняют данные при пересоздании контейнера. Локальный порт 8081 оставляет доступ к HTTP на узле редактора для обратного прокси.

services:
  documents:
    image: onlyoffice/documentserver:10.0.0
    restart: unless-stopped
    ports:
      - "127.0.0.1:8081:80"
    environment:
      JWT_ENABLED: "true"
      JWT_SECRET: "${JWT_SECRET:?Укажите секрет JWT}"
      JWT_HEADER: "${JWT_HEADER:?Укажите заголовок JWT}"
      JWT_IN_BODY: "${JWT_IN_BODY:?Укажите режим JWT}"
    volumes:
      - logs:/var/log/onlyoffice
      - data:/var/www/onlyoffice/Data
      - state:/var/lib/onlyoffice
      - database:/var/lib/postgresql

volumes:
  logs:
  data:
  state:
  database:

Запустите сервер и опубликуйте HTTPS

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

docker compose config --quiet
docker compose pull
docker compose up -d
docker compose ps

В закрытом контуре вместо docker compose pull загрузите согласованный архив образа командой docker load -i /path/to/document-server-image.tar. Проверьте, что имя и тег загруженного образа совпадают со строкой image в compose.yaml, затем выполните docker compose up -d --pull never. Если сервис завершился, посмотрите последние сообщения командой docker compose logs --tail=100 documents. Если редакция требует лицензию, примените её в соответствии с комплектом поставки до приёмки.

Настройте публикацию редактора по HTTPS. На сервере BPMSoft и с рабочего места откройте https://office.example.org/web-apps/apps/api/documents/api.js. Замените имя на фактическое. Должен загрузиться JavaScript без ошибки сертификата или перенаправления на страницу входа. Из контейнера редактора проверьте разрешение имени BPMSoft и доверие сертификату. Если сервер документов ограничивает обращения к частным адресам, согласуйте адрес BPMSoft с политикой конкретной редакции и ограничьте исходящие подключения редактора нужными узлами. Для внутреннего центра сертификации настройте доверие в контейнере так, чтобы оно сохранялось при пересоздании.

Подключите BPMSoft

В Дизайнере системы → Системные настройки найдите настройки по коду.

Код Значение
OnlyOfficeServerUrl Корневой HTTPS-адрес редактора, например https://office.example.org.
OnlyOfficeJwtToken Общий секрет JWT_SECRET из конфигурации сервера документов.
OnlineEditService OnlyOffice. Выберите после сохранения адреса и секрета.

Проверьте обмен по сетевой схеме. Браузер загружает интерфейс редактора. Сервер документов получает исходник из BPMSoft и отправляет запрос сохранения. BPMSoft скачивает результат и записывает версию вложения. Адреса исходника и обратного вызова должны быть доступны из контейнера по DNS и HTTPS. Используйте предусмотренные поставкой обработчики с проверкой запросов.

Проверьте сохранение и перезапуск

Выполните проверку контрольного файла. Если редактор не открывается, проверьте HTTPS, JavaScript и WebSocket. Если исходник не загружается, проверьте доступ из контейнера к BPMSoft и способ авторизации запроса. Если новая версия не появляется, проверьте завершение всех сеансов, приём обратного вызова и доступ BPMSoft к адресу результата.

После согласованного пересоздания контейнера повторите проверку. Сохраните в защищённой резервной копии конфигурацию, секрет, доверенные сертификаты и данные томов. Для применения изменённых переменных выполните docker compose up -d. Команда docker compose restart перезапускает существующий контейнер с прежним окружением.

Для коннектора с обработчиком ONLYOFFICE после обработки обратного вызова ожидается JSON {"error":0}. При ответе HTML проверьте, что запрос дошёл до обработчика BPMSoft, а не до страницы входа. В стандартном цикле статус 2 означает готовность файла к сохранению после завершения сеанса. Поддержку промежуточного сохранения со статусом 6 определяет коннектор. При проверке ориентируйтесь на появление версии в BPMSoft.

Был ли данный материал полезен вам? Да Нет