Устранение неполадок

Общие проблемы

Вопрос: Я хочу установить Docker-версию на своем локальном сервере. Как это сделать?

Ответ: Последняя Docker-версия онлайн-офиса доступна на Docker Hub. Выберите, что вы хотите установить: ONLYOFFICE Docs, ONLYOFFICE Workspace или ONLYOFFICE Mail, и следуйте инструкциям на соответствующей странице.

Вопрос: После создания портала и входа на него я вижу в модуле Люди неизвестного пользователя с именем «fake user». Также в списке служб есть служба OnlyofficeHealthCheck. Почему так и нужно ли что-то с этим делать?

Ответ: Этот пользователь и служба — часть будущей функции Health Check, которая станет доступна для порталов в следующих выпусках. Пока она не работает, поэтому вы можете оставить все как есть или отключить службу OnlyofficeHealthCheck и удалить ее из списка автоматического запуска служб.

Вопрос: Какая нужна система для установки серверного решения и успешной работы с ним?

Ответ: Требования к системе таковы:

• Процессор: двухъядерный с тактовой частотой 2 ГГц или лучше
• ОЗУ: 4 ГБ или больше
• Жесткий диск: не менее 20 ГБ свободного места
• SWAP: не менее 4 ГБ, но зависит от ОС хоста. Чем больше, тем лучше
• ОС: дистрибутив Linux amd64 с версией ядра 3.10 или выше
• Дополнительные требования
  • Docker: любая версия, поддерживаемая командой Docker

Вопрос: Я установил одну из серверных версий с помощью сервиса Docker, но возникают проблемы с DNS-сервером или разрешением собственного имени. Что может быть не так?

Ответ: В Docker по умолчанию указаны DNS-серверы Google, и сервер пытается обращаться к ним при любом сетевом запросе. Если ваш ONLYOFFICE Workspace, ONLYOFFICE Docs или ONLYOFFICE Mail не будет иметь доступа в Интернет, рекомендуется изменить заданный в Docker по умолчанию адрес DNS-сервера на адрес вашего локального DNS-сервера. Для этого откройте файл /etc/default/docker и замените IP-адрес в следующей строке на IP-адрес DNS-сервера в вашей локальной сети:

docker_OPTS="--dns 8.8.8.8"

Для операционных систем на основе RPM, например, CentOS, файл конфигурации может находиться здесь: /etc/docker/daemon.json

Вопрос: Редакторы документов открываются, появляется интерфейс, но не загружается сам документ, все время показывая ход загрузки. Что можно сделать?

Ответ: Возможно, дело в том, что компьютер должен иметь возможность обращаться к самому себе по внешнему IP-адресу, то есть он должен быть доступен извне для самого себя. Это можно разрешить, указав в iptables правила перенаправления следующего вида:

iptables -t nat -A PREROUTING -d <public_ip> -j DNAT --to-destination <local_ip>
iptables -t nat -A POSTROUTING -s <local_ip> -j SNAT --to-source <public_ip>

Не забудьте заменить адреса public_ip и local_ip реальными IP-адресами.

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

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

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

sudo service nginx reload

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

примечание

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

Проблемы с HTTPS

Вопрос: Я добавил самоподписанный SSL-сертификат, и теперь получаю ошибку при открытии страницы с метаданными SSO, при работе с WebDAV и другими node.js сервисами. Что можно сделать, чтобы это исправить?

Ответ: Если у вас возникла проблема с получением метаданных SSO, WebDAV и другими node.js сервисами при использовании самоподписанных SSL-сертификатов, вы можете попробовать один из следующих вариантов решения этой проблемы:

Вариант 1: добавьте параметры запуска службы.

1. Откройте файл onlyofficeSsoAuth.service (внутри контейнера CommunityServer):

   nano /lib/systemd/system/onlyofficeSsoAuth.service

2. В конце блока [Service] добавьте следующую строку, указав путь к корневому сертификату:

   Environment=NODE_EXTRA_CA_CERTS=/etc/rootCA.pem

3. Перезапустите службы:

   systemctl daemon-reload
   systemctl restart onlyofficeSsoAuth

Вариант 2: используйте системный набор сертификатов.

1. Откройте файл onlyofficeSsoAuth.service (внутри контейнера CommunityServer):

   nano /lib/systemd/system/onlyofficeSsoAuth.service

2. В блоке [Service] найдите следующую строку:

   ExecStart=/usr/bin/node /var/www/onlyoffice/Services/ASC.SsoAuth/app.js UNIX.SERVER

   Замените ее на следующую строку:

   ExecStart=/usr/bin/node --use-openssl-ca /var/www/onlyoffice/Services/ASC.SsoAuth/app.js UNIX.SERVER

3. Для CentOS дополнительно добавьте в конце блока [Service] следующую строку, указав путь к набору сертификатов:

   Environment=SSL_CERT_FILE=/etc/pki/tls/certs/ca-bundle.trust.crt

4. Перезапустите службы:

   systemctl daemon-reload
   systemctl restart onlyofficeSsoAuth

Проблемы с Docker

Вопрос: Я перезагрузил сервер, не остановив контейнер Docker с помощью команды docker stop id, и теперь получаю ошибку ERR_TOO_MANY_REDIRECTS для моего сервера. Что можно сделать, чтобы это исправить?

Ответ: Отредактируйте файл /var/www/onlyoffice/WebStudio/web.appsettings.config, удалив самую последнюю строку:

<add key="web.warmup.type" value="basic" />

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

sudo service monoserve restart

Вопрос: Я использую Fedora Linux, и процессы внутри Docker-контейнера не запускаются. Есть ли решение этой проблемы?

Ответ: Пользователям Fedora и RHEL/CentOS можно попробовать отключить SELinux с помощью команды setenforce 0. Если это помогло, вы можете продолжать работу с отключенным SELinux (что не рекомендуется Red Hat) или перейти на Ubuntu.

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

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

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

sudo docker exec <CONTAINER> documentserver-prepare4shutdown.sh

примечание

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

примечание

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