Установка ONLYOFFICE Docs чаще всего начинается с выбора метода развёртывания: контейнер Docker или нативные пакеты deb/rpm — и именно неправильный выбор на этом этапе приводит к ошибкам вроде недоступности редактора по адресу сервера или сбоям при интеграции с Nextcloud. Прежде чем выполнять какие-либо команды, проверьте, что сервер соответствует минимальным требованиям: 64-битная система Linux, не менее 2 ГБ оперативной памяти (лучше 4 ГБ и больше), двухъядерный процессор и около 40 ГБ свободного места на диске.
В этой статье разберём проверенные способы установки ONLYOFFICE Docs (также известного как Document Server), настройку HTTPS, подключение к облачным хранилищам и решение типовых проблем. Инструкции ориентированы на актуальные стабильные версии, но перед продакшн-развёртыванием сверяйтесь с официальной документацией — отдельные параметры могут меняться от версии к версии.
Системные требования и подготовка сервера
ONLYOFFICE Docs — серверное приложение, и его устанавливают на выделенную машину или виртуальный сервер с Linux. Официально поддерживаются Ubuntu, Debian, CentOS и совместимые дистрибутивы, а также возможна установка на Windows Server.
Рекомендуемая конфигурация для комфортной работы небольшой команды:
- 🖥️ Процессор: 2 ядра и выше, архитектура x86-64;
- 💾 Оперативная память: минимум 2 ГБ, рекомендуется 4–8 ГБ;
- 📦 Диск: от 40 ГБ свободного места с запасом под документы и логи;
- 🌐 Сеть: статический IP или доменное имя, открытые порты 80 и 443.
Дополнительно потребуется swap-файл не менее 4 ГБ, если оперативной памяти мало — без него сервисы могут аварийно завершаться при пиковой нагрузке. Также убедитесь, что на сервере не заняты порты 80 и 443 другими приложениями: проверить это можно командой ss -tlnp.
⚠️ Внимание: установка ONLYOFFICE Docs на тот же сервер, где уже работает веб-приложение на портах 80/443 (например, Nextcloud с Apache), приведёт к конфликту. Либо выносите Docs на отдельную машину, либо настраивайте reverse proxy с другими портами.
Установка через Docker — самый простой способ
Развёртывание в контейнере Docker считается самым быстрым и воспроизводимым методом: все зависимости уже упакованы в образ, и вам не нужно вручную ставить PostgreSQL, RabbitMQ и NGINX.
Если Docker ещё не установлен, установите его по официальной инструкции для вашего дистрибутива. Затем запустите контейнер с Document Server:
sudo docker run -i -t -d -p 80:80 --restart=always \
-e JWT_ENABLED=true \
-e JWT_SECRET=ваш_секретный_ключ \
onlyoffice/documentserver
Разберём ключевые параметры команды:
- 🚀
-p 80:80— проброс порта, через который будет доступен редактор; - 🔑
JWT_SECRET— секретный ключ для подписи запросов, обязательно задайте свой сложный ключ; - 🔄
--restart=always— автоматический перезапуск контейнера после перезагрузки сервера; - 💽 Для сохранения данных вне контейнера добавьте монтирование томов
-vдля логов, данных и базы.
☑️ Проверка после установки Docker-версии
Через пару минут после запуска откройте в браузере http://адрес_сервера — должна появиться страница приветствия ONLYOFFICE Docs со статусом работоспособности. Если страница не открывается, посмотрите логи: sudo docker logs .
Установка из пакетов deb и rpm
Для тех, кто предпочитает классическую установку без контейнеров, ONLYOFFICE предоставляет репозитории с пакетами. На Ubuntu/Debian процесс выглядит так: добавляется GPG-ключ и репозиторий, после чего пакет ставится через apt.
sudo apt update
sudo apt install onlyoffice-documentserver
Во время установки скрипт предложит настроить подключение к PostgreSQL (потребуется задать пароль базы данных) и автоматически поднимет необходимые сервисы: NGINX, RabbitMQ и сам Document Server. На дистрибутивах семейства RHEL используется пакетный менеджер yum или dnf с аналогичной логикой.
Точный перечень зависимостей и порядок шагов зависят от версии дистрибутива, поэтому перед установкой откройте официальную документацию ONLYOFFICE для вашей ОС. Это особенно важно для свежих релизов Ubuntu и Debian, где могут отличаться имена пакетов.
Настройка HTTPS и безопасности
Работа по незащищённому HTTP допустима только для тестов: браузеры блокируют часть функций, а интеграции с облачными хранилищами часто требуют HTTPS. Для боевого сервера настройте SSL-сертификат — проще всего бесплатный от Let's Encrypt.
В Docker-версии сертификаты размещаются в специальной директории данных контейнера, после чего Document Server автоматически переключается на HTTPS. В пакетной установке сертификат подключается через конфигурацию NGINX. В обоих случаях потребуется доменное имя, направленное на IP сервера, — по одному IP сертификат Let's Encrypt не выдаёт.
⚠️ Внимание: не оставляйте сервер с включённым JWT и пустым или стандартным секретом, открытым в интернет. Документы пользователей проходят через Document Server, и слабый JWT-ключ — прямой путь к несанкционированному доступу.
Дополнительные меры безопасности: ограничьте доступ к панелям управления по IP, регулярно обновляйте образ или пакеты, настройте файрвол (ufw или firewalld) так, чтобы снаружи были доступны только порты 80 и 443.
Интеграция с Nextcloud и другими платформами
Сам по себе Document Server — это движок редактирования без файлового хранилища. Полноценная работа с документами появляется после подключения к платформе вроде Nextcloud, ownCloud, Seafile или Alfresco через официальное приложение-коннектор.
На примере Nextcloud порядок действий такой: установите приложение ONLYOFFICE из магазина приложений Nextcloud, затем в настройках укажите адрес Document Server и тот самый JWT-секрет. После сохранения настроек проверьте, что тестовый документ открывается в редакторе без ошибок.
Типовые ошибки интеграции и их причины сведены в таблице:
| Симптом | Вероятная причина | Что проверить |
|---|---|---|
| «Document Server недоступен» | Nextcloud не может достучаться до Docs по сети | Доступность адреса с сервера Nextcloud, DNS, файрвол |
| Ошибка JWT / «неверный токен» | Секреты не совпадают на двух сторонах | Значение JWT_SECRET в контейнере и в настройках коннектора |
| Редактор открывается, но не сохраняет | Callback-адрес недоступен из контейнера | Может ли Docs обратно обратиться к Nextcloud по указанному URL |
| Ошибка скачивания документа | Смешанный HTTP/HTTPS контент | Оба сервиса должны работать по HTTPS |
Почему Document Server должен видеть Nextcloud, а Nextcloud — Document Server
Редактирование работает двусторонне: браузер пользователя загружает редактор с Document Server, а сам сервер скачивает файл с Nextcloud и отправляет результат сохранения обратно по callback-URL. Если хотя бы одно из этих направлений закрыто сетью или неверным адресом, интеграция ломается с разными симптомами.
Обновление и обслуживание
Обновление Docker-версии сводится к остановке старого контейнера, загрузке нового образа и повторному запуску с теми же параметрами и томами. Главное — не терять смонтированные данные, поэтому тома -v должны быть настроены с самого начала.
sudo docker pull onlyoffice/documentserver
sudo docker stop && sudo docker rm
запуск нового контейнера с прежними параметрами
Пакетная версия обновляется штатно через apt upgrade или dnf update. Перед любым обновлением сделайте резервную копию базы данных и конфигурационных файлов — это займёт несколько минут, но спасёт при неудачном апгрейде.
Полезно периодически проверять логи сервисов (в Docker — через docker logs, в пакетной установке — в каталоге логов Document Server) и следить за свободным местом на диске: файлы кэша и логи со временем разрастаются.
Частые вопросы по установке ONLYOFFICE Docs
Можно ли установить ONLYOFFICE Docs на Windows?
Да, существует версия для Windows Server, устанавливаемая через MSI-инсталлятор. Однако для Linux доступны все способы развёртывания и, как правило, более подробная документация, поэтому Linux считается предпочтительной платформой.
Сколько пользователей выдержит один сервер?
Точное число зависит от ресурсов сервера, числа одновременно открытых документов и их размера. Ориентируйтесь на нагрузочное тестирование в своей инфраструктуре: начните с конфигурации 4 ГБ ОЗУ и 2 ядер и наблюдайте за потреблением ресурсов под реальной нагрузкой.
Чем ONLYOFFICE Docs отличается от ONLYOFFICE Workspace?
Docs — это только сервер совместного редактирования документов. Workspace — более широкое решение, включающее Docs плюс модули почты, CRM, проектов и календаря. Если нужно только редактирование, достаточно Docs.
Нужна ли лицензия для домашнего использования?
Существует бесплатная версия Community Edition с открытым исходным кодом — её достаточно для личного использования и небольших команд. Коммерческие редакции добавляют расширенную поддержку, масштабирование и дополнительные функции.
Что делать, если после установки редактор не открывается?
Проверьте последовательно: запущен ли контейнер или сервисы, открывается ли страница приветствия по IP, не заняты ли порты другим приложением, что пишут логи. Большинство проблем на этом этапе связано с сетью, файрволом или нехваткой памяти.