Запуск ONLYOFFICE Apps в Docker

Введение

ONLYOFFICE Apps — это хаб документов, в котором можно объединить пользователей и документы в одном месте, чтобы упростить совместную работу.

В данном руководстве объясняется, как запустить ONLYOFFICE Apps на компьютере с помощью Docker.

примечание

Это руководство описывает развертывание сборки ONLYOFFICE Apps для разработки и тестирования, которая не предназначена для промышленного использования. Эта сборка работает только по протоколу HTTP, поставляется без служб идентификации/OAuth и имеет сокращенный набор функций. Для промышленного развертывания используйте промышленную версию ONLYOFFICE Apps.

Обзор

В отличие от стандартного развертывания из нескольких контейнеров, в этой сборке все службы ONLYOFFICE Apps работают внутри одного контейнера, а не в отдельных контейнерах для каждой службы. Полный набор состоит из следующих контейнеров:

Контейнер	Назначение
onlyoffice-apps	Все службы ONLYOFFICE Apps (в одном контейнере)
onlyoffice-document-server	Document Server (редакторы)
onlyoffice-mysql-server	База данных MySQL
onlyoffice-opensearch	OpenSearch

По сравнению со стандартным развертыванием из нескольких контейнеров эта сборка имеет следующие отличия:

• Все службы ONLYOFFICE Apps объединены в одном контейнере.
• Упрощенный поиск.
• Нет создания миниатюр.
• Только HTTP, поддержки TLS/HTTPS из коробки нет.
• Нет служб идентификации/OAuth.

Системные требования

• Процессор: не менее 6 ядер (рекомендуется 8 ядер)
• Оперативная память: не менее 12 ГБ (рекомендуется 16 ГБ)
• Жесткий диск: не менее 40 ГБ свободного места
• ОС: дистрибутив Linux amd64 с ядром версии 3.10 или выше
• Дополнительные требования:
  • не менее 6 ГБ файла подкачки
  • Docker Engine с плагином Compose (команда docker compose)

Клонирование репозитория

Клонируйте репозиторий DocSpace-buildtools с помощью следующей команды:

git clone https://github.com/ONLYOFFICE/DocSpace-buildtools.git

Когда репозиторий будет клонирован, перейдите в каталог Compose:

cd DocSpace-buildtools/install/docker/community

Запуск готовых образов

Чтобы запустить ONLYOFFICE Apps в фоновом режиме с помощью готовых образов, выполните следующую команду:

docker compose up -d

Когда контейнеры будут запущены, откройте браузер и введите в адресной строке http://localhost или http://your-ip-address, чтобы открыть ONLYOFFICE Apps.

Сборка образов из исходного кода

Используйте этот вариант, если вы хотите самостоятельно собрать образы ONLYOFFICE Apps или протестировать изменения из определенной ветки.

Соберите и запустите контейнеры с помощью следующей команды:

docker compose up -d --build

примечание

По умолчанию образы собираются из ветки master. Чтобы выполнить сборку из другой ветки, укажите аргумент сборки GIT_BRANCH: GIT_BRANCH=your-branch docker compose up -d --build.

Когда сборка завершится и контейнеры будут запущены, откройте в браузере http://localhost или http://your-ip-address, чтобы открыть ONLYOFFICE Apps.

Запуск с SSL

ONLYOFFICE Apps поддерживает как сертификаты Let's Encrypt, так и собственные сертификаты SSL.

Использование сертификата Let's Encrypt

Чтобы запустить ONLYOFFICE Apps с сертификатом Let's Encrypt, выполните следующую команду, указав свой домен, адрес электронной почты и URL-адрес рабочего пространства:

SSL_MODE="letsencrypt" \
SSL_DOMAIN="example.com,portal.example.com,api.example.com" \
SSL_EMAIL="admin@example.com" \
APP_URL_PORTAL="https://example.com/" \
docker compose \
  -f docker-compose.yml \
  -f ssl.yml \
  up -d

Используются следующие параметры:

• SSL_MODE – режим сертификата SSL.
• SSL_DOMAIN – один или несколько доменов, разделенных запятыми.
• SSL_EMAIL – адрес электронной почты, используемый для регистрации в Let's Encrypt.
• APP_URL_PORTAL – общедоступный URL-адрес вашего рабочего пространства с протоколом HTTPS.

Использование собственного сертификата или сертификата частного центра сертификации

Если вы используете самоподписанный сертификат или сертификат, выданный частным центром сертификации (ЦС), этому сертификату также должен доверять ONLYOFFICE Document Server.

Раскомментируйте следующий том в файле docker-compose.yml:

services:
   onlyoffice-document-server:
     volumes:
       - ${CERTIFICATE_PATH}:/var/www/onlyoffice/Data/certs/extra-ca-certs.pem

Затем укажите путь к сертификату на хосте и выполните следующую команду:

SSL_MODE="custom" \
SSL_DOMAIN="example.com" \
SSL_CERT_PATH="/etc/nginx/certs/fullchain.crt" \
SSL_KEY_PATH="/etc/nginx/certs/private.key" \
CERTIFICATE_PATH="./config/nginx/certs/fullchain.crt" \
APP_URL_PORTAL="https://example.com/" \
docker compose \
  -f docker-compose.yml \
  -f ssl.yml \
  up -d

примечание

CERTIFICATE_PATH должен указывать на файл сертификата на хосте Docker, а не на путь внутри контейнера. Этот вариант обычно требуется только для самоподписанных сертификатов или сертификатов, выданных частным ЦС. Для сертификатов, выданных общедоступными ЦС (например, Let's Encrypt, DigiCert или GoDaddy), эта дополнительная настройка обычно не нужна.

Используются следующие параметры:

• SSL_MODE – режим сертификата SSL (custom).
• SSL_DOMAIN – доменное имя рабочего пространства.
• SSL_CERT_PATH – путь к сертификату SSL.
• SSL_KEY_PATH – путь к закрытому ключу.
• APP_URL_PORTAL – общедоступный URL-адрес вашего рабочего пространства с протоколом HTTPS.

примечание

По умолчанию конфигурация ssl.yml монтирует локальный каталог ./config/nginx/certs в каталог /etc/nginx/certs внутри контейнера.

Когда контейнеры будут запущены, откройте адрес вашего рабочего пространства, например https://example.com/, в браузере, чтобы открыть ONLYOFFICE Apps.