La solution la plus rapide et fiable consiste à configurer Collabora Online CODE pour qu'il approuve le nom d'hôte et le port exacts figurant dans l'URL source WOPI envoyée par votre plateforme de stockage. Pour un serveur Nextcloud unique, ajoutez ce nom d'hôte Nextcloud à la liste blanche des hôtes de CODE, recréez le conteneur et effectuez un nouveau test. Si vous utilisez plusieurs instances Nextcloud, autorisez chacune d'elles explicitement. N'ouvrez pas l'accès WOPI à tous les hôtes pour résoudre le problème.
L'erreur « Hôte WOPI non autorisé » signifie généralement que Collabora a rejeté l'hôte de stockage indiqué dans la requête WOPI. Elle ne prouve pas, à elle seule, que le mot de passe de l'utilisateur, les autorisations d'accès aux documents, le certificat TLS ou le proxy inverse sont incorrects. Ces éléments peuvent entraîner d'autres échecs de connexion ; il est donc conseillé de consulter les journaux de Collabora pour identifier la cause exacte avant de modifier les paramètres.
| Déploiement | Changement recommandé | Compromis |
|---|---|---|
| Une instance Nextcloud avec du code Docker | Définissez un hôte de confiance explicite, généralement aliasgroup1le domainparamètre pris en charge pour votre version d'image. | Simple à vérifier et restrictif ; assurez-vous que la valeur correspond à l’hôte et au port utilisés dans les requêtes WOPI. |
| Plusieurs instances Nextcloud utilisant un seul serveur CODE | Ajoutez un groupe d'hôtes explicite pour chaque nom d'hôte de stockage et ses alias intentionnels. | Il centralise l'édition, mais chaque hôte ajouté étend l'ensemble des systèmes autorisés à envoyer des requêtes WOPI. |
| Collabora Online packagé plutôt que CODE Docker | Mettez à jour la section hôte WOPI dans la configuration gérée du service et redémarrez le service. | Offre un contrôle direct de la configuration ; toute modification manuelle d’un fichier généré peut être écrasée par les mises à jour des packages ou de la gestion de la configuration. |
| Nextcloud signale un avertissement de liste blanche WOPI | Autorisez séparément l'adresse IP du serveur Collabora attendue dans les paramètres d'administration d'Office de Nextcloud. | Il s'agit d'une seconde vérification, en sens inverse ; elle ne remplace pas la configuration des hôtes de confiance de CODE. |
Les exemples ci-dessous supposent que Nextcloud est installé à l'adresse `http://localhost:8080` https://cloud.example.comet Collabora à l'adresse `http://localhost https://office.example.com:8080`. Remplacez les noms d'hôte et le port par les valeurs utilisées dans votre installation. Le guide d'installation Docker de Nextcloud utilise `http:// aliasgroup1localhost:8080` pour un seul hôte de stockage et décrit l'ajout d'un autre groupe d'alias pour un second hôte Nextcloud. La configuration WOPI de Collabora définit la correspondance des hôtes à partir du nom d'hôte et du port ; les alias servent à identifier d'autres noms pour un même hôte de stockage.
Commencez par les journaux du conteneur CODE. Sur un déploiement Docker Compose, exécutez :
docker compose logs --since=10m collaboraRemplacez collabora`<service_name>` par le nom du service dans votre fichier Compose. Avec Docker standard, utilisez ` <service_name> docker logs --since 10m CONTAINER_NAME`. Recherchez un message d'erreur similaire à celui-ci près de la tentative d'ouverture de document ayant échoué No acceptable WOPI hosts found matching the target host [cloud.example.com] in config. Le nom d'hôte entre crochets est l'indice : ajoutez l'hôte de stockage indiqué, et non le nom d'hôte public du serveur Collabora.
Notez également l'hôte et le port de l'URL WOPI, s'ils apparaissent dans le journal. Comparez-les avec l'entrée configurée. Une requête cloud.example.com:443peut ne pas correspondre à une entrée pour un nom de conteneur interne tel que `<nom_du_conteneur>` nextcloud, même si les deux noms pointent vers la même machine. Les proxys inverses, le DNS à horizon partagé et les multiples URL publiques peuvent rendre cette incohérence difficile à détecter.
Si les journaux affichent une erreur différente, telle qu'un échec de recherche DNS, une connexion refusée ou une erreur de certificat, corrigez ce problème au lieu d'élargir la liste des hôtes WOPI.
Pour une installation Docker Compose desservant un hôte Nextcloud, la partie pertinente du service peut ressembler à ceci :
services:
collabora:
image: collabora/code
environment:
- aliasgroup1=https://cloud.example.com:443Conservez vos options de service, secrets, volumes, ports et paramètres de proxy inverse existants. L'exemple ne présente que l'entrée de la liste blanche ; il ne s'agit pas d'un fichier Compose complet pour la production. Utilisez le style de configuration déjà pris en charge par votre version de CODE et vérifiez la configuration rendue ou au démarrage après modification. Les images de conteneur et les interfaces de configuration peuvent évoluer.
Pour un hôte unique, une entrée d'hôte précise est plus facile à auditer qu'une expression régulière trop large. Si votre installation utilise une domainvariable d'environnement, vérifiez les règles d'échappement documentées pour votre image et assurez-vous que l'expression corresponde uniquement au nom d'hôte du stockage prévu. N'utilisez pas de caractère générique non échappé ni de modèle de domaine parent qui correspondrait à des sous-domaines non liés.
Pour plusieurs instances Nextcloud, ajoutez un groupe explicite distinct pour chaque hôte indépendant en utilisant le mécanisme pris en charge par votre version de CODE. Par exemple, le guide d'intégration Docker de Nextcloud indique une aliasgroup2entrée supplémentaire pour un second nom d'hôte cloud. N'ajoutez des alias que si un serveur Nextcloud est réellement accessible sous plusieurs noms, tels qu'un nom interne et un nom public. Conservez une liste écrite de ces noms afin de pouvoir supprimer un ancien nom d'hôte après une migration.
Après avoir modifié le fichier Compose, recréez le service afin que le nouvel environnement soit appliqué :
docker compose up -d --force-recreate collaboraUtilisez le nom de service correct. Vérifiez ensuite que le conteneur démarre correctement et que l'hôte attendu figure dans sa configuration de démarrage ou ses journaux. Évitez de coller des captures d'écran complètes de votre environnement dans vos demandes d'assistance : elles peuvent révéler des mots de passe ou d'autres informations confidentielles.
Nextcloud propose un paramètre distinct appelé « Liste d'autorisation pour les requêtes WOPI » dans ses paramètres d'administration Office. Cette liste restreint les adresses IP autorisées à effectuer des requêtes WOPI vers Nextcloud ; Collabora recommande de la limiter aux adresses IP attendues des serveurs Collabora. Si Nextcloud signale cet avertissement, ajoutez l'adresse IP que Nextcloud voit réellement pour la requête, qui peut différer en cas d'utilisation d'un proxy ou d'un réseau de conteneurs. Veillez à bien distinguer cette vérification de l'entrée hôte CODE : CODE fait confiance aux noms d'hôtes de stockage, tandis que la liste d'autorisation de Nextcloud concerne l'adresse IP du serveur demandeur.
Si vous utilisez un proxy inverse, vérifiez que le nom d'hôte publié par Nextcloud dans les liens WOPI correspond bien à celui configuré pour faire confiance à CODE. Consultez l'URL du serveur Nextcloud Office et la configuration de l'hôte public du proxy inverse. N'ajoutez pas le nom d'hôte du serveur Office à la liste blanche du stockage WOPI, sauf s'il s'agit effectivement du serveur de stockage indiqué dans l'URL WOPI.
Commencez par vérifier les points de terminaison du service Collabora depuis un navigateur et depuis le serveur Nextcloud. Remplacez le nom d'hôte d'exemple par l'URL de votre bureau :
curl -fsS https://office.example.com/hosting/capabilities
curl -fsS https://office.example.com/hosting/discoveryCes vérifications permettent de s'assurer que les points de terminaison répondent ; elles ne prouvent pas qu'une requête de document WOPI sera autorisée. Ensuite, vérifiez que CODE peut accéder à Nextcloud en utilisant le même hôte que celui utilisé par Nextcloud, par exemple :
curl -fsS https://cloud.example.com/status.phpEnfin, ouvrez un document de test et observez simultanément les journaux CODE et Nextcloud. Si tout fonctionne correctement, l'éditeur se charge, le message « Aucun hôte WOPI acceptable » disparaît et l'enregistrement d'une modification mineure est possible. Effectuez le test depuis un compte utilisateur standard disposant des mêmes autorisations de partage et de modification que l'utilisateur concerné.
Pour un déploiement monocloud, l'utilisation d'un nom d'hôte précis, accompagné du port souhaité, est généralement la meilleure solution : elle facilite la vérification et limite les correspondances accidentelles. Une expression régulière peut s'avérer utile lorsqu'un ensemble de noms d'hôtes gérés de manière ciblée présente un même modèle, mais elle est plus difficile à auditer et peut autoriser des sous-domaines non désirés si elle est trop générale. Il est donc préférable d'utiliser l'expression la plus précise répondant à un besoin avéré.
Un service CODE partagé réduit le nombre de services à maintenir, et des groupes spécifiques peuvent prendre en charge plusieurs instances Nextcloud. Des instances CODE distinctes peuvent s'avérer pertinentes lorsque les équipes ont besoin d'une isolation de configuration plus poussée ou de fenêtres de maintenance indépendantes. En contrepartie, l'infrastructure à corriger, surveiller et acheminer est plus importante. Aucune de ces options ne corrige automatiquement un nom d'hôte WOPI incorrect ; chaque instance doit faire confiance au bon hôte de stockage.
Pour un déploiement Docker CODE, utilisez l'interface de configuration fournie par l'image et conservez-la dans Compose ou une autre source de référence pour le déploiement. Ainsi, les modifications seront reproductibles lors de la recréation du conteneur. L'édition coolwsd.xmldirecte peut s'avérer utile pour un package géré ou un déploiement personnalisé, mais modifier un fichier généré dans un conteneur en cours d'exécution est risqué et peut entraîner sa disparition lors d'un remplacement ou d'une mise à jour. Suivez les instructions spécifiques au package, au graphique Helm ou à l'image que vous utilisez.
office.example.comlorsque l'hôte de stockage WOPI rejeté est cloud.example.com.Si l'hôte rejeté change entre deux requêtes, vérifiez l'URL Nextcloud canonique, les en-têtes des proxys de confiance et les répertoires racine alternatifs avant d'ajouter d'autres noms. Si tous les noms d'hôte correspondent mais que l'erreur persiste, comparez la configuration CODE active avec le fichier ou les paramètres d'environnement que vous avez modifiés et assurez-vous que le conteneur a bien été recréé. Pour Kubernetes ou Helm, modifiez les valeurs du graphique ou la source de configuration gérée plutôt qu'un pod en production. Si les journaux indiquent des erreurs de certificat, de pare-feu, de WebSocket ou de DNS, effectuez un dépannage à ce niveau à l'aide des journaux du serveur et des vérifications réseau appropriés.
Ces étapes suivent le manuel d'administration de Nextcloud 35, disponible le 6 octobre 2026, et le schéma de configuration WOPI publié par Collabora. Les clés de configuration spécifiques peuvent varier selon la méthode de déploiement et la version de l'image ; vérifiez-les dans la documentation de votre version installée avant d'appliquer une modification.
Connectez les éditeurs de bureau ONLYOFFICE à votre serveur ownCloud, connectez-vous, ouvrez des fichiers cloud, gérez la connexion et résolvez les problèmes de configuration courants.
Résolvez les problèmes d'utilisation élevée du processeur de Collabora Online en identifiant les processus du kit occupés, en vérifiant les indicateurs et les journaux, en ajustant la concurrence et le nettoyage, et en vérifiant les correctifs en toute sécurité.
Découvrez comment personnaliser ONLYOFFICE Docs avec un logo d'en-tête et des couleurs d'interface, y compris les limites de licence, la configuration JSON du thème, les chemins Docker et les tests.
Corrigez les textes difficiles à lire dans LibreOffice Calc en vérifiant le thème de l'application, la police et les couleurs de remplissage des cellules, les styles et la mise en forme conditionnelle, puis vérifiez le résultat d'impression.
Débloquez en toute sécurité l'avertissement de verrouillage par utilisateur inconnu de LibreOffice. Vérifiez les sessions actives, protégez une copie, supprimez uniquement un verrouillage obsolète vérifié et testez le document.
Corrigez les problèmes de mise en page du texte arabe ou hébreu avec l'anglais dans LibreOffice Writer. Activez la mise en page complexe, définissez le sens des paragraphes et vérifiez le résultat.
Learn VLOOKUP and XLOOKUP in LibreOffice Calc, including exact matches, left lookups, not-found results, reverse search, INDEX/MATCH alternatives, and common errors.
Résolvez les problèmes de validation des preuves WOPI de Collabora Online en vérifiant les clés de découverte, la rotation des clés, les URL proxy, les horodatages et les listes d'autorisation des hôtes.
Activez le suivi des modifications pour tous les utilisateurs dans un document ONLYOFFICE, maintenez-le actif après la réouverture et comprenez les limites d'une option par défaut globale.
Comparez les délais d'expiration par vue, hors focus, d'inactivité des documents, de sauvegarde automatique et de proxy de Collabora Online, puis choisissez et vérifiez les paramètres pour votre déploiement.
