🐳 Как запустить ONLYOFFICE Docs через контейнер Docker

В этом руководстве вы узнаете, как установить и настроить ONLYOFFICE Docs в виде контейнера Docker.

Следуя описанным ниже шагам, вы научитесь самостоятельно устанавливать последнюю версию Docker и развертывать офисный пакет для совместной работы с текстовыми документами, электронными таблицами и презентациями с помощью ONLYOFFICE Docs.

Что такое ONLYOFFICE Docs?

ONLYOFFICE Docs – это офисный пакет с открытым исходным кодом, который позволяет создать среду для совместной работы, предоставляя возможности редактирования документов широкому спектру решений для совместного использования файлов и систем управления документами, включая Nextcloud, Alfresco, ownCloud, Confluence, Liferay, Nuxeo, ownCloud, SharePoint, ONLYOFFICE Workspace и др.

ONLYOFFICE Docs обладает следующими возможностями:

Совместные редакторы для текстовых документов, электронных таблиц и презентаций любого типа.
Совместное редактирование в реальном времени (два режима совместного редактирования, отслеживание изменений, автосохранение, история версий, комментарии и упоминания пользователей, общение через встроенный чат).
Различные разрешения доступа (полный доступ, рецензирование, заполнение форм, комментирование, просмотр).
Полная совместимость с файлами Word, Excel и PowerPoint;
Поддержка других популярных форматов при помощи конвертации: DOC, TXT, ODT, RTF, ODP, EPUB, ODS, XLS, CSV, HTML.
Плагины сторонних разработчиков и макросы JavaScript (видео YouTube, Google Translate, Zotero, Mendeley, Photo Editor, Telegram, счетчик слов и т.д.).
Повышенная безопасность (JSON Web Token, настраиваемое время жизни кэша, HTTPS и т.д.).

Требования к аппаратному и программному обеспечению

Прежде чем начать процесс установки, убедитесь, что ваше оборудование соответствует следующим требованиям:

Процессор: двухъядерный с частотой 2 ГГц или выше;
Оперативная память: не менее 4 ГБ;
Место для подкачки: не менее 2 ГБ;
HDD: не менее 2 ГБ свободного места;
Docker: v1.9.0 или новее.

Шаг 1 – Установите Docker

Для установки ONLYOFFICE Docs необходимо, чтобы на вашей машине был установлен Docker.

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

Шаг 2 – Установка ONLYOFFICE Docs

Когда Docker будет успешно установлен на вашей машине, запустите его и введите эту команду для установки ONLYOFFICE Docs:

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

Вот и все.

🐳 Как использовать команду Docker run

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

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

Обратите внимание, что ONLYOFFICE Docs использует 80 порт для входящих соединений.

Чтобы изменить порт по умолчанию, выполните следующую команду:

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

В этой команде <PORT_NUMBER> – это номер порта, который вы хотите, чтобы ONLYOFFICE Docs использовал для входящих соединений.

Шаг 3 – Убедитесь, что ваши данные хранятся вне контейнера Docker

Мы не рекомендуем пропускать этот шаг, потому что хранение ваших данных вне контейнера Docker на вашей машине позволит вам легко обновить ONLYOFFICE Docs в будущем без потери ваших данных.

🐳 Как обмениваться данными между контейнером Docker и хост-системой с помощью томов

Все ваши данные (логи, сертификаты, файловый кэш и т.д.) хранятся в специальных каталогах, также известных как data volumes, в следующих местах:

/var/log/onlyoffice – логи ONLYOFFICE;
/var/www/onlyoffice/Data – сертификаты;
/var/lib/onlyoffice – кэш файлов;
/var/lib/postgresql – ваша база данных.

Чтобы получить доступ к данным, хранящимся вне контейнера Docker, необходимо смонтировать эти тома, добавив опцию -v в команду docker run:

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  onlyoffice/documentserver

Если вы смонтируете папки, которые еще не были созданы, они будут созданы в любом случае, но ваш доступ к ним будет ограничен.

Вам придется изменить права доступа к ним вручную.

Шаг 4 – Запуск ONLYOFFICE Docs с HTTPS

Чтобы запустить ONLYOFFICE Docs через протокол HTTPS, введите следующее:

un -i -t -d -p 443:443 --restart=always \
-v /app/onlyoffice/DocumentServer/data:/var/www/onlyoffice/Data  onlyoffice/documentserver

Если вы хотите предотвратить несанкционированный доступ, вы также можете использовать SSL-сертификат.

Для этого вам понадобятся две вещи:

Закрытый ключ (.key)
SSL-сертификат (.crt)

🔐 Что такое файл .pem и как его использовать?

Это означает, что вам необходимо создать и установить следующие файлы:

/app/onlyoffice/DocumentServer/data/certs/onlyoffice.key
/app/onlyoffice/DocumentServer/data/certs/onlyoffice.crt

Если у вас есть сертификат, выданный УЦ (например, Let’s Encrypt), добавьте эти файлы.

Если вы предпочитаете самоподписанные сертификаты, вам необходимо сгенерировать эти файлы самостоятельно.

🔏 Как принудительно продлить сертификат Let’s Encrypt

Переключение ONLYOFFICE Docs на HTTPS с помощью certbot

Предпочтительным способом запуска ONLYOFFICE Docs по протоколу HTTPS является получение SSL-сертификата Let’s Encrypt с помощью certbot.

Запустите ONLYOFFICE Docs, указав порты 80 и 443 и введя свои собственные значения для переменных ниже:

sudo docker run -i -t -d -p 80:80 -p 443:443 \
    -e LETS_ENCRYPT_DOMAIN=yourdomain.com -e LETS_ENCRYPT_MAIL=email@example.com  onlyoffice/documentserver

LETS_ENCRYPT_DOMAIN – доменное имя, используемое для вашего SSL-сертификата.
LETS_ENCRYPT_MAIL – адрес электронной почты, который вы использовали при регистрации.

Сертификат Let’s Encrypt будет автоматически сгенерирован и установлен на вашей машине.

Ваш экземпляр ONLYOFFICE Docs будет доступен по адресу https://yourdomain.com.

Поздравляем!

Вы успешно прошли процесс настройки.

Теперь вы можете запустить ONLYOFFICE Docs как контейнер Docker и редактировать текстовые документы, электронные таблицы и презентации онлайн.

Шаг 5 – Тестирование ONLYOFFICE Docs

Кроме того, перед интеграцией ONLYOFFICE Docs со сторонним файлообменным решением вы можете протестировать функциональность редакторов.

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

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

Просто перейдите по адресу https://yourdomain.com/welcome и следуйте инструкциям.

Тестовый пример станет доступен по адресу https://yourdomain.com/example.

Используя тестовый пример, вы можете проверить правильность работы ONLYOFFICE Docs, загружая и редактируя локальные файлы или создавая новые (DOCX, XLSX и PPTX).

Другие статьи о Docker:

DevOps Docker