Разверните ONLYOFFICE Docs Enterprise с помощью официального файла конфигурации (Compose File).

Для развертывания на одном хосте используйте официальный docker-compose.enterprise.ymlрепозиторий ONLYOFFICE из Docker-DocumentServer и запустите его с помощью Docker Compose v2. Перед запуском стека замените примеры учетных данных, установите стабильный секретный ключ JWT для вашей интеграции и смонтируйте каталог, в котором будет храниться ваша корпоративная лицензия и постоянные данные. Запущенный контейнер — это только первая проверка: перед подключением к производственной платформе подтвердите работоспособность Compose и откройте приветственную страницу документации.

С чего начинается файл Enterprise Compose?

Официальный файл определяет службу Document Server Enterprise, а также зависимости PostgreSQL, RabbitMQ и Redis. Он публикует HTTP- и HTTPS-порты редактора и включает проверку работоспособности внутренней конечной точки для получения информации о документации. Эти зависимости делают данный файл Compose удобным для небольшой установки на одном хосте; сам по себе он не настраивает коннектор вашей платформы, публичный DNS или производственный TLS-сертификат.

По данным проверки от 9 октября 2026 года, в официальном файле используются PostgreSQL 15, RabbitMQ 3 и Redis 7. Файлы репозитория могут изменяться, поэтому перед развертыванием и обновлением следует проверить текущий файл Enterprise Compose .

1. Проверьте хост и установите Docker Compose.

В требованиях ONLYOFFICE к корпоративному Docker указан хост на базе Linux amd64 с ядром версии 3.10 или выше, поддержка Docker со стороны разработчиков, не менее 4 ГБ оперативной памяти, 40 ГБ свободного места на диске и не менее 4 ГБ файла подкачки. Рекомендуемый размер также зависит от количества одновременно открытых документов и типа документа, поэтому используйте эти цифры в качестве отправной точки, а не гарантии производительности. Для производственного портала с более высокой нагрузкой может потребоваться больше ресурсов.

Установите Docker Engine и плагин Compose, следуя официальным инструкциям Docker для вашего дистрибутива Linux. Перед клонированием репозитория убедитесь, что обе команды работают:

docker --version
docker compose version

Если на хосте уже есть веб-сервер, убедитесь в доступности портов 80 и 443 или запланируйте использование обратного прокси и другого сопоставления портов на стороне хоста. Файл Compose также запускает службы базы данных, очереди и кэша; они должны оставаться в частной сети Compose, а не публиковаться как общедоступные порты.

2. Получите официальный файл Compose.

Клонируйте репозиторий ONLYOFFICE и перейдите в его директорию:

git clone https://github.com/ONLYOFFICE/Docker-DocumentServer
cd Docker-DocumentServer

Убедитесь, что docker-compose.enterprise.ymlон присутствует. В файле README репозитория для корпоративной версии приведена следующая команда:

docker compose -f docker-compose.enterprise.yml up -d

3. Укажите учетные данные, JWT и местоположение для постоянной лицензии.

Не запускайте пример конфигурации Compose без изменений на хосте, доступном из Интернета. Опубликованный файл содержит пример учетных данных базы данных и комментирует явные значения JWT. Замените пароль PostgreSQL как в службе базы данных, так и в DB_PWDнастройках Document Server на одно и то же надежное значение. Держите порты базы данных, RabbitMQ и Redis закрытыми.

Для интеграции задайте один стабильный секретный ключ JWT в службе Document Server и настройте тот же секретный ключ в коннекторе ONLYOFFICE вашей платформы. Простой подход — хранить значение в локальном .envфайле, который вы не добавляете в Git, а затем использовать подстановку переменных в Compose. Добавьте следующие записи в раздел среды Document Server, адаптируя существующий формат среды по мере необходимости:

- JWT_ENABLED=true
- JWT_SECRET=${JWT_SECRET}

Укажите длинное, уникальное значение в .envкачестве параметра JWT_SECRET=.... Не копируйте буквальное значение-заполнитель в рабочую конфигурацию. В документации ONLYOFFICE JWT включен по умолчанию в Docs 7.2 и более поздних версиях с автоматически генерируемым секретом; указание собственного стабильного значения позволяет избежать несоответствия при повторном создании контейнера. См. руководство по настройке JWT .

Для регистрации Enterprise с приобретенным license.licDocker-контейнером, смонтируйте каталог хоста в /var/www/onlyoffice/Dataслужбу Document Server. Например, замените анонимное монтирование данных на ./documentserver-data:/var/www/onlyoffice/Data, создайте этот каталог хоста и поместите license.licв него файл перед запуском. Сохраните права доступа к файлу и включите каталог в план резервного копирования. Инструкции по регистрации Enterprise подтверждают, что файл лицензии должен находиться в смонтированной папке для Docker.

4. Запустите корпоративный стек.

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

docker compose -f docker-compose.enterprise.yml config --quiet
docker compose -f docker-compose.enterprise.yml up -d

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

5. Перед подключением платформы проверьте готовность.

Проверьте предоставляемые услуги и состояние здоровья:

docker compose -f docker-compose.enterprise.yml ps

Дождитесь успешного завершения проверки работоспособности Document Server. Официальный файл Compose выполняет проверку http://localhost:8000/info/info.jsonизнутри контейнера с 60-секундным периодом запуска. Если служба остается неработоспособной, проверьте ее журналы и состояние зависимостей:

docker compose -f docker-compose.enterprise.yml logs --tail=100 onlyoffice-documentserver

Затем откройте http://localhostна хосте или по указанному URL-адресу в браузере, который может связаться с сервером. В инструкциях ONLYOFFICE по созданию файлов используется приветственная страница в качестве первоначальной проверки установки. Для удаленного использования в производственной среде предоставьте доступ к сервису через HTTPS на вашем домене, а не оставляйте трафик редактора по обычному HTTP. При настройке сетевого доступа и TLS обратитесь к руководству по портам Enterprise Docker и руководству по установке Docker .

Наконец, настройте URL-адрес сервера документов вашей платформы и соответствующий секретный ключ JWT, затем откройте, отредактируйте и сохраните тестовый документ через эту интеграцию. Одна только приветственная страница не доказывает правильность настройки коннектора, обратного прокси, JWT или URL-адреса обратного вызова. Если службы работают исправно, но редактор не может открыть документ с платформы, убедитесь, что платформа может получить доступ к URL-адресу Docs и что обе стороны используют один и тот же секретный ключ JWT и заголовок. Для развертывания на нескольких хостах или с высокой доступностью рассматривайте этот стек Compose как отправную точку и ознакомьтесь с рекомендациями ONLYOFFICE по развертыванию, а не предполагайте, что кластеризация обеспечивается одним хостом Compose.