Skip to content

Инструкция по установке Onlyoffice с использованием Docker ​

Установка ​

В Nextbox 1.12 интеграция Onlyoffice входит в Core. В основной Compose добавьте только Document Server.

В .env укажите версию образа

ini
ONLYOFFICE_IMAGE=onlyoffice/documentserver:<версия>

Используйте существующий ONLYOFFICE_JWT_SECRET — тот же ключ передаётся в Core. Пример использует автономный Document Server Community.

Добавьте сервис в секцию services:

yaml
  onlyoffice_server:
    image: ${ONLYOFFICE_IMAGE:?Укажите версию Document Server}
    restart: always
    depends_on:
      core:
        condition: service_healthy
    environment:
      JWT_ENABLED: "true"
      JWT_SECRET: ${ONLYOFFICE_JWT_SECRET:?Сохраните ключ OnlyOffice}
      JWT_HEADER: Authorization
      ALLOW_PRIVATE_IP_ADDRESS: "true"
    volumes:
      - onlyoffice_data:/var/www/onlyoffice/Data
      - onlyoffice_cache:/var/lib/onlyoffice
      - onlyoffice_logs:/var/log/onlyoffice
    networks: [nextbox]
    healthcheck:
      test: [CMD-SHELL, "curl -fsS -o /dev/null http://127.0.0.1/healthcheck"]
      interval: 10s
      timeout: 5s
      retries: 20
      start_period: 60s

Добавьте тома в секцию volumes:

yaml
  onlyoffice_data:
  onlyoffice_cache:
  onlyoffice_logs:

В nginx.depends_on добавьте готовность Document Server, сохранив остальные зависимости

yaml
onlyoffice_server:
  condition: service_healthy

В секцию server файла default.conf добавьте маршрут

nginx
location /onlyoffice/ {
    proxy_pass http://onlyoffice_server/;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection $proxy_connection;
    proxy_set_header X-Forwarded-Host $the_host/onlyoffice;
    proxy_set_header X-Forwarded-Proto $the_scheme;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}

Проверьте и запустите Document Server, затем перезапустите nginx

bash
docker compose config --quiet
docker compose pull onlyoffice_server
docker compose up -d --wait onlyoffice_server
docker compose exec -T nginx nginx -t
docker compose restart nginx

Обновление ​

Сохраните резервную копию базы и томов Document Server. В .env замените только ONLYOFFICE_IMAGE, оставив прежний JWT secret.

bash
docker compose pull onlyoffice_server
docker compose up -d --wait --no-deps onlyoffice_server
docker compose exec -T onlyoffice_server curl -fsS http://127.0.0.1/healthcheck

При переходе с 1.11 сохраните прежние версию, тома, внешние подключения и настройки Document Server. Обновление Nextbox не требует смены редакции Document Server. Отдельный backend onlyoffice заменяется Core.