Que vérifier lorsque ownCloud Web s'ouvre sur une page blanche

Si ownCloud Web affiche une page blanche, essayez d'abord d'accéder à la même URL dans une fenêtre de navigation privée avec un navigateur compatible. Si le problème persiste, ouvrez les outils de développement du navigateur et consultez les panneaux Console et Réseau. Utilisez la requête ayant échoué pour déterminer s'il convient d'effacer les données du site, de réparer une ressource web manquante ou d'examiner les services Infinite Scale et de proxy inverse. Évitez de supprimer les données du serveur ou de réinstaller l'instance avant d'avoir effectué cette vérification.

ownCloud Web est l'interface web fournie avec Infinite Scale, mais les administrateurs peuvent remplacer ses ressources compilées par une version personnalisée. Une page blanche peut donc provenir du navigateur, d'une ressource JavaScript manquante ou incompatible, ou d'une réponse du serveur/proxy empêchant le chargement de l'interface. Les étapes ci-dessous permettent de distinguer ces cas. Les panneaux d'interface sont des exemples illustratifs ; comparez-les avec le résultat affiché dans le navigateur et le déploiement.

1. Déterminez si le problème est local ou global (au niveau du serveur).

Demandez à un autre utilisateur d'ouvrir la même URL publique, puis essayez vous-même dans une fenêtre de navigation privée. Par exemple, si un employé voit une page blanche tandis qu'un collègue peut parcourir les fichiers, commencez par vérifier les problèmes liés au navigateur. Si tout le monde voit la même page, passez directement aux vérifications du réseau et du serveur.

  1. Utilisez un navigateur de bureau compatible avec ownCloud Web. La page des exigences actuelles répertorie les versions récentes de Chrome, Firefox et Edge, ainsi que Safari 16 ou version ultérieure, sur les systèmes d'exploitation de bureau compatibles.
  2. Ouvrez l'instance dans une fenêtre de navigation privée. Si l'interface s'affiche, désactivez les extensions une par une dans votre profil habituel, puis effacez les données du site uniquement pour le nom d'hôte ownCloud. L'effacement des données du site peut vous déconnecter ; il ne supprime pas les fichiers stockés sur le serveur.
  3. Actualisez la page blanche en désactivant le cache du navigateur et en laissant les outils de développement ouverts. Si le problème persiste sur plusieurs navigateurs compatibles et pour plusieurs utilisateurs, il s'agit probablement d'un problème côté serveur ou de déploiement.

Fenêtre de navigateur illustrant une page blanche entièrement vide à l'adresse d'hôte cloud de l'exemple

Illustration du symptôme : un navigateur a accédé au serveur cloud, mais la zone de contenu de la page reste vide.

2. Utilisez la requête ayant échoué pour choisir une solution.

Ouvrez les outils de développement (généralement F12 ou Ctrl+Maj+I sous Windows/Linux, ou Option+Commande+I sous macOS). Sélectionnez Console pour afficher les erreurs JavaScript, puis Réseau , rechargez la page et recherchez les requêtes ayant échoué. Le code d'état et le type de requête sont plus utiles qu'un écran blanc.

  • Une requête JavaScript ou CSS renvoie une erreur 404 : le navigateur a demandé une ressource introuvable à cette URL. Si ce problème se produit uniquement dans un profil de navigateur, videz le cache du site et rechargez la page. Si la même ressource est inaccessible pour tous les navigateurs, vérifiez son chemin d'accès, le routage du proxy inverse et toute configuration web personnalisée.
  • Une requête renvoie une erreur 502, 503 ou une erreur de connexion : le proxy n’a pas pu obtenir de réponse exploitable du service en amont, ou le service était indisponible. Consultez l’état du déploiement et les journaux avant de modifier les paramètres de votre navigateur.
  • La console signale une requête bloquée, une erreur de certificat ou un avertissement de contenu mixte : comparez le nom d’hôte public et le protocole HTTPS utilisés par le navigateur avec l’URL et la configuration du proxy. Si vous avez récemment modifié le domaine, la terminaison TLS ou les règles du proxy, testez d’abord cette modification.
  • La page charge les ressources avec des réponses 200, mais JavaScript échoue toujours : notez la première erreur de la console et les versions d’ownCloud Web/Infinite Scale. Une erreur de syntaxe ou d’exécution peut indiquer une configuration personnalisée ou une extension incompatible ; ne tirez pas cette conclusion d’une simple réponse 200.

Console des outils de développement du navigateur (à titre d'illustration) montrant un exemple de réponse 404 pour une ressource JavaScript

Exemple d'illustration de diagnostic : une erreur 404 pour une ressource JavaScript est un indice permettant de vérifier l'URL et le chemin de diffusion de la ressource, et non la preuve d'une cause particulière.

3. Vérifier l'état des ressources web et des services

Si la requête ayant échoué concerne une ressource, commencez par déterminer si votre instance utilise les fichiers Web ownCloud fournis ou des fichiers compilés personnalisés. Le guide d'administration d'ownCloud 8.2 indique WEB_ASSET_PATHque cette variable fait référence aux ressources client Web compilées personnalisées. Si vous l'avez définie, vérifiez que le chemin d'accès existe dans le déploiement en cours d'exécution, qu'il contient la version complète et qu'il est accessible en lecture par le processus hébergeant l'interface Web. Si vous n'utilisez pas de ressources personnalisées, n'ajoutez pas cette variable à titre de solution de contournement.

Pour un déploiement Docker Compose, exécutez ces commandes depuis le répertoire contenant le fichier Compose :

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

La première commande indique si les services sont en cours d'exécution ; la seconde affiche les journaux récents du service spécifié ocis. Si votre fichier Compose utilise un nom de service différent ou exécute l'interface utilisateur séparément, remplacez le nom du service par le nom réel et consultez également les journaux du proxy/de l'interface utilisateur. Pour un déploiement installé manuellement ou orchestré, utilisez plutôt les commandes de service et de journalisation de la plateforme. Recherchez les échecs de démarrage, les erreurs de chemin d'accès aux ressources ou les erreurs de connexion en amont au moment de l'échec de chargement de la page.

Terminal illustratif montrant les commandes `docker compose ps` et `docker compose logs` sans exemple de sortie.

Illustration des deux vérifications Compose ; les noms de service et les messages de journalisation réels varient selon le déploiement.

4. Vérifiez l'URL publique et la route du proxy

Si les requêtes pointent vers un ancien nom d'hôte, un schéma incorrect ou un chemin non pris en charge par le proxy, vérifiez la configuration de l'URL publique et les règles du proxy. La documentation ownCloud OCIS_URLindique l'URL utilisée pour définir l'accès à Infinite Scale. Dans un déploiement utilisant un proxy inverse, assurez-vous que l'adresse HTTPS accessible depuis le navigateur, le nom DNS et les règles de routage correspondent à l'URL publique configurée. Si le proxy ou le domaine a été modifié récemment, comparez la configuration actuelle avec la dernière version fonctionnelle et corrigez uniquement la valeur incorrecte.

Vérifiez WEB_ASSET_PATHuniquement si des ressources personnalisées sont configurées. Contrôlez OCIS_URLles paramètres proxy/TLS lorsque le navigateur est redirigé vers un hôte inattendu ou demande des ressources provenant d'une origine incorrecte. Ces paramètres varient selon le déploiement ; n'utilisez donc pas de valeur générique en production. Le guide officiel des ressources personnalisées d'ownCloud Web , la documentation du service proxy et le guide TLS décrivent ces paramètres de configuration.

Éditeur de configuration illustratif mettant en évidence WEB_ASSET_PATH et OCIS_URL pour les vérifications de déploiement

Illustration des valeurs de configuration à examiner ; les valeurs correctes dépendent de l’URL publique et de l’utilisation ou non de ressources personnalisées.

Vérifier la correction

Rechargez le site dans une fenêtre de navigateur classique et vérifiez que l'interface s'affiche correctement, qu'aucune erreur JavaScript bloquante n'apparaît dans la console et que les requêtes JavaScript/CSS requises ne renvoient plus d'erreurs 404 ou 5xx. Demandez à un deuxième utilisateur de tester la même adresse publique. Si la page reste blanche malgré le chargement réussi des ressources, conservez la première erreur de la console, les détails de la requête ayant échoué, la version d'Infinite Scale et les journaux de service pertinents pour votre administrateur ou le support ownCloud. Masquez les cookies, les en-têtes d'autorisation et les jetons avant de partager les captures de navigateur.

Laisser un commentaire

Évitez les délais d'expiration de verrouillage de fichiers ownCloud grâce au bon backend

Distinguez les conflits de verrouillage de base de données des verrous WebDAV expirés, puis choisissez et configurez le correctif ownCloud 10 approprié.

Que vérifier lorsque ownCloud Web s'ouvre sur une page blanche

Que vérifier lorsque ownCloud Web s'ouvre sur une page blanche

Identifiez les causes d'un écran web ownCloud vide grâce à des vérifications ciblées : cache du navigateur, ressources web manquantes, erreurs de service ou paramètres d'URL du proxy inverse.

Effacer l'avertissement de mémoire PHP ownCloud dans le contexte d'exécution approprié

Définissez la limite de mémoire PHP web d'ownCloud, redémarrez le service correspondant et vérifiez la valeur active sans la confondre avec les paramètres de l'interface de ligne de commande ou les limites de téléchargement.

Résolution des problèmes de connexion MySQL à ownCloud 10

Découvrez si MySQL, PHP, les paramètres de socket ou les autorisations de base de données bloquent ownCloud 10, puis vérifiez une solution sûre.

Définissez une date d'expiration précise pour les liens publics ownCloud

Définissez une date d'expiration précise pour les liens publics ownCloud

Rendez obligatoire l'expiration des liens publics dans ownCloud Classic, définissez une durée de vie maximale et vérifiez les partages existants qui pourraient nécessiter un nettoyage séparé.

Ajoutez l'authentification à deux facteurs TOTP à ownCloud Infinite Scale avec Keycloak

Ajoutez l'authentification à deux facteurs TOTP à ownCloud Infinite Scale avec Keycloak

Activez le protocole TOTP via Keycloak, inscrivez les utilisateurs en toute sécurité et comprenez quand les paramètres MFA au niveau du routage d'Infinite Scale s'appliquent.

Rétablissez la synchronisation ownCloud en associant le client à votre serveur.

Vérifiez si le problème provient d'une incompatibilité entre OC10 et 7.x ou d'un journal CSync endommagé, puis appliquez le correctif approprié sans supprimer les fichiers synchronisés.

Sécurisez ownCloud avec HTTPS grâce à Let's Encrypt et Nginx.

Sécurisez ownCloud avec HTTPS grâce à Let's Encrypt et Nginx.

Choisissez HTTP-01 ou DNS-01, configurez un proxy inverse ownCloud et vérifiez que Certbot renouvelle automatiquement les certificats HTTPS.

Connectez ownCloud Infinite Scale à LDAP pour l'authentification des utilisateurs

Configurez la connexion LDAP oCIS, alignez les recherches d'utilisateurs et de groupes et vérifiez les paramètres TLS et de schéma avant le déploiement.

Connectez un compartiment S3 à ownCloud 10 en tant que stockage externe.

Connectez un compartiment S3 à ownCloud 10 en tant que stockage externe.

Ajoutez un compartiment Amazon S3 à ownCloud 10, préparez les identifiants et les points de terminaison compatibles, et vérifiez l'accès sans confondre un montage avec le stockage principal.