Suivi du rappel d'enregistrement lorsque ONLYOFFICE ne sauvegarde pas sur Nextcloud

Exemple hypothétique : Mina modifie un plan de projet dans ONLYOFFICE depuis un dossier Nextcloud. L’éditeur s’ouvre et accepte ses modifications, mais Nextcloud signale ensuite l’erreur « Impossible d’enregistrer le document ». Cet exemple est purement illustratif et ne correspond pas à un test réel. Dans ce cas, laissez l’éditeur ouvert, conservez une copie locale du document non enregistré et vérifiez si ONLYOFFICE Docs peut accéder directement à la fonction de rappel d’enregistrement de Nextcloud. Utilisez ensuite les journaux pour distinguer un échec de routage de la fonction de rappel d’un problème de stockage ou d’autorisation lié à Nextcloud.

Un éditeur de documents ONLYOFFICE affichant un plan de projet et un indicateur de sauvegarde des modifications
L'indicateur de sauvegarde de l'éditeur est utile, mais vérifiez que le fichier mis à jour est bien présent dans Nextcloud après avoir fermé la session d'édition.

1. Protégez les modifications de Mina avant le dépannage.

Ne fermez pas et n'actualisez pas l'éditeur tant qu'il contient des modifications non enregistrées par Nextcloud. Si l'éditeur reste accessible, utilisez l' option « Télécharger sous » pour conserver une copie de récupération locale. Notez l'heure et le nom du fichier ayant échoué afin que l'administrateur puisse les comparer aux journaux.

Testez un petit fichier DOCX dans un dossier Nextcloud standard. S'il s'enregistre, vérifiez les permissions du fichier d'origine, son statut de partage, son espace de stockage ou son format. Si aucun fichier ne s'enregistre, commencez par vérifier la configuration du serveur de rappel de partage et son état.

2. Vérifiez le rappel d'enregistrement serveur à serveur

ONLYOFFICE Docs envoie une requête POST à ​​l'URL de rappel fournie par le connecteur Nextcloud. Nextcloud récupère alors le fichier modifié et met à jour sa version enregistrée. L'éditeur peut s'ouvrir normalement, mais l'enregistrement échoue si Document Server ne parvient pas à renvoyer de données à Nextcloud.

Reproduisez le problème avec un fichier de test, puis comparez les journaux de DocService et de Nextcloud à ce moment-là. Sous Linux, les journaux ONLYOFFICE se trouvent dans /var/log/onlyoffice/documentserver/le répertoire `/etc/onlyoffice` ; dans Docker, consultez les journaux du conteneur ou le répertoire de journaux monté. Le journal par défaut de Nextcloud se trouve nextcloud.logdans son répertoire de données, sauf si log_type` docker-compose.log` ou logfile`docker-compose.log` le modifie.

  • 301, 302 ou 308 : redirections d’URL de rappel, souvent entre HTTP/HTTPS ou noms d’hôtes.
  • Délai d'attente dépassé ou erreur DNS : le serveur de documents ne peut pas résoudre ou atteindre l'URL.
  • 403 ou 404 : un proxy, une règle d’accès, une réécriture de chemin ou un paramètre d’hôte peut rejeter la requête.
  • Exception de stockage Nextcloud : le rappel est arrivé ; vérifiez le quota, les autorisations, l’état du stockage ou les verrous.
Paramètres d'administration Nextcloud ONLYOFFICE avec les champs d'adresse de serveur public et interne documentés
Les champs d'adresse interne du connecteur sont destinés aux routes serveur à serveur lorsque les URL publiques ne sont pas accessibles depuis les deux serveurs.

3. Corrigez l'URL ou la route proxy lorsque le rappel est redirigé.

Dans Nextcloud, ouvrez Paramètres > Administration > ONLYOFFICE . Vérifiez que l'adresse publique ONLYOFFICE Docs correspond bien à l'URL que les navigateurs des utilisateurs doivent charger. Si les deux serveurs ne peuvent pas communiquer via leurs adresses publiques, configurez les champs internes suivants : Adresse ONLYOFFICE Docs pour les requêtes internes du serveur et Adresse du serveur pour les requêtes internes d'ONLYOFFICE Docs . La première adresse doit être fonctionnelle de Nextcloud vers le serveur de documents ; la seconde, du serveur de documents vers Nextcloud.

Dans la configuration hypothétique de Mina, la fonction de rappel utilise http://cloud.example.comHTTPS et y redirige. Configurez directement l'adresse HTTPS finale, puis assurez-vous que le DNS, les règles de pare-feu et la confiance du certificat permettent au serveur de documents d'y accéder. Le proxy doit transmettre la fonction de rappel à Nextcloud sans modifier son schéma, son nom d'hôte ni son chemin. Le nom d'hôte utilisé à titre d'exemple n'est pas destiné aux installations réelles.

La vérification de connexion d'ONLYOFFICE peut aider à vérifier les adresses de service configurées :

sudo -u www-data php occ onlyoffice:documentserver --check

Exécutez-le depuis le répertoire Nextcloud avec le compte serveur web approprié. Un test réussi ne prouve pas que la requête POST de rappel fonctionne. Une requête HEAD manuelle ou l'ouverture d'une page web depuis le même nom d'hôte ne constituent pas non plus une preuve.

Exemple conceptuel de journal de disponibilité des rappels comparant une réponse de redirection à une réponse HTTPS directe
Cet exemple conceptuel montre pourquoi une redirection dans le chemin de rappel est importante ; utilisez les journaux réels du serveur de documents pour diagnostiquer votre route.

4. Suivez les preuves dans le stockage Nextcloud

Si la requête parvient à Nextcloud mais que le fichier ne se met toujours pas à jour, consultez le journal de Nextcloud pour trouver la requête correspondante. Vérifiez que l'utilisateur dispose des droits de modification, que le point de montage du stockage est disponible, que le compte n'a pas dépassé son quota et que le volume de données dispose d'espace libre et d'inodes suffisants. Si le problème concerne un fichier partagé, vérifiez si un autre utilisateur ou client de synchronisation le modifie simultanément, puis effectuez un test avec une copie dans un dossier privé.

Le verrouillage transactionnel des fichiers de Nextcloud coordonne les écritures ; ne le désactivez pas pour résoudre le problème rapidement. Si les journaux signalent des erreurs de verrouillage ou de base de données, vérifiez le système de verrouillage et le service Redis ou Valkey. Ne supprimez pas oc_file_locksde lignes ni de fichiers de verrouillage, car cela pourrait interrompre les écritures en cours.

Si un test sur un dossier standard fonctionne mais qu'un fichier stocké sur un périphérique externe échoue, vérifiez la disponibilité et le mode d'authentification du point de montage. ONLYOFFICE documente les limitations de certains modes de stockage externe ; évitez de modifier les informations d'identification tant que vous n'avez pas isolé le point de montage.

Vue Fichiers de Nextcloud affichant un plan de projet avec une icône d'état verte et une date de modification
Après la réparation, vérifiez que le fichier mis à jour apparaît bien dans le dossier Nextcloud prévu et que sa date de modification est la plus récente.

5. Vérifiez le chemin d'enregistrement complet

Après avoir modifié un paramètre, effectuez une modification distincte dans un petit document de test, attendez la fin de l'enregistrement, puis fermez et rouvrez le document depuis Nextcloud. Vérifiez que la modification est bien prise en compte et que les journaux correspondants ne signalent aucune redirection, aucun échec de connexion ni aucune exception de stockage.

Si le test réussit mais que le fichier original présente toujours une erreur, vérifiez ses permissions, les points de montage externes et les modifications simultanées. Si tous les rappels échouent, conservez la copie locale et transmettez l'alerte en fournissant l'horodatage, le statut HTTP, les versions et les journaux anonymisés. Masquez les jetons JWT, les cookies, les URL signées et les noms de fichiers personnels.

Ces étapes permettent de résoudre les problèmes courants liés aux rappels, au routage et au stockage, à l'origine d'une erreur d'enregistrement. La solution exacte dépend du premier point d'erreur relevé dans les journaux ; une vérification de connexion réussie ne suffit pas à garantir le bon déroulement de l'enregistrement.

Références officielles

Documentation vérifiée le 9 octobre 2026. Les champs du connecteur et les destinations des journaux peuvent varier en fonction de la version de l'application installée et de la configuration de déploiement.

Laisser un commentaire

Suivi du rappel d'enregistrement lorsque ONLYOFFICE ne sauvegarde pas sur Nextcloud

Suivi du rappel d'enregistrement lorsque ONLYOFFICE ne sauvegarde pas sur Nextcloud

Diagnostiquez les échecs d'enregistrement ONLYOFFICE en vérifiant la route de rappel Nextcloud, les redirections proxy et les journaux de stockage, puis vérifiez que le fichier modifié est bien conservé.

Empêcher le serveur de documents ONLYOFFICE de manquer de mémoire VPS

Empêcher le serveur de documents ONLYOFFICE de manquer de mémoire VPS

Identifiez la cause des plantages de mémoire d'ONLYOFFICE, vérifiez les limites de Docker, dimensionnez correctement la RAM du VPS, ajoutez du swap en toute sécurité et vérifiez que les documents s'ouvrent et s'enregistrent correctement.

Identifier la source d'une exportation PDF ONLYOFFICE ayant échoué

Identifier la source d'une exportation PDF ONLYOFFICE ayant échoué

Distinguez les problèmes de téléchargement du navigateur des erreurs de conversion côté serveur et utilisez le journal ou le contrôle d'accès approprié pour que votre exportation PDF fonctionne.

Résoudre l'erreur « Jeton non valide » d'ONLYOFFICE dans Nextcloud

Résoudre l'erreur « Jeton non valide » d'ONLYOFFICE dans Nextcloud

Faites correspondre le secret JWT utilisé par ONLYOFFICE Docs et Nextcloud, appliquez-le en toute sécurité pour les installations Docker ou Linux et vérifiez la connexion sans affaiblir l'authentification.

Déploiement de ONLYOFFICE Workspace Community sur Ubuntu 24.04

Déploiement de ONLYOFFICE Workspace Community sur Ubuntu 24.04

Installez ONLYOFFICE Workspace Community sur Ubuntu 24.04 avec le script Docker officiel, vérifiez les exigences du serveur, ignorez Mail si nécessaire et vérifiez le portail en toute sécurité.

Configurer les secrets JWT ONLYOFFICE sur le serveur et le connecteur

Configurer les secrets JWT ONLYOFFICE sur le serveur et le connecteur

Configurez les secrets JWT correspondants pour ONLYOFFICE Docs et son connecteur, avec des étapes sécurisées pour les packages Linux, les déploiements Docker et la vérification.

Documents ONLYOFFICE personnalisés avec votre logo et vos couleurs thématiques

Documents ONLYOFFICE personnalisés avec votre logo et vos couleurs thématiques

Personnalisez l'éditeur ONLYOFFICE Docs intégré avec le logo et les couleurs de votre entreprise grâce à un thème et une configuration adaptés. Consultez les limites d'édition et les vérifications de déploiement.

Conserver les modifications de l'auteur visibles lors de l'exportation au format DOCX

Conserver les modifications de l'auteur visibles lors de l'exportation au format DOCX

Suivez les modifications dans Writer, conservez une source ODT modifiable et vérifiez le fichier DOCX exporté dans Word avant de le partager.

Activez le mode FIPS sur SLES 15 et vérifiez l'état de démarrage

Activez le mode FIPS sur SLES 15 et vérifiez l'état de démarrage

Suivez la procédure SP7 de SUSE pour activer le mode FIPS, redémarrez en toute sécurité, vérifiez la politique active et vérifiez si vos exigences de conformité nécessitent des modules validés.

Configurer un volume de données chiffré LUKS sur SLES

Configurer un volume de données chiffré LUKS sur SLES

Comparez YaST et cryptsetup pour un nouveau volume de données SLES chiffré, choisissez LUKS1 ou LUKS2 et vérifiez le comportement de déverrouillage et de montage en toute sécurité.