Hypothetisches Beispiel: Mina bearbeitet einen Projektplan in ONLYOFFICE aus einem Nextcloud-Ordner. Der Editor öffnet sich und übernimmt ihre Änderungen, aber Nextcloud meldet später: „Dokument konnte nicht gespeichert werden.“ Dieses Beispiel dient der Veranschaulichung und stellt keinen Bericht eines realen Tests dar. Lassen Sie in diesem Fall den Editor geöffnet, erstellen Sie eine lokale Kopie der ungespeicherten Arbeit und prüfen Sie, ob ONLYOFFICE Docs die Speicherfunktion von Nextcloud direkt erreichen kann. Nutzen Sie anschließend die Protokolle, um einen Fehler im Callback-Routing von einem Speicher- oder Berechtigungsproblem in Nextcloud zu unterscheiden.
Schließen oder aktualisieren Sie den Editor nicht, solange er noch Änderungen enthält, die Nextcloud noch nicht gespeichert hat. Verwenden Sie die Option „ Herunterladen“ , um eine lokale Wiederherstellungskopie zu erstellen, falls der Editor weiterhin reagiert. Notieren Sie sich den Zeitpunkt des fehlgeschlagenen Speichervorgangs und den Dateinamen, damit der Administrator die Protokolle zuordnen kann.
Testen Sie eine kleine DOCX-Datei in einem Standard-Nextcloud-Ordner. Wenn das Speichern funktioniert, konzentrieren Sie sich auf die Dateiberechtigungen, den Freigabestatus, den Speicherort oder das Format der Originaldatei. Falls das Speichern aller Dateien fehlschlägt, überprüfen Sie zunächst die freigegebene Callback-Route und den Serverstatus.
ONLYOFFICE Docs sendet eine POST-Anfrage an die vom Nextcloud-Connector bereitgestellte Callback-URL. Nextcloud ruft daraufhin die bearbeitete Datei ab und aktualisiert die gespeicherte Version. Der Editor kann normal geöffnet werden, das Speichern schlägt jedoch fehl, wenn der Dokumentenserver keine Daten an Nextcloud zurücksenden kann.
Reproduzieren Sie das Problem mit einer Testdatei und vergleichen Sie anschließend die Logs von DocService und Nextcloud. Unter Linux befinden sich die ONLYOFFICE-Logs unter `/usr/local/logs` /var/log/onlyoffice/documentserver/; unter Docker finden Sie die Logs im Container oder im eingebundenen Log-Verzeichnis. Nextcloud speichert die Standard-Logdatei nextcloud.logim Datenverzeichnis, sofern dies nicht durch eine Änderung log_typeoder logfileKonfigurationsdatei geändert wird.
Öffnen Sie in Nextcloud Einstellungen > Administration > ONLYOFFICE . Stellen Sie sicher, dass die öffentliche Adresse von ONLYOFFICE Docs die URL ist, die die Browser der Benutzer laden sollen. Falls die beiden Server über ihre öffentlichen Adressen nicht erreichbar sind, konfigurieren Sie die dokumentierten internen Felder: „ONLYOFFICE Docs-Adresse für interne Anfragen vom Server“ und „Serveradresse für interne Anfragen von ONLYOFFICE Docs“ . Die erste Verbindung muss von Nextcloud zum Dokumentenserver funktionieren, die zweite vom Dokumentenserver zu Nextcloud.
In Minas hypothetischer Konfiguration verwendet der Callback http://cloud.example.comHTTPS und leitet darauf um. Konfigurieren Sie die endgültige HTTPS-Adresse direkt und stellen Sie sicher, dass DNS, Firewall-Regeln und Zertifikatsvertrauen den Zugriff des Dokumentenservers ermöglichen. Der Proxy sollte den Callback unverändert an Nextcloud weiterleiten, ohne Schema, Hostname oder Pfad zu ändern. Der Beispiel-Hostname ist nicht für reale Installationen gedacht.
Die Verbindungsprüfung von ONLYOFFICE kann bei der Überprüfung konfigurierter Dienstadressen helfen:
sudo -u www-data php occ onlyoffice:documentserver --checkFühren Sie es im Nextcloud-Verzeichnis mit dem entsprechenden Webserver-Konto aus. Ein erfolgreicher Test beweist nicht, dass der Callback-POST funktioniert. Auch eine manuelle HEAD-Anfrage oder eine Browserseite unter demselben Hostnamen ist kein Beweis.
Wenn der Callback Nextcloud erreicht, die Datei aber weiterhin nicht aktualisiert wird, überprüfen Sie das Nextcloud-Protokoll auf die entsprechende Anfrage. Stellen Sie sicher, dass der Benutzer Bearbeitungsberechtigungen besitzt, der Speicherzugriff möglich ist, das Konto das Kontingent nicht überschritten hat und das Datenvolume über freien Speicherplatz und Inodes verfügt. Betrifft das Problem eine freigegebene Datei, prüfen Sie, ob ein anderer Benutzer oder Synchronisierungsclient diese gleichzeitig ändert, und testen Sie anschließend mit einer Kopie in einem privaten Ordner.
Die Transaktionsdateisperrung von Nextcloud koordiniert Schreibvorgänge; deaktivieren Sie sie nicht als schnelle Lösung. Falls Protokolle auf Sperr- oder Datenbankfehler hinweisen, überprüfen Sie das Sperr-Backend und den Redis- oder Valkey-Dienst. Löschen Sie keine oc_file_locksZeilen oder Sperrdateien, da dies laufende Schreibvorgänge unterbrechen kann.
Wenn ein Test mit einem Standardordner funktioniert, der Zugriff auf eine extern gespeicherte Datei jedoch fehlschlägt, überprüfen Sie die Verfügbarkeit und den Authentifizierungsmodus des entsprechenden Mounts. ONLYOFFICE dokumentiert Einschränkungen für einige externe Speichermodi; ändern Sie die Anmeldeinformationen erst, nachdem Sie den Mount isoliert haben.
Ändern Sie nach der ersten Änderung einer Einstellung eine bestimmte Änderung in einem kleinen Testdokument, warten Sie, bis das Speichern abgeschlossen ist, und schließen Sie es anschließend in Nextcloud. Öffnen Sie es dann erneut. Überprüfen Sie, ob die Änderung erhalten bleibt und die zugehörigen Protokolle keine Weiterleitung, Verbindungsfehler oder Speicherausnahmen anzeigen.
Wenn der Test erfolgreich ist, das Original aber weiterhin fehlschlägt, überprüfen Sie dessen Berechtigungen, externe Einbindung oder gleichzeitige Bearbeitungen. Falls alle Rückrufe fehlschlagen, sichern Sie die lokale Kopie und eskalieren Sie den Fall mit Zeitstempel, HTTP-Statuscode, Versionen und bereinigten Protokollen. Schwärzen Sie JWTs, Cookies, signierte URLs und persönliche Dateinamen.
Diese Schritte beheben häufige Ursachen für Speicherfehler im Zusammenhang mit Rückruffunktionen, Routing und Speicherung. Die genaue Lösung hängt vom ersten Fehlerpunkt in den Protokollen ab; eine erfolgreiche Verbindungsprüfung allein reicht nicht aus, um den gesamten Speichervorgang zu bestätigen.
Dokumentation geprüft am 9. Oktober 2026. Connector-Felder und Protokollziele können je nach installierter App-Version und Bereitstellungskonfiguration variieren.
Legen Sie die Korrektursprache für das gesamte Dokument oder für ausgewählten Text fest, vergewissern Sie sich, dass die Rechtschreibprüfung aktiv ist, und erkennen Sie, wenn ein Serverwörterbuch fehlt.
Aktivieren Sie die dauerhafte Änderungsverfolgung für alle Benutzer in einem ONLYOFFICE-Dokument, überprüfen Sie, ob die Änderungen protokolliert werden, und machen Sie sich mit den Grenzen dieser Einstellung vertraut.
Prüfen Sie, ob Nginx, Docker Networking oder ein interner ONLYOFFICE-Dienst den Fehlercode 502 zurückgibt, und überprüfen Sie anschließend den korrigierten Upstream-Server und den Health Check.
Fehlerhafte ONLYOFFICE-Speicherungen werden diagnostiziert, indem die Nextcloud-Callback-Route, Proxy-Weiterleitungen und Speicherprotokolle überprüft werden. Anschließend wird sichergestellt, dass die bearbeitete Datei erhalten bleibt.
Ermitteln Sie die Ursache für Speicherabstürze in ONLYOFFICE, überprüfen Sie die Docker-Limits, dimensionieren Sie den VPS-RAM korrekt, fügen Sie Swap-Speicher sicher hinzu und vergewissern Sie sich, dass Dokumente geöffnet und gespeichert werden können.
Trennen Sie Browser-Downloadprobleme von serverseitigen Konvertierungsfehlern und verwenden Sie das richtige Protokoll oder die richtige Zugriffsprüfung, um Ihren PDF-Export zum Laufen zu bringen.
Gleichen Sie das von ONLYOFFICE Docs und Nextcloud verwendete JWT-Geheimnis ab, wenden Sie es sicher für Docker- oder Linux-Installationen an und überprüfen Sie die Verbindung, ohne die Authentifizierung zu schwächen.
Installieren Sie ONLYOFFICE Workspace Community auf Ubuntu 24.04 mit dem offiziellen Docker-Skript, prüfen Sie die Serveranforderungen, überspringen Sie gegebenenfalls Mail und verifizieren Sie das Portal sicher.
Konfigurieren Sie passende JWT-Secrets für ONLYOFFICE Docs und seinen Konnektor, mit sicheren Schritten für Linux-Pakete, Docker-Bereitstellungen und Verifizierung.
Verleihen Sie dem integrierten ONLYOFFICE Docs-Editor mit einer benutzerdefinierten Designdatei und Editorkonfiguration Ihr Firmenlogo und Ihre Benutzeroberflächenfarben. Beachten Sie die Editionsbeschränkungen und Bereitstellungsprüfungen.
