Вы открываете файл DOCX в Nextcloud, ONLYOFFICE загружается нормально, вы вносите изменения, и затем редактор сообщает: «Документ не может быть сохранен». Заманчивый вывод — браузер потерял файл или сам ONLYOFFICE не может записать данные на диск. В интеграции с Nextcloud это часто неверная отправная точка.
Важная деталь — это принцип сохранения. Nextcloud передает ONLYOFFICE Docs URL-адрес документа и идентификатор callbackUrl. ONLYOFFICE загружает файл, запускает сеанс редактирования, а затем вызывает Nextcloud обратно, чтобы Nextcloud мог получить обновленный файл и заменить сохраненную версию. Официальная документация по интеграции ONLYOFFICE явно описывает этот обмен данными через обратный вызов. Это означает, что редактор может успешно открыться, даже если путь возврата, используемый для сохранения, не работает. Действие: рассматривайте открытие и сохранение как две отдельные проверки сети.
Согласно текущей официальной документации по интеграции, коннектор ONLYOFFICE к Nextcloud использует рабочий процесс «сервер-сервер»: сервер документов должен быть доступен из Nextcloud, а Nextcloud должен быть доступен с сервера документов. После завершения редактирования ONLYOFFICE отправляет POST-запрос на URL-адрес обратного вызова; Nextcloud затем загружает отредактированный документ и заменяет предыдущую версию. См. официальное руководство по интеграции ONLYOFFICE с Nextcloud и описание API ONLYOFFICE для интеграции с Nextcloud .
Подтверждено: некорректный или недоступный путь обратного вызова может привести к ошибке сохранения, даже если редактор открыт. В документации по устранению неполадок ONLYOFFICE администраторам прямо рекомендуется проверять журналы DocService и убедиться в доступности URL-адреса обратного вызова при возникновении ошибки сохранения. Действие: не начинайте с переустановки редактора или очистки кэша браузера; сначала проверьте путь между серверами.
На хосте Nextcloud выполните проверку коннектора ONLYOFFICE от имени пользователя веб-сервера. В типичной установке Debian или Ubuntu:
cd /var/www/nextcloud
sudo -E -u www-data php occ onlyoffice:documentserver --checkТочный путь к Nextcloud и пользователь HTTP могут отличаться в зависимости от дистрибутива или конфигурации контейнера. В руководстве администратора Nextcloud рекомендуется запускать программу occот имени пользователя HTTP, чтобы обеспечить согласованность прав собственности на файлы. Документы ONLYOFFICE occ onlyoffice:documentserver --checkиспользуются для проверки подключения коннектора.
Что это доказывает: это может выявить очевидную ошибку конфигурации или подключения к серверу документов. Что это не доказывает: каждый обратный вызов, сгенерированный во время реального сеанса редактирования, будет успешно выполнен через любой прокси-сервер, DNS-маршрут и уровень аутентификации. Действие: если проверка пройдена, но сохранение по-прежнему не удается, перейдите к обратному вызову и запишите данные в журнал, вместо того чтобы объявлять интеграцию работоспособной.
В Nextcloud откройте «Настройки» → «Администрирование» → «ONLYOFFICE» . Основной адрес ONLYOFFICE Docs должен быть доступен для соответствующих клиентов и служб. Если публичные URL-адреса недоступны внутри сети из-за сетевых настроек Docker, NAT, разделенного горизонта DNS или политики брандмауэра, разверните расширенные настройки сервера.
Официальный коннектор предоставляет отдельные внутренние адреса именно для таких ситуаций:
Например, два контейнера в одной и той же сети Compose могут использовать имена служб внутри себя, в то время как браузеры по-прежнему используют общедоступные имена хостов HTTPS. Не копируйте этот шаблон слепо: имена должны фактически разрешаться в вашей сети. Действие: проверьте каждое направление с машины или контейнера, который инициирует запрос.
Этот вывод ненадежен. Браузер, Nextcloud и ONLYOFFICE Docs — три разных участника сети. Браузер может связаться с ONLYOFFICE, office.example.comв то время как контейнер Document Server не может разрешить или подключиться к нему cloud.example.com. Аналогично, Nextcloud может связаться с ONLYOFFICE через внутреннее имя хоста, в то время как функция обратного вызова указывает на недоступный публичный адрес.
Действие: войдите в контейнер или на хост ONLYOFFICE и проверьте адрес Nextcloud, который он должен использовать. Базовый HTTPS-запрос к хосту Nextcloud может подтвердить доступность DNS/TCP/TLS, но помните, что успешный status.phpзапрос не подтверждает реальную авторизацию обратного вызова или обработку POST-запросов.
JWT — ещё один распространённый источник путаницы. Начиная с ONLYOFFICE Docs 7.2, JWT включен по умолчанию, и секретный ключ генерируется автоматически. В официальных инструкциях требуется один и тот же секретный ключ как на сервере документов, так и в коннекторе Nextcloud ONLYOFFICE. В текущей документации к коннектору также указана настройка заголовка авторизации для установок, которые не используют заголовок по умолчанию.
Подтверждено: общий секретный ключ должен совпадать. Зависит от развертывания: точное место управления зависит от того, установлен ли ONLYOFFICE из пакетов, в Windows или в Docker. В развертываниях Docker JWT_SECRETобычно используется переменная среды; эффективную конфигурацию сервера также можно проверить в /etc/onlyoffice/documentserver/local.json.
Действие: сравните эффективные настройки секрета и заголовка с обеих сторон, затем перезапустите службы ONLYOFFICE или контейнер после внесения изменений на стороне сервера. Не «исправляйте» проблему, навсегда отключая JWT; это удаляет элемент безопасности вместо исправления конфигурации. Подробности см. в руководстве по настройке JWT в ONLYOFFICE .
ONLYOFFICE рекомендует проверять логи DocService на наличие ошибок сохранения. Для установок Linux и Docker логи Document Server находятся в папке /var/log/onlyoffice/documentserver; пользователи Docker также могут отслеживать вывод контейнера с помощью команды docker logs -f <container>. Если необходима более подробная информация, ONLYOFFICE описывает временный режим отладки с помощью команды DS_LOG_LEVEL=DEBUGили конфигурации log4js. См. официальное руководство по ведению отладочных логов .
В Nextcloud файлы журналов по умолчанию обычно находятся nextcloud.logв указанном каталоге данных. Активный путь можно узнать с помощью следующей команды:
sudo -E -u www-data php occ log:fileNextcloud также документирует log:tail, log:watchкогда доступно приложение Log Reader. Действие: воспроизведите одну ошибку сохранения, запишите метку времени, затем сопоставьте обе стороны. Сетевой отказ, ошибка TLS, ответ 401/403, ответ 5xx или исключение хранилища указывают на совершенно разные способы решения проблемы.
Самоподписанный или выданный частными лицами сертификат может нарушить HTTPS-соединение между серверами, если соответствующий центр сертификации не является доверенным. Коннектор имеет опцию «Отключить проверку сертификата (небезопасно)» , но ONLYOFFICE явно описывает её как небезопасную и рекомендует заменить сертификат на сертификат, выданный доверенным центром сертификации. Действие: используйте обход проверки сертификата только в качестве короткого диагностического шага в контролируемой среде; надежным решением является действительная цепочка сертификатов, которой доверяют оба сервера.
Если перед ONLYOFFICE используется обратный прокси-сервер, убедитесь, что он сохраняет ожидаемую схему, хост и поведение при обновлении. ONLYOFFICE публикует специальные рекомендации по настройке обратного прокси-сервера, включая пересылаемые заголовки и настройки, связанные с WebSocket. См. руководство по настройке обратного прокси-сервера Nextcloud от ONLYOFFICE .
Зависит от развертывания: точную конфигурацию Nginx, Apache, Traefik, HAProxy, ingress-controller или CDN нельзя определить только по ошибке сохранения. Действие: сравните конфигурацию вашего прокси с примером конфигурации поставщика для вашей топологии и изучите HTTP-статус, записанный во время обратного вызова, прежде чем произвольно изменять тайм-ауты или заголовки.
Как только журналы подтвердят, что обратный вызов успешно достиг Nextcloud, переходите к следующему шагу в стеке. Nextcloud должен иметь возможность получить новый документ и заменить сохраненную версию. Локальные права доступа к файловой системе, монтирование только для чтения, исчерпание дискового пространства, ограничения квоты, недоступность внешнего хранилища или исключение приложения/хранилища — все это может помешать окончательной записи.
Известно следующее: значения статуса обратного вызова ONLYOFFICE позволяют отличить документ, готовый к сохранению, от документа с ошибкой сохранения, а обратный вызов содержит URL-адрес отредактированного документа, который служба хранения должна получить. В официальной документации по обработчику обратных вызовов статус 2 определяется как готовность к сохранению, а статус 3 — как ошибка сохранения.
Из сообщения браузера неясно, произошла ли ошибка в ONLYOFFICE, по сетевому пути, в Nextcloud или в базовом хранилище. Действие: не следует рекурсивно изменять права доступа к файлам в каталоге данных Nextcloud только потому, что редактор сообщает о невозможности сохранения. Сначала подтвердите наличие ошибки на стороне хранилища в журнале Nextcloud.
Ещё одно распространённое заблуждение заключается в том, что каждое нажатие кнопки «Сохранить» немедленно заменяет файл, сохранённый Nextcloud. Коннектор может использовать опцию промежуточного сохранения или принудительного сохранения. В официальном руководстве по интеграции говорится, что если включена опция «Сохранять промежуточные версии при редактировании (принудительное сохранение)» , то нажатие кнопки «Сохранить» отправляет изменения непосредственно в хранилище; в противном случае изменения сохраняются в кэше редактора, и позже происходит обычное окончательное сохранение.
Это важно для устранения неполадок. Если не удаётся только принудительное сохранение, а обычное закрытие и сохранение завершаются успешно, или наоборот, метки времени и статусы обратного вызова становятся ценными доказательствами. Действие: воспроизведите ошибку в одном чётко определённом рабочем процессе и соберите журналы этой попытки, вместо того чтобы смешивать ручное сохранение, закрытие браузера и несколько одновременно открытых вкладок редактора.
| Симптом | Наиболее полезная следующая проверка | Не делайте предположений |
|---|---|---|
| Редактор вообще не открывается | URL-адрес сервера документов, JWT, доступность браузера/сервера. | Проблема заключается только в сохранении. |
| Редактор открывается, но сохранение не удается. | Доступность обратных вызовов и журналы DocService | Успешное начало доказывает наличие пути назад. |
| 401/403 в связи с трафиком обратного вызова или команд. | Секретный ключ JWT и заголовок авторизации | Причиной является истечение времени ожидания прокси-сервера. |
| Ошибки проверки TLS/сертификата | Сети сертификатов и трастовые магазины | Отключение проверки — это окончательное решение проблемы. |
| Функция обратного вызова достигает Nextcloud, но файл остается неизмененным. | Журналы Nextcloud, монтирование хранилища, квоты, ошибки записи. | В OnlyOffice не удалось внести правки. |
| Сбои происходят только при использовании прокси/NAT. | Расширенные внутренние URL-адреса и переадресация. | Это означает, что публичные URL-адреса работают одинаково внутри контейнеров. |
Используйте небольшой тестовый файл DOCX в некритичной папке. Откройте его в ONLYOFFICE, введите уникальную строку, например, метку времени, дождитесь, пока редактор сообщит о сохранении изменения, затем закройте редактор обычным способом. Снова откройте файл в Nextcloud и убедитесь, что текст присутствует. Затем проверьте историю версий, если она используется в вашей системе развертывания, и проверьте журналы сервера за тот же временной интервал.
Затем снова выполните проверку соединения:
sudo -E -u www-data php occ onlyoffice:documentserver --checkХороший результат — это не просто «редактор открывается». Полный тест включает в себя следующее: Nextcloud может связаться с ONLYOFFICE, ONLYOFFICE может связаться с адресом обратного вызова в Nextcloud, аутентификация проходит успешно, Nextcloud может получить обновленный файл, и хранилище принимает замену.
Если ни один из журналов не показывает очевидной ошибки, временно увеличьте уровень логирования ONLYOFFICE и Nextcloud во время одного контролируемого воспроизведения, а затем верните уровень логирования к нормальному. Nextcloud предупреждает, что логирование DEBUG является подробным и может повлиять на производительность, поэтому его следует использовать в качестве диагностической меры, а не в качестве постоянной настройки в производственной среде. Перед изменением уровня логирования ознакомьтесь с документацией Nextcloud по логированию .
На этом этапе необходимо сохранить точные метки времени, коды состояния HTTP, версию коннектора, версию Nextcloud, версию ONLYOFFICE Docs, топологию и соответствующие отредактированные строки логов. Эти данные гораздо полезнее, чем стандартное сообщение браузера «Не удалось сохранить документ».
Подключите настольные редакторы ONLYOFFICE к своему облачному серверу, войдите в систему, открывайте файлы в облаке, управляйте подключением и устраняйте распространенные проблемы с настройкой.
Для устранения неполадок, связанных с высокой загрузкой ЦП в Collabora Online, необходимо выявить процессы, активно использующие комплект инструментов, проверить метрики и журналы, настроить параллелизм и очистку, а также безопасно проверить исправления.
Learn how to custom brand ONLYOFFICE Docs with a header logo and interface colors, including license limits, theme JSON setup, Docker paths, and testing.
Исправьте трудночитаемый текст в LibreOffice Calc, проверив тему приложения, шрифт и цвет заливки ячеек, стили и условное форматирование, а затем проверьте вывод на печать.
Безопасно устраните предупреждение LibreOffice о блокировке от неизвестного пользователя. Проверьте активные сеансы, защитите копию, удалите только проверенную устаревшую блокировку и протестируйте документ.
Исправьте некорректное отображение, выравнивание или смешивание арабского или ивритского текста с английским в LibreOffice Writer. Включите сложную компоновку текста, задайте направление абзаца и проверьте результат.
Learn VLOOKUP and XLOOKUP in LibreOffice Calc, including exact matches, left lookups, not-found results, reverse search, INDEX/MATCH alternatives, and common errors.
Для устранения неполадок, связанных с ошибками проверки подлинности WOPI в Collabora Online, проверьте ключи обнаружения, ротацию ключей, URL-адреса прокси-серверов, метки времени и списки разрешенных хостов.
Включите функцию отслеживания изменений для всех пользователей в документе ONLYOFFICE, сохраните её активность после повторного открытия и ознакомьтесь с ограничениями глобальных настроек по умолчанию.
Сравните значения таймаутов для каждого представления, нерезкости, простоя документа, автосохранения и прокси-сервера в Collabora Online, а затем выберите и проверьте настройки для вашей системы.
