ONLYOFFICE¶

В этой статье:

• ONLYOFFICE. Основные возможности
• Особенности сборки
• Начало работы после развертывания OnlyOffice
• Доступ к веб-интерфейсу
• Настройка JWT-секрета
• Включение примеров для тестирования
• Заказ сервера с ONLYOFFICE с помощью API

ONLYOFFICE. Основные возможности¶

• Редактирование документов в реальном времени: полнофункциональные редакторы для DOCX, XLSX, PPTX с поддержкой совместной работы;
• Совместимость с форматами Microsoft Office: полная поддержка форматов MS Office, включая сложное форматирование;
• Совместная работа: одновременное редактирование документов несколькими пользователями с отслеживанием изменений;
• Встроенные комментарии и чат: инструменты для обсуждения документов прямо в интерфейсе редактора;
• Контроль версий: отслеживание истории изменений с возможностью возврата к предыдущим версиям;
• Плагины и интеграции: расширение функционала через плагины и интеграция с популярными системами хранения;
• Безопасность: поддержка JWT-токенов для защиты API и шифрование передачи данных;
• API для разработчиков: REST API для интеграции с собственными приложениями;
• Мобильная поддержка: адаптивный интерфейс для работы с планшетов и смартфонов.

Особенности сборки¶

• Контейнеризованное развертывание - система поставляется с Docker и предварительно настроенными контейнерами для быстрого запуска.
• Ключевые контейнеры:
  • onlyoffice-docs - основной контейнер ONLYOFFICE;
  • nginx-nginx-1 - веб-сервер Nginx с поддержкой SSL через Certbot (jonasal/nginx-certbot:latest).
• Сетевая конфигурация:
  • Внешние порты: 80 (HTTP), 443 (HTTPS);
  • Внутренний порт ONLYOFFICE: 8080 (проброшен на хост: 0.0.0.0:8080->80/tcp);
  • Автоматическое получение SSL-сертификатов через Let's Encrypt.
• Ключевые директории:
  • /etc/onlyoffice - конфигурационные файлы ONLYOFFICE внутри контейнера;
  • /var/lib/onlyoffice - данные приложения;
  • /var/log/onlyoffice - журналы работы системы;
  • /var/www/onlyoffice - корневая директория веб-приложения;
  • /var/www/onlyoffice/documentserver - основная директория Document Server.

Начало работы после развертывания ONLYOFFICE¶

После оплаты заказа на указанную при регистрации электронную почту придет уведомление о готовности сервера к работе. В нем будет указан IP-адрес VPS, а также логин и пароль для подключения. Управление оборудованием клиенты нашей компании осуществляют в панели управления серверами и API — Invapi.

Данные для авторизации можно найти во вкладке Информация → Тэги панели управления сервером или в присланном e-mail:

• Ссылка для доступа к панели управления ONLYOFFICE с веб-интерфейсом: в теге webpanel ;
• Логин и Пароль для управления сервером: приходят в письме на вашу электронную почту при сдаче сервера.

Доступ к веб-интерфейсу¶

Проверка работоспособности ONLYOFFICE¶

1. Откройте веб-браузер и перейдите по ссылке из тега webpanel;

2. Вы должны увидеть страницу приветствия ONLYOFFICE:

   

3. Для проверки работоспособности редакторов используйте встроенные примеры (см. раздел "Включение примеров для тестирования").

Проверка статуса служб¶

Для проверки статуса контейнеров выполните команду на сервере:

docker ps

CONTAINER ID   IMAGE                          STATUS        PORTS                    NAMES
527cd331a316   jonasal/nginx-certbot:latest   Up 19 hours                           nginx-nginx-1
e32700b1ac75   onlyoffice/documentserver      Up 19 hours   0.0.0.0:8080->80/tcp    onlyoffice-docs

Настройка JWT-секрета¶

Просмотр текущего JWT-секрета¶

JWT-секрет используется для защиты API Document Server. Для просмотра текущего значения:

sudo docker exec e32700b1ac75 /var/www/onlyoffice/documentserver/npm/json -f /etc/onlyoffice/documentserver/local.json 'services.CoAuthoring.secret.session.string'

По умолчанию установлено значение: change_me

Структура JWT-токенов¶

ONLYOFFICE использует три типа JWT-секретов для различных целей:

• secret.inbox.string - для входящих запросов от внешних систем к ONLYOFFICE;
• secret.outbox.string - для исходящих запросов от ONLYOFFICE к внешним системам;
• secret.session.string - для внутренних сессий и взаимодействия компонентов.

Изменение JWT-секретов¶

Для изменения JWT-секретов выполните следующие шаги:

1. Создайте резервную копию конфигурации:

docker exec onlyoffice-docs cp /etc/onlyoffice/documentserver/local.json /etc/onlyoffice/documentserver/local.json.backup

1. Войдите в контейнер OnlyOffice:

docker exec -it onlyoffice-docs /bin/bash

1. Отредактируйте конфигурационный файл:

nano /etc/onlyoffice/documentserver/local.json

1. Найдите секцию services.CoAuthoring.secret и измените значения:

"secret": {
  "inbox": {
    "string": "ваш_уникальный_секрет_для_входящих_запросов"
  },
  "outbox": {
    "string": "ваш_уникальный_секрет_для_исходящих_запросов"
  },
  "session": {
    "string": "ваш_уникальный_секрет_для_сессий"
  }
}

1. Сохраните файл и выйдите из редактора (Ctrl+X, затем Y, затем Enter);

2. Перезапустите контейнер для применения изменений:

docker restart onlyoffice-docs

1. Проверьте, что сервис запустился корректно:

docker logs onlyoffice-docs --tail 100

Включение примеров для тестирования¶

ONLYOFFICE включает встроенные примеры для тестирования редакторов документов. По умолчанию они отключены.

Активация примеров¶

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

Запуск службы примеров:

sudo docker exec e32700b1ac75 sudo supervisorctl start ds:example

Настройка автозапуска примеров при старте контейнера:

sudo docker exec e32700b1ac75 sudo sed 's,autostart=false,autostart=true,' -i /etc/supervisor/conf.d/ds-example.conf

После выполнения команд:

1. Откройте в браузере: https://ваш-домен/welcome/;
2. Вы увидите страницу с примерами редакторов;
3. Нажмите на любой тип документа для тестирования:
   • Document - для создания текстовых документов;
   • Spreadsheet - для создания электронных таблиц;
   • Presentation - для создания презентаций;
   • PDF form - для работы с PDF-формами.

Заказ сервера с ONLYOFFICE с помощью API¶

Для установки данного ПО с использованием API следуйте этой инструкции.