Сообщение «Приложение ONLYOFFICE недоступно, пожалуйста свяжитесь с администратором» появляется при попытке открыть документ в облачном портале или при обращении к серверу ONLYOFFICE Docs, когда редактор не может установить соединение с Document Server. Ошибка означает, что клиентская часть (браузер, десктопный редактор или мобильное приложение) не получает корректный ответ от серверной службы, и дальнейшая работа с файлами блокируется.
Хорошая новость: в большинстве сценариев проблема решается диагностикой сети, проверкой служб и настроек портала. Ниже разберём, где именно искать причину — на стороне пользователя или на стороне сервера — и какие шаги безопасны для самостоятельного выполнения.
Что означает эта ошибка
Архитектура ONLYOFFICE предполагает, что редактор документов работает как отдельный сервис — Document Server. Когда вы открываете файл, портал обращается к этому сервису по внутреннему или внешнему адресу. Если служба остановлена, недоступна по сети или отвечает с ошибкой, пользователь видит заглушку с предложением связаться с администратором.
При этом формулировка намеренно обобщённая: она не указывает конкретную причину. Реальными источниками проблемы могут быть как банальная недоступность сервера из-за перезагрузки, так и истёкший сертификат, изменённый порт, переполненный диск или сбой после обновления.
- 🔌 Document Server остановлен — служба не запущена или упала из-за нехватки памяти;
- 🌐 сетевые ограничения — файрвол, прокси или VPN блокируют обращение к серверу;
- 🔒 проблемы с SSL — истёкший или самоподписанный сертификат при HTTPS-подключении;
- ⚙️ неверная конфигурация — изменились адрес, порт или ключи после обновления или миграции.
Быстрая диагностика: где искать проблему
Первое действие — определить, локальная ли это проблема или массовая. Попросите коллегу открыть тот же портал со своего устройства. Если у других пользователей всё работает, причина почти наверняка на вашей стороне: браузер, кэш, сеть или антивирус.
Если ошибка наблюдается у всех пользователей одновременно — проблема серверная, и без доступа администратора её не решить. В этом случае пользователю остаётся только сообщить о сбое и дождаться восстановления.
Что может сделать обычный пользователь
Если вы не администратор сервера, круг действий ограничен, но несколько безопасных проверок доступны. Начните с самого простого: обновите страницу и попробуйте открыть портал в другом браузере или в режиме инкогнито. Это исключит влияние повреждённого кэша и конфликтующих расширений.
Далее проверьте сетевое окружение. Корпоративные VPN, прокси и защитное ПО иногда блокируют WebSocket-соединения, которые редактор использует для совместного редактирования. Временно отключите VPN и проверьте, не фильтрует ли антивирус трафик к адресу портала.
- 🔄 Очистите кэш и cookie браузера для домена портала;
- 🕵️ Откройте портал в режиме инкогнито без расширений;
- 📡 Проверьте работу без VPN и прокси;
- 📱 Попробуйте другой клиент — десктопные редакторы ONLYOFFICE Desktop Editors или мобильное приложение.
Проверки на стороне сервера для администратора
Администратору следует начать с проверки состояния служб Document Server. На Linux-развёртывании статус основных процессов можно посмотреть через systemd:
systemctl status ds-docservice
systemctl status ds-converter
Если службы остановлены, попробуйте перезапустить их командой supervisorctl restart all или через systemd — в зависимости от способа установки. После перезапуска проверьте страницу healthcheck сервера: она должна возвращать true. При Docker-развёртывании убедитесь, что контейнер запущен и не перезапускается циклически — команда docker ps покажет его состояние.
⚠️ Внимание: перед перезапуском служб убедитесь, что у пользователей нет открытых сессий редактирования с несохранёнными изменениями. Принудительный перезапуск во время активной работы может привести к потере последних правок.
Частая причина внезапного отказа — переполнение диска. Проверьте свободное место командой df -h: при заполнении раздела службы Document Server и база данных перестают работать корректно. Также изучите логи — они находятся в каталоге логов Document Server (путь зависит от способа установки) и содержат конкретные ошибки, по которым можно найти решение в официальной документации.
☑️ Диагностика сервера ONLYOFFICE
Типичные причины и способы устранения
Соберём основные сценарии в таблицу, чтобы быстро сориентироваться по симптомам.
| Симптом | Вероятная причина | Действие |
|---|---|---|
| Ошибка у всех пользователей | Остановлен Document Server | Проверить и перезапустить службы |
| Ошибка только по HTTPS | Истёк сертификат | Обновить SSL-сертификат |
| Ошибка после обновления | Конфликт конфигурации | Сверить настройки с документацией версии |
| Ошибка у одного пользователя | Кэш, браузер, VPN | Очистить кэш, сменить браузер |
| Редактор открывается, но не сохраняет | Проблема с callback-адресом | Проверить доступность портала с Document Server |
Отдельно стоит сказать про JWT и интеграционные ключи. Если ONLYOFFICE подключён к Nextcloud, ownCloud или другой платформе, ошибка доступности может возникать из-за рассинхронизации секретного ключа между сторонами. Проверьте, что ключ в настройках коннектора совпадает с ключом в конфигурации Document Server.
Где искать конфигурацию Document Server
Основной конфигурационный файл — local.json, его расположение зависит от способа установки (обычно в каталоге /etc/onlyoffice/documentserver/ на Linux). В Docker-версии параметры чаще задаются через переменные окружения при запуске контейнера. Перед правкой файла сделайте резервную копию.
Когда обращаться к администратору и что ему сообщить
Если вы пользователь, а не администратор, не пытайтесь «чинить» сервер самостоятельно — но можете существенно ускорить решение, передав полезную информацию. Чем точнее вы опишете симптомы, тем быстрее администратор найдёт причину.
Сообщите: точный текст ошибки, время её появления, у всех ли коллег она наблюдается, какой браузер и клиент вы используете, работает ли портал в другом браузере. Если ошибка появилась после какого-то события — обновления, смены пароля, переезда сервера — обязательно упомяните это.
⚠️ Внимание: не публикуйте в открытых каналах скриншоты, содержащие внутренние адреса серверов, токены или содержимое конфиденциальных документов. Передавайте такие данные только по защищённым корпоративным каналам.
Профилактика: как снизить риск повторения
Администраторам стоит настроить мониторинг доступности Document Server — например, периодическую проверку страницы healthcheck с уведомлением при недоступности. Это позволит узнать о сбое раньше пользователей.
Также полезно контролировать срок действия SSL-сертификатов и свободное место на диске — две самые частые причины внезапных отказов. Обновления Document Server лучше выполнять в нерабочее время и с предварительным резервным копированием конфигурации и данных.
Часто задаваемые вопросы
Пропадут ли мои документы из-за этой ошибки?
Нет, сама по себе ошибка доступности не удаляет файлы. Документы хранятся на портале или в подключённом хранилище, а Document Server отвечает только за их открытие и редактирование. После восстановления службы файлы снова станут доступны.
Можно ли работать с документами без сервера?
Да. Десктопные редакторы ONLYOFFICE Desktop Editors работают локально и не требуют подключения к серверу. Если файл скачан на компьютер, его можно открыть и отредактировать офлайн.
Ошибка только у меня, у коллег всё работает. Что делать?
Проблема на вашей стороне. Очистите кэш браузера, откройте портал в режиме инкогнито, отключите VPN и проверьте, не блокирует ли антивирус соединение. Попробуйте другой браузер или устройство.
Что такое healthcheck и как его проверить?
Это служебная страница Document Server, которая возвращает true, если служба работает. Администратор открывает её по адресу вида https://адрес-сервера/healthcheck. Если страница недоступна или возвращает false — сервис требует диагностики.
Ошибка появилась после обновления ONLYOFFICE. Куда смотреть?
Проверьте логи Document Server на предмет ошибок, убедитесь, что конфигурация соответствует новой версии, а интеграционные ключи (JWT) синхронизированы между порталом и сервером документов. Порядок обновления и возможные изменения описаны в официальной документации конкретной версии.