Что проверить, если при открытии веб-страницы ownCloud отображается пустая страница?

Если ownCloud Web открывается на белой странице, сначала попробуйте тот же URL-адрес в приватном окне и в поддерживаемом браузере. Если это по-прежнему не удается, откройте инструменты разработчика браузера и проверьте панели «Консоль» и «Сеть»; используйте неудачный запрос, чтобы решить, следует ли очистить данные сайта в браузере, восстановить отсутствующий веб-ресурс или проверить службы Infinite Scale и обратного прокси. Избегайте удаления данных сервера или переустановки экземпляра до этой проверки.

ownCloud Web — это веб-интерфейс, поставляемый с Infinite Scale, хотя администраторы могут заменить его скомпилированные ресурсы собственной сборкой. Таким образом, пустая страница может появиться из-за ошибок в браузере, отсутствия или несоответствия JavaScript-ресурса, или ответа сервера/прокси, который препятствует загрузке интерфейса. Ниже описаны шаги по разграничению этих случаев. Панели интерфейса являются иллюстративными примерами; сравните их с фактическим результатом работы браузера и развертывания.

1. Выясните, является ли проблема локальной или затрагивает весь сервер.

Попросите еще одного пользователя открыть тот же общедоступный URL-адрес, а сами попробуйте в приватном окне. Например, если один сотрудник видит пустую страницу, а другой может просматривать файлы, начните с проверки причин, связанных с браузером. Если все видят одну и ту же страницу, переходите непосредственно к проверке сети и сервера.

  1. Используйте браузер для настольных компьютеров, поддерживаемый ownCloud Web. На странице текущих требований указаны последние версии Chrome, Firefox и Edge, а также Safari 16 или более поздняя версия для поддерживаемых настольных операционных систем.
  2. Откройте экземпляр в приватном окне. Если интерфейс загрузится в этом режиме, отключайте расширения по одному в обычном профиле, затем очистите данные сайта только для имени хоста ownCloud. Очистка данных сайта может привести к выходу из системы; она не удаляет файлы, хранящиеся на сервере.
  3. Обновите пустую страницу, отключив кэширование браузера и открыв инструменты разработчика. Если та же ошибка сохраняется в нескольких поддерживаемых браузерах и у разных пользователей, более вероятна проблема на стороне сервера или развертывания.

Иллюстративный пример окна браузера, показывающий совершенно пустую белую страницу по адресу, указанному в качестве примера имени хоста облачного сервиса.

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

2. Используйте неудачный запрос для выбора способа исправления.

Откройте инструменты разработчика (обычно F12 или Ctrl+Shift+I в Windows/Linux, или Option+Command+I в macOS). Выберите «Консоль» , чтобы увидеть ошибки JavaScript, затем выберите «Сеть» , перезагрузите страницу и найдите неудачные запросы. Код состояния и тип запроса гораздо полезнее, чем просто белый экран.

  • Запрос JavaScript или CSS возвращает ошибку 404: браузер запросил ресурс, который не найден по указанному URL. Если это происходит только в одном профиле браузера, очистите кэшированные файлы этого сайта и перезагрузите страницу. Если тот же ресурс недоступен для всех, проверьте путь к ресурсу, маршрутизацию обратного прокси и любые пользовательские настройки веб-сайта.
  • Запрос возвращает коды 502, 503 или ошибку подключения: прокси-сервер не смог получить пригодный для использования ответ от вышестоящего сервиса, или сервис был недоступен. Перед изменением настроек браузера проверьте состояние развертывания и журналы.
  • В консоли отображается сообщение о заблокированном запросе, ошибке сертификата или предупреждении о смешанном содержимом: сравните публичное имя хоста и схему HTTPS, используемые браузером, с URL-адресом и конфигурацией прокси. Если вы недавно изменили домен, завершение TLS или правила прокси, сначала проверьте это изменение.
  • Страница загружает ресурсы с ответом 200, но JavaScript по-прежнему не работает: запишите первую ошибку в консоли и версии ownCloud Web/Infinite Scale. Синтаксическая ошибка или ошибка выполнения может указывать на несовместимую пользовательскую сборку или расширение; не делайте вывод об этом, основываясь только на ответе 200.

Наглядный пример консоли инструментов разработчика браузера, демонстрирующий ошибку 404 для JavaScript-файла.

Пример диагностической иллюстрации: ошибка 404 для JavaScript-файла указывает на необходимость проверки URL-адреса и пути доступа к файлу, а не является доказательством конкретной причины проблемы.

3. Проверьте состояние веб-ресурсов и сервисов.

Если неудачный запрос связан с ресурсом, сначала выясните, использует ли ваш экземпляр встроенные веб-файлы ownCloud или файлы, скомпилированные пользователем. В руководстве администратора ownCloud 8.2 указано, WEB_ASSET_PATHчто путь указывает на пользовательские скомпилированные ресурсы веб-клиента. Если вы его задали, убедитесь, что путь существует внутри запущенного развертывания, содержит полную сборку и доступен для чтения процессом, обслуживающим веб-интерфейс. Если вы не используете пользовательские ресурсы, не добавляйте эту переменную в качестве предварительного исправления.

Для развертывания с помощью Docker Compose выполните следующие команды из каталога, содержащего файл Compose:

docker compose ps
docker compose logs --tail=100 ocis

Первая команда показывает, запущены ли службы; вторая выводит последние логи для службы с именем ocis. Если в вашем файле Compose используется другое имя службы или интерфейс запускается отдельно, замените его фактическим именем службы и также проверьте логи прокси/интерфейса. Для развертывания, установленного вручную или с помощью оркестрации, используйте вместо этого команды службы и логирования соответствующей платформы. Ищите ошибки запуска, ошибки пути к ресурсам или ошибки подключения к вышестоящему серверу во время неудачной загрузки страницы.

Иллюстративный терминал, демонстрирующий команды docker compose ps и docker compose logs без примера вывода.

Иллюстрация двух проверок Compose; фактические имена служб и сообщения журналов различаются в зависимости от развертывания.

4. Проверьте публичный URL-адрес и маршрут прокси-сервера.

Если запросы указывают на старое имя хоста, неправильную схему или путь, который прокси-сервер не обслуживает, проверьте конфигурацию общедоступного URL-адреса и правила прокси. ownCloud указывает OCIS_URLURL-адрес, используемый для определения способа доступа к Infinite Scale. В развертывании с использованием обратного прокси-сервера убедитесь, что адрес HTTPS, доступный из браузера, имя DNS и правила маршрутизации соответствуют настроенному общедоступному URL-адресу. Если прокси-сервер или домен были недавно изменены, сравните текущую конфигурацию с последней рабочей версией и исправьте только несоответствующее значение.

Проверяйте WEB_ASSET_PATHтолько при наличии настроенных пользовательских ресурсов. Проверяйте OCIS_URLнастройки прокси/TLS, если браузер перенаправляется на неожиданный хост или запрашивает ресурсы из неправильного источника. Эти настройки различаются в зависимости от развертывания, поэтому не следует вставлять стандартное значение в рабочую среду. Официальное руководство по настройке пользовательских ресурсов ownCloud Web , документация по прокси-сервису и руководство по TLS описывают эти области конфигурации.

Иллюстративный редактор конфигурации, выделяющий переменные WEB_ASSET_PATH и OCIS_URL для проверок развертывания.

Иллюстрация значений конфигурации для проверки; правильные значения зависят от общедоступного URL-адреса и от того, используются ли пользовательские ресурсы.

Проверьте исправление

Перезагрузите сайт в обычном окне браузера и убедитесь, что интерфейс отображается корректно, в консоли нет блокирующих ошибок JavaScript, а необходимые запросы JavaScript/CSS больше не возвращают ответы 404 или 5xx. Попросите второго пользователя проверить тот же публичный адрес. Если страница по-прежнему пустая, хотя ресурсы загружаются успешно, сохраните первое сообщение об ошибке в консоли, подробности неудачного запроса, версию Infinite Scale и соответствующие журналы службы для вашего администратора или службы поддержки ownCloud. Перед тем как делиться данными из браузера, удалите файлы cookie, заголовки авторизации и токены.

Оставить комментарий

Предотвратите тайм-ауты блокировки файлов в ownCloud с помощью подходящей серверной части.

Различите конфликты блокировок базы данных от истекших блокировок WebDAV, затем выберите и настройте подходящее решение для ownCloud 10.

Что проверить, если при открытии веб-страницы ownCloud отображается пустая страница?

Что проверить, если при открытии веб-страницы ownCloud отображается пустая страница?

С помощью целенаправленных проверок можно выявить причину появления пустого экрана ownCloud Web: кэш браузера, отсутствующие веб-ресурсы, ошибки сервиса или настройки URL-адреса обратного прокси-сервера.

Устраните предупреждение о нехватке памяти PHP в ownCloud в соответствующей среде выполнения.

Установите ограничение на использование памяти PHP в веб-версии ownCloud, перезапустите соответствующий сервис и проверьте активное значение, не путая его с настройками CLI или ограничениями на загрузку.

Устранение неполадок с подключением к MySQL в ownCloud 10

Выясните, блокируют ли ownCloud 10 MySQL, PHP, настройки сокетов или права доступа к базе данных, а затем проверьте, можно ли устранить проблему безопасным способом.

Установите жесткий лимит истечения срока действия для публичных ссылок ownCloud.

Установите жесткий лимит истечения срока действия для публичных ссылок ownCloud.

Сделайте обязательным истечение срока действия публичных ссылок в ownCloud Classic, установите максимальный срок действия и проверяйте существующие общие ресурсы, которые могут потребовать отдельной очистки.

Добавьте двухфакторную аутентификацию TOTP в ownCloud Infinite Scale с помощью Keycloak.

Добавьте двухфакторную аутентификацию TOTP в ownCloud Infinite Scale с помощью Keycloak.

Включите TOTP через Keycloak, безопасно регистрируйте пользователей и понимайте, когда применяются настройки многофакторной аутентификации на уровне маршрутов Infinite Scale.

Восстановите синхронизацию ownCloud, сопоставив клиент с вашим сервером.

Проверьте, не связана ли проблема с нарушением совместимости OC10 и 7.x или с повреждением журнала CSync, затем примените соответствующее исправление, не удаляя синхронизированные файлы.

Разверните ownCloud на HTTPS с помощью Let's Encrypt и Nginx.

Разверните ownCloud на HTTPS с помощью Let's Encrypt и Nginx.

Выберите HTTP-01 или DNS-01, настройте обратный прокси-сервер ownCloud и убедитесь, что Certbot автоматически обновляет сертификаты HTTPS.

Подключите ownCloud Infinite Scale к LDAP для входа пользователей в систему.

Перед развертыванием настройте вход в систему oCIS LDAP, согласуйте поиск пользователей и групп, а также проверьте настройки TLS и схемы.

Подключите S3-хранилище к ownCloud 10 в качестве внешнего хранилища.

Подключите S3-хранилище к ownCloud 10 в качестве внешнего хранилища.

Добавьте корзину Amazon S3 в ownCloud 10, подготовьте совместимые учетные данные и конечные точки, а также проверьте доступ, не путая монтирование с основным хранилищем.