Как установить OnlyOffice Docs и Oracle DB в Ubuntu

Введение

LYONOFFICE Docs — это офисный пакет с открытым исходным кодом, который включает в себя редакторы для совместной работы с текстовыми документами, электронными таблицами, презентациями, формами и PDF-файлами. Пакет распространяется по лицензии AGPL v3.0. OOXML (DOCX, XLSX и PPTX) используется в качестве основного формата. Редакторы можно интегрировать с различными облачными сервисами, такими как платформы CMS, платформы для совместной работы и контента, средства отслеживания проблем, решения для электронного обучения и т. д. Готовые интеграции включают Redmine, Odoo, ownCloud, Moodle, WordPress, Confluence, Jira и другие. Существует также возможность встроить пакет в ваше приложение или веб-сервис.

В этой статье объясняется, как установить OnlyOFFICE Docs в Ubuntu 22.04 с помощью Docker и подключить базу данных Oracle.

Требования к оборудованию

Для установки OnlyOffice Docs вам потребуется как минимум:

Процессор: двухъядерный с тактовой частотой 2 ГГц или выше
Оперативная память: 4 ГБ или более
Жесткий диск: не менее 40 ГБ свободного места
SWAP: не менее 4 ГБ (но зависит от ОС хоста)
Последняя версия Докера

Установка ТолькоОфиса

Самый простой способ установить пакет — использовать Docker. Разработчики официально рекомендуют этот метод. Если Docker не установлен, вы можете обратиться к инструкциям по установке Docker.

Если у вас установлена последняя версия Docker, вы можете установить OnlyOFFICE Docs со всеми зависимостями с помощью одной команды:

sudo docker run -i -t -d -p 80:80 --restart=always \
 -e JWT_SECRET=my_jwt_secret onlyoffice/documentserver

В OnlyOffice Docs секрет JWT генерируется случайным образом. Если в переменной окружения не указан секрет JWT, это приводит к его регенерации при каждой перезагрузке ВМ или физического сервера, поэтому могут возникнуть проблемы при интеграции. Рекомендуется указать свое значение в -e JWT_SECRET=my_jwt_secret. Если вы не будете использовать JWT в своей установке, используйте -e JWT_ENABLED=false.

Если вы хотите изменить порт, используйте опцию -p:

sudo docker run -i -t -d -p <PORT_NUMBER>:80 --restart=always \
 -e JWT_SECRET=my_jwt_secret onlyoffice/documentserver

Когда все будет готово, откройте http://localhost в адресной строке браузера, чтобы открыть страницу приветствия. Там по умолчанию вместе с редакторами представлен пример интеграции. Это простая DMS, используемая для тестирования редакторов и проверки возможности реализации их интеграции.

Чтобы интегрировать OnlyOffice Docs с необходимой вам облачной платформой, ознакомьтесь с соответствующей инструкцией.

Хранение данных вне контейнеров

Настоятельно рекомендуется хранить данные вне контейнеров Docker на главном компьютере, поскольку это позволяет легко обновлять OnlyOffice Docs после выпуска новой версии без потери данных.

Чтобы получить доступ к данным, расположенным вне контейнера, смонтируйте тома. Это можно сделать, указав опцию -v в команде запуска Docker:

sudo docker run -i -t -d -p 80:80 --restart=always \
 -v /app/onlyoffice/DocumentServer/logs:/var/log/onlyoffice \
 -v /app/onlyoffice/DocumentServer/data:/var/www/onlyoffice/Data \
 -v /app/onlyoffice/DocumentServer/lib:/var/lib/onlyoffice \
 -v /app/onlyoffice/DocumentServer/db:/var/lib/postgresql \
 -e JWT_SECRET=my_jwt_secret onlyoffice/documentserver

Если вы удалите контейнер или что-то пойдет не так во время обновления, вы не потеряете свои данные. Вы также сможете обновлять свои сертификаты, не вмешиваясь в работу контейнера.

Переход на HTTPS

Самый простой способ переключить OnlyOFFICE Docs на HTTPS — автоматически получить SSL-сертификаты Let's Encrypt с помощью certbot.

Запустите Docker-контейнер OnlyOffice Docs. Укажите порты 80 и 443 и укажите имя домена и адрес электронной почты:

sudo docker run -i -t -d -p 80:80 -p 443:443 --restart=always \
 -e LETS_ENCRYPT_DOMAIN=yourdomain.com -e [email protected] \
 -e JWT_SECRET=my_jwt_secret onlyoffice/documentserver

После завершения OnlyOffice Docs будет доступен в формате https://yourdomain.com.

Подключение к базе данных Oracle

Обратитесь к параметрам run команды docker для флага --env-file, где вы можете указать все необходимые переменные среды в одном файле. Это избавит вас от написания потенциально длинной команды запуска Docker.

Чтобы подключить базу данных Oracle, измените параметр DB_TYPE на oracle.

Чтобы использовать дополнительные параметры подключения для Oracle, используйте параметр oracleExtraOptions.

Заключение

Мы показали вам, как установить OnlyOFFICE Docs в Ubuntu 22.04 и подключиться к базе данных Oracle. Теперь вы можете редактировать и совместно редактировать различные документы Office на облачной платформе, которую вы уже используете.

Если у вас есть вопросы, оставляйте комментарии ниже.