Vous ouvrez un fichier DOCX dans Nextcloud, ONLYOFFICE se charge normalement, vous effectuez une modification, et l'éditeur affiche alors le message « Impossible d'enregistrer le document ». La première conclusion qui vient à l'esprit est que le navigateur a perdu le fichier ou qu'ONLYOFFICE lui-même ne peut pas écrire sur le disque. Dans le cadre d'une intégration Nextcloud, ce n'est souvent pas la bonne piste à explorer.
Le point crucial est le fonctionnement de l'enregistrement. Nextcloud fournit à ONLYOFFICE Docs une URL et un chemin de retour pour le document callbackUrl. ONLYOFFICE télécharge le fichier, héberge la session d'édition, puis contacte Nextcloud afin que ce dernier récupère le fichier mis à jour et remplace la version enregistrée. La documentation officielle d'intégration d'ONLYOFFICE décrit explicitement cet échange de données. Par conséquent, l'éditeur peut s'ouvrir correctement même si le chemin de retour utilisé pour l'enregistrement est rompu. Action : considérer l'ouverture et l'enregistrement comme deux tests réseau distincts.
D'après la documentation d'intégration officielle actuelle, le connecteur Nextcloud d'ONLYOFFICE utilise un flux de travail serveur à serveur : le serveur de documents doit être accessible depuis Nextcloud, et inversement. Une fois la modification terminée, ONLYOFFICE envoie une requête POST à l'URL de rappel ; Nextcloud télécharge alors le document modifié et remplace la version précédente. Consultez le guide d'intégration officiel d'ONLYOFFICE pour Nextcloud et la description de l'API ONLYOFFICE relative à cette intégration .
Vérifié : un chemin de rappel incorrect ou inaccessible peut entraîner un échec d’enregistrement, même si l’éditeur est ouvert. La documentation de dépannage d’ONLYOFFICE recommande aux administrateurs de consulter les journaux DocService et de vérifier que l’URL de rappel est accessible en cas d’erreur d’enregistrement. Action : ne commencez pas par réinstaller l’éditeur ni par vider le cache du navigateur ; testez d’abord le chemin de communication entre serveurs.
Sur l'hôte Nextcloud, exécutez la vérification du connecteur ONLYOFFICE en tant qu'utilisateur du serveur web. Sur une installation Debian ou Ubuntu standard :
cd /var/www/nextcloud
sudo -E -u www-data php occ onlyoffice:documentserver --checkLe chemin d'accès exact à Nextcloud et l'utilisateur HTTP peuvent varier selon la distribution ou la configuration des conteneurs. Le manuel d'administration de Nextcloud recommande d'utiliser occl'utilisateur HTTP pour garantir la cohérence des droits d'accès aux fichiers. ONLYOFFICE documente occ onlyoffice:documentserver --checkle test de connexion du connecteur.
Ce que cela prouve : cela peut révéler une erreur manifeste de configuration ou de connexion du serveur de documents. Ce que cela ne prouve pas : chaque rappel généré lors d’une session d’édition réelle réussira, quel que soit le proxy, la route DNS ou la couche d’authentification. Action : si la vérification est concluante mais que l’enregistrement échoue toujours, poursuivez avec le rappel et les journaux au lieu de déclarer l’intégration fonctionnelle.
Dans Nextcloud, ouvrez Paramètres → Administration → ONLYOFFICE . L'adresse principale de la documentation ONLYOFFICE doit être accessible aux clients et services concernés. Si les URL publiques ne sont pas routables en interne en raison de la configuration réseau Docker, du NAT, du DNS à horizon partagé ou de la politique de pare-feu, développez les paramètres avancés du serveur.
Le connecteur officiel expose des adresses internes distinctes précisément pour ce genre de situation :
Par exemple, deux conteneurs sur le même réseau Compose peuvent utiliser des noms de service en interne tandis que les navigateurs utilisent toujours les noms d'hôtes HTTPS publics. Ne reproduisez pas ce modèle sans discernement : les noms doivent effectivement être résolus sur votre réseau. Action : testez chaque direction depuis la machine ou le conteneur à l'origine de la requête.
Cette conclusion n'est pas fiable. Le navigateur, Nextcloud et ONLYOFFICE Docs sont trois processus réseau distincts. Le navigateur peut accéder à ONLYOFFICE Docs office.example.comalors que le conteneur du serveur de documents ne peut ni résoudre le nom d'hôte ni s'y connecter cloud.example.com. De même, Nextcloud peut accéder à ONLYOFFICE Docs via un nom d'hôte interne alors que l'adresse de rappel pointe vers une adresse publique inaccessible.
Action : accédez au conteneur ou à l’hôte ONLYOFFICE et testez l’adresse Nextcloud qu’il est censé utiliser. Une simple requête HTTPS vers l’hôte Nextcloud permet de confirmer la connectivité DNS/TCP/TLS, mais n’oubliez pas qu’une status.phprequête réussie ne valide pas l’autorisation de rappel ni la gestion des requêtes POST.
JWT est une autre source fréquente de confusion. À partir d'ONLYOFFICE Docs 7.2, JWT est activé par défaut et une clé secrète est générée automatiquement. La documentation officielle exige que cette même clé secrète soit utilisée sur le serveur de documents et dans le connecteur ONLYOFFICE pour Nextcloud. La documentation actuelle du connecteur expose également le paramètre d'en-tête d'autorisation pour les installations qui n'utilisent pas l'en-tête par défaut.
Vérifié : le secret partagé doit correspondre. Dépend du déploiement : l’emplacement exact de sa gestion dépend du mode d’installation d’ONLYOFFICE (packages, Windows ou Docker). Dans les déploiements Docker, une variable d’environnement est généralement utilisée ; JWT_SECRETla configuration effective du serveur peut également être consultée dans le fichier `/etc/onlyoffice/localhost/12/2012`./etc/onlyoffice/documentserver/local.json
Action : comparez les paramètres de secret et d’en-tête effectifs des deux côtés, puis redémarrez les services ONLYOFFICE ou le conteneur après les modifications côté serveur. Ne « corrigez » pas le problème en désactivant définitivement JWT ; cela supprime un contrôle de sécurité au lieu de corriger la configuration. Consultez le guide de configuration JWT d’ONLYOFFICE pour plus de détails .
ONLYOFFICE recommande de consulter les journaux de DocService pour détecter les erreurs d'enregistrement. Sous Linux et Docker, les journaux du serveur de documents se trouvent dans le répertoire /var/log/onlyoffice/documentserver`/etc/docservice/docservice`. Les utilisateurs de Docker peuvent également suivre la sortie du conteneur avec `docker log` docker logs -f <container>. Si des informations plus détaillées sont nécessaires, ONLYOFFICE propose un mode de débogage temporaire via `docker DS_LOG_LEVEL=DEBUGlog` ou la configuration de log4js. Consultez le guide officiel de journalisation de débogage .
Sur Nextcloud, le journal par défaut se trouve généralement nextcloud.logdans le répertoire de données configuré. Vous pouvez connaître le chemin actif avec :
sudo -E -u www-data php occ log:fileNextcloud documente également les erreurs log:tail, et log:watchl'application Log Reader est disponible à tout moment. Procédure : reproduire un échec d'enregistrement, noter l'horodatage, puis comparer les deux. Un refus de connexion réseau, une erreur TLS, une réponse 401/403, une réponse 5xx ou une exception de stockage nécessitent des solutions très différentes.
Un certificat auto-signé ou émis par une autorité de certification privée peut compromettre la connexion HTTPS entre serveurs si cette autorité n'est pas reconnue. Le connecteur propose une option « Désactiver la vérification des certificats (non sécurisée) » , mais ONLYOFFICE la qualifie explicitement de non sécurisée et recommande de remplacer le certificat par un certificat émis par une autorité de certification reconnue. Action : n'utilisez la désactivation de la vérification des certificats qu'à titre de diagnostic ponctuel dans un environnement contrôlé ; la solution durable consiste à utiliser une chaîne de certificats valide et reconnue par les deux serveurs.
Si un proxy inverse est configuré devant ONLYOFFICE, assurez-vous qu'il conserve le schéma, l'hôte et le comportement de mise à jour attendus. ONLYOFFICE publie des instructions dédiées aux proxys inverses, notamment concernant les en-têtes transférés et les paramètres WebSocket. Consultez le guide de configuration du proxy inverse Nextcloud d'ONLYOFFICE .
Dépendance au déploiement : la configuration exacte de Nginx, Apache, Traefik, HAProxy, du contrôleur d’entrée ou du CDN ne peut être déduite de la seule erreur d’enregistrement. Action : comparez votre configuration de proxy avec l’exemple du fournisseur correspondant à votre topologie et examinez le statut HTTP enregistré lors du rappel avant de modifier aléatoirement les délais d’attente ou les en-têtes.
Une fois que les journaux confirment que le rappel a bien été envoyé à Nextcloud, poursuivez le traitement. Nextcloud doit pouvoir récupérer le nouveau document et remplacer la version enregistrée. Les permissions du système de fichiers local, un montage en lecture seule, un espace disque insuffisant, des restrictions de quota, un stockage externe indisponible ou une exception liée à l'application ou au stockage peuvent empêcher cette écriture finale.
Ce que l'on sait : les valeurs d'état de rappel d'ONLYOFFICE permettent de distinguer un document prêt à être enregistré d'une erreur d'enregistrement. Le rappel contient une URL vers le document modifié, que le service de stockage peut récupérer. La documentation officielle du gestionnaire de rappels définit l'état 2 comme « prêt à être enregistré » et l'état 3 comme « erreur d'enregistrement ».
Le message du navigateur ne permet pas de savoir si l'erreur s'est produite dans ONLYOFFICE, sur le réseau, dans Nextcloud ou au niveau du stockage sous-jacent. Action : ne modifiez pas de manière récursive le propriétaire des fichiers dans un répertoire de données Nextcloud simplement parce que l'éditeur indique une impossibilité d'enregistrer. Vérifiez d'abord s'il s'agit d'une erreur côté stockage dans les journaux de Nextcloud.
Une autre idée fausse est que chaque clic sur Enregistrer remplace immédiatement le fichier stocké par Nextcloud. Le connecteur peut utiliser une option de sauvegarde intermédiaire ou de sauvegarde forcée. Le guide d'intégration officiel indique que lorsque l'option « Conserver les versions intermédiaires lors de l'édition (sauvegarde forcée) » est activée, cliquer sur Enregistrer envoie directement les modifications au stockage ; sinon, les modifications sont conservées dans le cache de l'éditeur et le processus de sauvegarde finale normal s'effectue ultérieurement.
Ceci est important pour le dépannage. Si seule la sauvegarde forcée échoue alors que la fermeture et la sauvegarde normales réussissent, ou inversement, les horodatages et les statuts de rappel deviennent des informations précieuses. Action : reproduire l’échec dans un flux de travail clairement défini et capturer les journaux de cette tentative au lieu de mélanger la sauvegarde manuelle, la fermeture du navigateur et l’ouverture simultanée de plusieurs onglets d’éditeur.
| Symptôme | Vérification suivante la plus utile | Ne présumez pas |
|---|---|---|
| L'éditeur ne s'ouvre pas du tout | URL du serveur de documents, JWT, connectivité navigateur/serveur | C'est un problème de sauvegarde uniquement |
| L'éditeur s'ouvre, mais l'enregistrement échoue. | Accessibilité des rappels et journaux DocService | Cette ouverture réussie prouve la voie du retour. |
| 401/403 autour du trafic de rappel ou de commande | En-tête secret et d'autorisation JWT | La cause est un délai d'attente du proxy |
| Erreurs de validation TLS/certificat | Chaîne de certificats et magasins de confiance | Cette désactivation de la vérification est une solution permanente. |
| La requête atteint Nextcloud, mais le fichier reste inchangé. | Journal Nextcloud, montage de stockage, quota, erreurs d'écriture | Ce compte ONLYOFFICE a perdu la modification |
| Les échecs se produisent uniquement derrière un proxy/NAT. | URL internes avancées et routage redirigé | Les URL publiques fonctionnent de manière identique à l'intérieur des conteneurs |
Utilisez un petit fichier DOCX de test dans un dossier non critique. Ouvrez-le avec ONLYOFFICE, saisissez une ligne unique (par exemple, un horodatage), attendez que l'éditeur confirme l'enregistrement de la modification, puis fermez-le normalement. Rouvrez le fichier depuis Nextcloud et vérifiez que le texte est bien présent. Ensuite, consultez l'historique des versions si votre système l'utilise et vérifiez les journaux du serveur pour la même période.
Relancez ensuite la vérification du connecteur :
sudo -E -u www-data php occ onlyoffice:documentserver --checkUn bon résultat ne se limite pas à l'ouverture de l'éditeur. Le test complet consiste à : Nextcloud peut joindre ONLYOFFICE, ONLYOFFICE peut joindre l'adresse de rappel sur Nextcloud, l'authentification réussit, Nextcloud peut récupérer le fichier mis à jour et le système de stockage accepte le remplacement.
Si aucun journal ne révèle de défaillance manifeste, augmentez temporairement le niveau de journalisation d'ONLYOFFICE et de Nextcloud lors d'une reproduction contrôlée du problème, puis rétablissez le niveau normal. Nextcloud avertit que la journalisation DEBUG est détaillée et peut impacter les performances ; elle doit donc être utilisée à des fins de diagnostic et non comme paramètre de production permanent. Consultez la documentation de Nextcloud relative à la journalisation avant de modifier les niveaux de journalisation.
À ce stade, conservez les horodatages exacts, les codes d'état HTTP, la version du connecteur, la version de Nextcloud, la version de ONLYOFFICE Docs, la topologie et les lignes de journal pertinentes (anonymisées). Ces informations sont bien plus utiles que le message générique du navigateur « Impossible d'enregistrer le document ».
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.
