Онлайн-редактирование документов без внешнего облака: как мы подключили OnlyOffice к коробочному Битрикс24

В Битрикс24 документы можно открывать и редактировать прямо внутри портала: текстовые файлы, таблицы, презентации. Это удобно, пока офисный редактор работает стабильно. Но у коробочных порталов есть типовая проблема: редактирование документов часто зависит от внешнего сервиса, на который команда клиента не может повлиять.

Если облачный редактор перегружен, долго отвечает или временно недоступен, сотрудники не могут нормально работать с файлами. Документы лежат в портале, но открыть или отредактировать их быстро не получается. При использовании внешнего редактора документы передаются облачному сервису для обработки и покидают защищённый контур компании.
Альтернативой штатному редактору Битрикс24 могли бы стать Google Документы. Однако это не решило бы ключевую задачу проекта: файлы хранились бы и обрабатывались в облачной инфраструктуре Google, то есть также покидали бы корпоративный периметр.

Мы собрали решение на базе OnlyOffice: развернули сервер документов в инфраструктуре клиента и подключили его к коробочному Битрикс24 через модуль интеграции. Так работа с документами остается внутри портала, но сервер редактирования находится под контролем клиента.

Задача

Нужно было перенести обработку файлов из внешнего облачного редактора внутрь корпоративной инфраструктуры, развернуть там управляемый сервер документов и сохранить для сотрудников привычный сценарий работы с файлами непосредственно в коробочном Битрикс24.


Решение должно было:

• открывать документы, таблицы и презентации из Битрикс24;
• сохранять изменения обратно в портал;
• быть привычным для пользователей;
• работать в инфраструктуре клиента;
• подходить для закрытого контура;
• давать администраторам доступ к логам и настройкам сервера документов.

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

Решение

В коробочном Битрикс24 документы редактировались через Р7‑Офис, подключенный как внешний облачный сервис. При таком сценарии файлы передавались за пределы корпоративного контура. Мы заменили внешний редактор на OnlyOffice, развернули его в Docker внутри инфраструктуры клиента и подключили к Битрикс24 через модуль интеграции. Для сотрудников порядок работы не изменился: документы по-прежнему открываются, редактируются и сохраняются в Битрикс24.

Отдельное преимущество OnlyOffice в этом сценарии связано с лицензированием. У штатного редактора коробочного Битрикс24 количество одновременных сессий зависит от лицензии; для увеличения лимита приобретается платный буст «Онлайн-документы». Подключение собственного сервера Р7‑Офиса также потребует дополнительных затрат: отдельно оплачивается расширение «Р7‑коннектор» для Битрикс24 Enterprise и приобретается лицензия на серверную версию Р7‑Офиса.

OnlyOffice можно использовать в бесплатной редакции Community, распространяемой по лицензии GNU AGPL v3. При внутреннем развертывании коммерческой организацией отдельная коммерческая лицензия OnlyOffice не требуется — при условии соблюдения требований AGPL v3.

В результате решение получилось из двух частей:

• OnlyOffice, который отвечает за открытие и редактирование файлов;
• модуль в Битрикс24, который соединяет портал с сервером документов.

Для сотрудников сценарий работы не изменился. Они по-прежнему заходят в Битрикс24, открывают файл на диске, редактируют документ, таблицу или презентацию и сохраняют изменения обратно в портал. Изменилась только архитектура: вместо внешнего облачного редактора работает сервер документов внутри инфраструктуры клиента.

Локальный сервер документов

OnlyOffice можно развернуть на том же сервере, где работает Битрикс24, если нагрузка небольшая. Если сотрудники активно работают с файлами или в портале много одновременных редакторов, лучше выделить отдельную виртуальную машину.


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

Для закрытых контуров это особенно важно. Документы не нужно отправлять во внешний офисный сервис: редактирование происходит внутри инфраструктуры компании.

Модуль интеграции с Битрикс24

Второй частью стал модуль для коробочного Битрикс24. Он подключает портал к серверу OnlyOffice и позволяет использовать его как редактор документов внутри Битрикс24.

При переключении важно учитывать текущие сессии редактирования. Если сотрудники уже открыли файлы и вносят изменения, их нужно предупредить: сохранить документы и выйти из редактора. После переключения они снова открывают файлы из Битрикс24 и продолжают работать уже через OnlyOffice.

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

Что сделали

Мы заменили внешний облачный редактор Р7-Офиса на OnlyOffice, развёрнутый внутри инфраструктуры клиента, и подключили его к коробочному Битрикс24. Для сотрудников сценарий работы не изменился: документы по-прежнему открываются и сохраняются в Битрикс24.

В рамках проекта мы:

• развернули тестовый сервер OnlyOffice;
• проверили работу редактора с документами, таблицами и презентациями;
• подготовили модуль интеграции для коробочного Битрикс24;
• подключили сервер документов к порталу;
• проверили открытие и сохранение файлов;
• описали порядок переключения с внешнего редактора Р7-Офиса на OnlyOffice;
• собрали основу для повторяемого внедрения.

Результат

После подключения OnlyOffice обработка документов происходит внутри инфраструктуры компании и не зависит от внешнего облачного редактора.

Теперь компания может использовать собственный сервер документов: открывать и редактировать файлы внутри портала, обрабатывать документы в своем контуре и управлять состоянием сервиса через администраторов.

Для PWD это стало не разовой доработкой, а отдельным продуктовым сценарием для владельцев коробочного Битрикс24. Его можно внедрять там, где бизнесу важно контролировать работу с документами, снизить зависимость от внешнего облачного редактора и сохранить привычный пользовательский сценарий внутри портала.

Решение подходит именно для коробочного Битрикс24. Для облачной версии такой сценарий не применяется: там инфраструктура и подключение офисного редактора остаются на стороне Битрикс24.