Commencez par vérifier que le navigateur, Nextcloud et Collabora peuvent tous accéder aux URL du serveur via le même protocole HTTP ou HTTPS. Dans Nextcloud, testez les points de terminaison de Collabora/hosting/capabilities ; /hosting/discoverys’ils répondent mais que les documents ne sont toujours pas accessibles, vérifiez la route WebSocket du proxy inverse et la liste blanche WOPI.
Le message « C'est embarrassant » indique une erreur d'ouverture de document générique et ne constitue pas un diagnostic en soi. La cause peut être une URL inaccessible, une incompatibilité TLS ou DNS, un proxy bloquant les mises à jour WebSocket ou un hôte WOPI non approuvé par Collabora ou Nextcloud. Les vérifications ci-dessous utilisent un exemple typique avec Nextcloud à l'adresse https://cloud.example.comet Collabora à l'adressehttps://office.example.com ; remplacez ces noms par vos noms d'hôtes réels.
Depuis un navigateur situé sur le même réseau que l'utilisateur, ouvrez ces URL en modifiant le nom d'hôte Collabora :
https://office.example.com/hosting/capabilitieshttps://office.example.com/hosting/discoveryIls devraient renvoyer des données du point de terminaison Collabora plutôt qu'un avertissement de certificat du navigateur, une page 404 ou une erreur de proxy inverse. Le point de terminaison de découverte renvoie normalement du XML. Vous pouvez également effectuer des tests depuis l'hôte Nextcloud ou son conteneur d'application :
curl -fsS https://office.example.com/hosting/capabilities
curl -fsS https://office.example.com/hosting/discoveryUne erreur du navigateur indique un problème de DNS public ou local, de pare-feu, de certificat ou de routage proxy. Si le navigateur réussit mais que Nextcloud échoue en ligne de commande, cela signifie que le chemin d'accès côté serveur diffère : le navigateur de l'utilisateur et le serveur Nextcloud doivent chacun avoir leur propre chemin d'accès à Collabora. Le manuel d'administration actuel de Nextcloud recommande de tester les deux points de terminaison depuis les deux emplacements et de vérifier que Collabora peut également accéder à Nextcloud via HTTP(S).
Dans Nextcloud, ouvrez Paramètres → Administration → Office et vérifiez que le champ Serveur Collabora Online contient l'URL publique ou accessible de Collabora. Utilisez cette URL https://si le service est configuré pour HTTPS. La documentation de Nextcloud indique que l'URL configurée doit utiliser le même protocole que l'installation de Collabora et recommande HTTPS.
Vérifiez maintenant le chemin de retour. Depuis l'hôte ou le conteneur Collabora, interrogez le point de terminaison d'état de Nextcloud :
curl -fsS https://cloud.example.com/status.phpLa réponse doit être accessible depuis Collabora, et pas seulement depuis votre ordinateur portable. Si l'un des serveurs est dans un conteneur Docker, effectuez le test depuis le conteneur ou l'espace de noms réseau concerné : un nom d'hôte résolu sur l'hôte peut ne pas l'être à l'intérieur d'un conteneur. Pour un serveur CODE intégré, Nextcloud doit pouvoir s'accéder à lui-même via le même nom d'hôte que celui utilisé par les utilisateurs dans leur navigateur. Si une configuration DNS fractionnée ou une résolution de noms locale empêche cela, corrigez la configuration DNS ou le mappage d'hôte au lieu de saisir l'adresse localhostd'un service distant.
Si l'URL de découverte se charge mais que la fenêtre de l'éditeur reste vide, tourne en boucle ou se déconnecte, vérifiez le proxy devant Collabora. L'édition utilise une connexion WebSocket persistante : le proxy doit acheminer le /cool/…/wspoint de terminaison actuel de Collabora vers le service Collabora et transmettre les en-têtes HTTP/1.1 Upgrade. Consultez l'exemple de proxy Collabora actuel pour votre logiciel et version de proxy ; ne copiez pas une ancienne configuration sans la modifier.
Les installations plus anciennes peuvent encore utiliser des chemins d'accès tels que `/ etc/ proxy` /lool. Le guide de migration de Collabora documente le passage de `/etc lool/ proxy` à `/etc/proxy` et de `/etc/proxy` à `/ etc/proxy` . Un proxy configuré sur les anciennes routes peut renvoyer des erreurs 404 même lorsque le domaine de base est accessible. Après avoir modifié un fichier proxy, vérifiez sa syntaxe avec la commande de test du serveur, rechargez-le, puis testez à nouveau l'URL de découverte et ouvrez un document.coolloleafletbrowser
Consultez les journaux d'accès et d'erreurs à la même heure que la tentative infructueuse. Une erreur 404 /browserindique /coolun problème de routage ; un échec de mise à niveau WebSocket suggère une gestion de mise à niveau manquante ou un délai d'attente dépassé ; une erreur 502 signifie généralement que le proxy ne peut pas atteindre le serveur Collabora. Ces informations sont des pistes, et non des diagnostics définitifs ; comparez-les donc avec le journal de Collabora.
WOPI (Web Application Open Platform Interface) est le protocole utilisé par Nextcloud et Collabora pour échanger des requêtes d'accès aux documents. Si le journal de Collabora signale « Aucun hôte WOPI acceptable trouvé » ou un hôte WOPI non autorisé, vérifiez que Collabora est configuré pour faire confiance au nom d'hôte Nextcloud et non à son propre nom d'hôte Collabora. À l'aide de l'image Docker, examinez la configuration de démarrage et les journaux du conteneur :
docker ps
docker logs --tail=100 CONTAINER_NAMERemplacez CONTAINER_NAMEpar le nom réel du conteneur Collabora. Pour une installation de package natif, consultez le journal du service sudo journalctl -u coolwsd --since "15 minutes ago". Suivez les instructions de configuration de l'hôte WOPI correspondant à votre méthode d'installation ; évitez les règles d'autorisation génériques trop larges.
Nextcloud Office dispose également d'une liste blanche WOPI distincte. Celle-ci limite les adresses IP des serveurs Collabora autorisées à demander des fichiers à Nextcloud. Ajoutez l'adresse IP source que Nextcloud utilise pour Collabora ; celle-ci peut différer en cas d'utilisation d'un réseau Docker ou d'un proxy inverse. Il est inutile d'activer 0.0.0.0ou de désactiver cette restriction pour masquer une erreur : Nextcloud recommande de limiter les requêtes WOPI aux adresses IP des serveurs Collabora.
Effectuez un nouveau test depuis un navigateur utilisateur et depuis le serveur Nextcloud : les points de terminaison de découverte et de fonctionnalités doivent répondre, Nextcloud doit atteindre son URL Collabora configurée et Collabora doit atteindre le point de terminaison d'état de Nextcloud. Ouvrez ensuite un document de test court. Si le problème persiste, notez l'horodatage, l'action sur le document concerné, l'état HTTP ou WebSocket dans le journal du proxy, ainsi que les entrées correspondantes dans les journaux Nextcloud et Collabora. Ces informations permettent de distinguer une défaillance du réseau d'un problème d'autorisation WOPI.
Sauvegardez coolwsd.xml et ses sources de déploiement, restaurez-les en toute sécurité et vérifiez le code avant que les utilisateurs ne reprennent l'édition.
Autorisez l'origine exacte Nextcloud ou autre WOPI dans CODE, puis vérifiez la liste blanche des hôtes actifs et distinguez-la de la restriction d'adresse IP source de Nextcloud.
Analysez les connexions du navigateur, WOPI et WebSocket de Collabora pour déterminer pourquoi un document ne s'ouvre pas, puis appliquez la solution correspondant à votre configuration Nextcloud.
Déployez des réplicas Collabora CODE avec Helm, conservez chaque document sur un pod via l'affinité WOPI et vérifiez l'entrée, le placement des nœuds et l'édition Nextcloud.
Tracez une erreur de négociation de socket entre le navigateur et coolwsd, puis faites correspondre la route du proxy inverse à votre version de Collabora, y compris la modification Apache CODE 26.04.
Détecter les échecs de preuve WOPI de Collabora dus à des clés non concordantes, des données de découverte obsolètes, une dérive d'horloge ou des modifications d'URL de proxy, sans affaiblir la validation.
Réinitialisez le zoom du navigateur, testez une session propre et identifiez quand un menu de taille incorrecte nécessite une mise à jour du serveur Collabora.
Déployez Collabora CODE avec Docker, connectez-le en toute sécurité à Nextcloud Office et vérifiez l'édition de documents grâce à des contrôles WOPI et proxy pratiques.
Activez temporairement coolwsd pour le débogage, capturez une ouverture ayant échoué et utilisez la séquence de journaux pour distinguer les problèmes WebSocket, WOPI, proxy et conteneur.
Configurez la connexion d'administrateur Collabora Online pour Docker ou Linux, redémarrez le service approprié et vérifiez le nouveau mot de passe sans le divulguer.
