Перейти к основному содержимому

Устранение возможных неполадок в ONLYOFFICE Docs для Linux

Перед обращением в службу поддержки: сбор диагностической информации​

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

  • Каталог журналов: /var/log/onlyoffice/documentserver/
  • Версия пакета: dpkg -l | grep onlyoffice (Debian/Ubuntu) или rpm -qa | grep onlyoffice (CentOS)
  • Версия ОС: cat /etc/os-release

Проблемы при компиляции​

Вопрос: Я клонировал код, но нахожу только пустые папки, исходного кода нет.

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

git clone --recursive https://github.com/ONLYOFFICE/DocumentServer.git

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

git clone https://github.com/ONLYOFFICE/DocumentServer.git

обновить подмодули можно следующим образом:

  1. Перейдите в каталог DocumentServer:

    cd DocumentServer

  2. Выполните следующую команду:

    git submodule update --init --recursive

Проблемы при использовании​

Вопрос: При остановке ONLYOFFICE Docs произошла потеря данных. Как избежать потери данных?

Ответ: Из-за особенности работы ONLYOFFICE Docs сохраняет документ только после того, как все пользователи, редактирующие его, закрыли документ. Чтобы избежать потери данных, при необходимости остановить ONLYOFFICE Docs в случаях обновления приложения, перезагрузки сервера и т.п. необходимо принудительно отключить пользователей ONLYOFFICE Docs. Для этого на сервере, где установлен ONLYOFFICE Docs, выполните следующий скрипт:

sudo documentserver-prepare4shutdown.sh
примечание

Выполнение скрипта может занять продолжительное время (до 5 минут), так как он ожидает отключения всех пользователей.

Вопрос: Я добавил пользовательскую тему интерфейса или обновил языковые файлы редактора (исправил некоторые переводы), но сервер по-прежнему показывает прежние значения вместо правильных. Как сбросить кэш сразу для всех пользователей?

Ответ: Чтобы сбросить кэш, выполните следующие действия:

Найдите файлы /etc/nginx/includes/ds-docservice.conf и /etc/nginx/includes/ds-spellchecker.conf. В них должно быть указано значение даты и времени сборки. Измените эти значения на любые другие (подойдет любое значение, главное, чтобы оно было одинаковым во всех местах) и перезапустите NGINX:

sudo service nginx reload

Кэш будет сброшен для всех пользователей сервера.

Вопрос: Службы ONLYOFFICE Docs не запускаются. Что делать?

Ответ: Проверьте состояние служб и просмотрите сообщения об ошибках:

sudo systemctl status ds-docservice
sudo systemctl status ds-converter

Если какая-либо из служб остановлена, попробуйте перезапустить ее:

sudo systemctl restart ds-docservice

Распространенные причины:

  • Недостаточно памяти (рекомендуется не менее 4 ГБ оперативной памяти).
  • Порт 80 уже занят другим приложением. Найдите конфликтующий процесс с помощью команды sudo ss -tlnp | grep :80 и остановите его или настройте ONLYOFFICE Docs на использование другого порта.
  • Более подробные сообщения об ошибках смотрите в журналах: /var/log/onlyoffice/documentserver/

Вопрос: После интеграции ONLYOFFICE Docs с моей платформой не проходит JWT-аутентификация. Как это исправить?

Ответ: Убедитесь, что секретный ключ JWT, заданный в ONLYOFFICE Docs, в точности совпадает с секретным ключом, указанным в настройках коннектора вашей платформы. Также проверьте, совпадает ли имя заголовка JWT (по умолчанию «Authorization»). Чтобы узнать текущий секретный ключ, прочитайте файл конфигурации напрямую:

cat /etc/onlyoffice/documentserver/local.json

Найдите значение параметра services.CoAuthoring.secret.session.string. Распространенные ошибки:

  • Пробелы в начале или в конце значения секретного ключа.
  • Использование случайного секретного ключа по умолчанию вместо собственного.

Вопрос: Не удается преобразовать документ (например, при открытии файлов DOC, XLS или PPT появляется ошибка). Что можно сделать?

Ответ: Проверьте журнал конвертера на наличие ошибок:

cat /var/log/onlyoffice/documentserver/converter/out.log

Распространенные причины — нехватка места на диске и отсутствие нужных шрифтов.

Вопрос: ONLYOFFICE Docs использует много памяти. Это нормально?

Ответ: Объем используемой памяти растет с числом открытых документов и одновременно работающих пользователей. Для сервера с несколькими десятками активных пользователей нормальным считается использование 2–4 ГБ оперативной памяти. Если потребление памяти неожиданно высокое, проверьте, нет ли зависших или забытых документов в папке /var/lib/onlyoffice/documentserver/App_Data/cache/files/forgotten/.

Проблемы в Enterprise Edition и Developer Edition​

Вопрос: Появляется предупреждение «License expired». Что делать?

Ответ: Срок действия вашего файла license.lic истек. Чтобы продлить лицензию, напишите на адрес sales@onlyoffice.com. Получив новый файл, замените им старый файл license.lic в каталоге данных и перезапустите ONLYOFFICE Docs.

Вопрос: Не удается открыть Admin Panel. Что делать?

Ответ: Если вы еще не настроили Admin Panel, следуйте руководству по настройке Admin Panel. Если вы забыли пароль администратора, удалите запись passwordHash из файла runtime.json и выполните перезапуск — будет сгенерирован новый код начальной настройки (bootstrap code).