Обзор развертывания ONLYOFFICE Docs на сервере¶

Предварительные требования¶

Для корректной работы приложения требуются следующие параметры системы и сетевые настройки:

• Операционная система: Ubuntu.

• Сетевые порты:

• 8080 (внутренний порт для взаимодействия с приложением).

• 443 (внешний порт для HTTPS доступа).

• Права доступа: Требуются права суперпользователя (root) для установки Docker и управления конфигурационными файлами.

FDQN итоговой панели на домене hostkey.in¶

Для доступа к приложению используется следующий шаблон доменного имени:

Структура файлов и каталогов¶

В системе используются следующие директории для хранения конфигураций и данных:

• /root/nginx — рабочая директория прокси-сервера.

• /data/nginx/user_conf.d — директория с пользовательскими конфигурациями Nginx.

• /data/nginx/nginx-certbot.env — файл переменных окружения для SSL-сертификатов.

Процесс установки приложения¶

Развертывание включает в себя несколько этапов:

1. Подготовка системы: Установка среды Docker на сервер.

2. Запуск основного сервиса: Развертывание контейнера ONLYOFFICE Docs версии 9.3.

3. Настройка проксирования:

4. Создание директории /root/nginx и конфигурационного файла compose.yml.

5. Настройка Nginx для перенаправления трафика с порта 443 на внутренний порт приложения 8080.

6. Использование Certbot для обеспечения работы по протоколу HTTPS.

Контейнеры Docker и их запуск¶

Приложение функционирует в составе двух контейнеров: основной сервис документов и прокси-сервер с поддержкой SSL.

ONLYOFFICE Docs¶

• Имя образа: onlyoffice/documentserver:9.3

• Порты: 127.0.0.1:8080:80 (доступен только локально для прокси-сервера).

• Переменные окружения:

• JWT_ENABLED: true

• JWT_SECRET: change_me

• Политика перезапуска: always

Nginx Certbot¶

• Имя образа: jonasal/nginx-certbot:latest

• Режим сети: host

• Тома (volumes):

• nginx_secrets:/etc/letsencrypt (внешний том с сертификатами).

• /data/nginx/user_conf.d:/etc/nginx/user_conf.d (конфигурации пользователя).

• Политика перезапуска: unless-stopped

Инструкция по обновлению приложения¶

Для обновления основного приложения необходимо выполнить следующие действия:

1. Обновить образ контейнера через Docker Compose:

   docker compose pull && docker compose up -d