Um ONLYOFFICE Document Server vollständig zu entfernen, ermitteln Sie zunächst, ob es als DEB/RPM-Paket oder als Docker-Container installiert wurde. Beenden Sie alle aktiven Bearbeitungssitzungen, entfernen Sie nur das entsprechende Paket oder den entsprechenden Container und überprüfen Sie anschließend die verbleibenden Daten, Volumes und Images separat. Durch das Löschen der Anwendung werden nicht automatisch alle Abhängigkeiten oder persistenten Dateien entfernt.
Führen Sie die folgende Checkliste durch, bevor Sie einen Löschbefehl ausführen. Die offizielle Deinstallationsanleitung von ONLYOFFICE weist darauf hin, dass dabei Daten des Dokumentenservers gelöscht werden. Falls Sie den Dienst möglicherweise wiederherstellen müssen, sichern Sie vor dem Fortfahren dessen Konfiguration, Datenbank, Protokolle und eingebundene Daten.
Prüfen Sie beide Installationstypen, da ein Host gleichzeitig ein Paket und einen Docker-Container enthalten kann. Unter Debian oder Ubuntu können Sie die Paketliste mit dem Befehl `docker list` einsehen dpkg -l | grep onlyoffice-documentserver. Das Community-Paket heißt `documentserver` onlyoffice-documentserver; die Developer- und Enterprise-Editionen verwenden andere Paketnamen. Prüfen Sie den Namen des installierten Pakets, bevor Sie einen Bereinigungsbefehl ausführen. Auf einem Docker-Host können Sie mit dem Befehl `docker list` sowohl sudo docker ps -agestoppte als auch laufende Container überprüfen und nach dem Image des Dokumentenservers oder einem Ihnen bekannten Containernamen suchen.
Weisen Sie Benutzer darauf hin, geöffnete Dokumente vor dem Herunterfahren zu speichern und zu schließen. ONLYOFFICE weist darauf hin, dass das Vorbereitungsskript bis zu fünf Minuten dauern kann, während aktive Sitzungen verarbeitet werden. Führen Sie zur Paketinstallation folgenden Befehl aus:
documentserver-prepare4shutdown.shFühren Sie für Docker dasselbe Skript innerhalb des angegebenen Containers aus:
sudo docker exec <container_name> documentserver-prepare4shutdown.shErsetzen Sie den Platzhalter durch den tatsächlichen Containernamen oder die ID. Falls das Skript nicht verfügbar ist, gehen Sie nicht davon aus, dass geöffnete Änderungen gespeichert wurden; warten Sie, bis die Benutzer Dokumente schließen und eine Sicherungskopie erstellen, bevor Sie den Server stoppen.
Unter Ubuntu oder Debian lautet der Befehl zum Entfernen der Community Edition gemäß der Anleitung von ONLYOFFICE:
sudo apt purge onlyoffice-documentserverFür die Community Edition unter CentOS: ONLYOFFICE-Dokumente:
sudo yum remove onlyoffice-documentserverDie Pakete unterscheiden sich je nach Edition. Die offizielle Anleitung zur Developer Edition verwendet die Versionsnummer onlyoffice-documentserver-de, die Anleitung zur Enterprise Edition die Versionsnummer onlyoffice-documentserver-ee. Verwenden Sie den Paketnamen aus Ihrer installierten Paketliste; führen Sie nicht wahllos alle Varianten aus. Lesen Sie die Bestätigungszusammenfassung des Paketmanagers, bevor Sie die Installation akzeptieren, insbesondere wenn dieser vorschlägt, eine Datenbank oder einen anderen Dienst zu entfernen, den Sie noch verwenden.
ONLYOFFICE gibt an, dass beim Entfernen des Pakets die Server-Binärdateien und die Konfiguration gelöscht werden, Abhängigkeiten jedoch erhalten bleiben. Falls der Paketmanager meldet, dass die ONLYOFFICE-Verzeichnisse nicht leer sind, überprüfen Sie diese bitte zuerst. Die zugehörige Deinstallationsanleitung listet folgende Verzeichnisse /etc/onlyofficeauf /var/www/onlyoffice, die manuell entfernt werden können:
sudo rm -rvf /etc/onlyoffice /var/www/onlyofficeDieser Befehl ist unwiderruflich. Führen Sie ihn erst aus, nachdem Sie sichergestellt haben, dass die Pfade keine benutzerdefinierten Konfigurationen, Protokolle, Zertifikate oder benötigte Daten enthalten. Für eine gezieltere Bereinigung entfernen Sie nur das verifizierte Unterverzeichnis des Dokumentenservers anstatt des übergeordneten Verzeichnisses.
Beginnen Sie mit sudo docker ps -ader Identifizierung des spezifischen ONLYOFFICE-Containers. Verwenden Sie keine Befehle, die alle Container oder Images auf dem Host entfernen. Wenn der Container den Namen „ONLYOFFICE“ trägt onlyoffice-ds, stoppen und entfernen Sie ihn mit folgendem Befehl:
sudo docker stop onlyoffice-ds
sudo docker rm onlyoffice-dsErsetzen Sie „Container“ durch Ihren tatsächlichen Containernamen oder Ihre Container-ID. Überprüfen Sie bei einer Compose-Bereitstellung docker compose pszuerst die Compose-Datei. Sie können den ONLYOFFICE-Dienst über seinen tatsächlichen Dienstnamen beenden und entfernen. Vermeiden Sie jedoch, ein gesamtes Projekt zu beenden, wenn dieses Projekt auch Nextcloud, eine Datenbank oder einen Reverse-Proxy ausführt, die weiterhin benötigt werden.
Das Entfernen eines Containers löscht nicht automatisch die Host-Bind-Mount-Verzeichnisse oder benannten Volumes. Überprüfen Sie die Mounts des Containers mit `docker build` sudo docker inspect <container_name>oder die volumesEinträge in seiner Compose-Datei. Sichern Sie alle benötigten Daten und entfernen Sie anschließend nur den verifizierten Datenpfad ONLYOFFICE oder das benannte Volume. Docker Compose down -ventfernt Projekt-Volumes; verwenden Sie diese Funktion nur, wenn das Compose-Projekt und alle darin deklarierten Volumes ausschließlich zu dieser Installation gehören. Die Docker-Dokumentation weist darauf hin, dass externe Volumes von Compose nicht entfernt werden.
Nach dem Entfernen des Containers können Sie das ONLYOFFICE-Image entfernen, sofern es von keinem anderen Container verwendet wird:
sudo docker image ls
sudo docker image rm onlyoffice/documentserverWenn Sie ein bestimmtes Image-Tag verwendet haben, verwenden Sie genau dieses Repository und Tag. Docker behält möglicherweise ein Image bei, auf das noch ein anderer Container verweist. Prüfen Sie dies daher, bevor Sie es erzwingen.
Wenn Sie ONLYOFFICE aus dem offiziellen APT-Repository installiert haben und kein anderes ONLYOFFICE-Paket auf dem Host es benötigt, können Sie den Repository-Eintrag und den Signaturschlüssel entfernen. Die Installationsanleitung nennt die entsprechenden /etc/apt/sources.list.d/onlyoffice.listDateien /usr/share/keyrings/onlyoffice.gpg. Überprüfen Sie deren Inhalt und stellen Sie sicher, dass sie ONLYOFFICE zugeordnet sind, bevor Sie sie löschen. Unter Debian oder Ubuntu sudo apt autoremove --purgebietet Ihnen die Option, nicht mehr benötigte Abhängigkeiten zu entfernen. Überprüfen Sie die vorgeschlagene Paketliste sorgfältig und brechen Sie den Vorgang ab, falls sie Software enthält, die von anderen Diensten verwendet wird. Die Bereinigung von Abhängigkeiten ist optional und nicht erforderlich, um den Dokumentenserver zu beenden.
Überprüfen Sie das Ergebnis mit dem Paketmanager und dem Docker-Inventar:
dpkg -l | grep onlyoffice-documentserver
sudo docker ps -aEs sollten keine passenden installierten Pakete oder Dokumentenserver-Container mehr vorhanden sein. Falls Sie auch das zugehörige Image und die Daten gelöscht haben, überprüfen Sie die zuvor ermittelten Image-Listen, Volume-Listen und Host-Pfade. Eine leere Paketabfrage ist kein Beweis dafür, dass Docker-Daten entfernt wurden, und ein fehlender Container ist kein Beweis dafür, dass das zugehörige Image und die Volumes gelöscht wurden.
Die oben genannten Schritte beziehen sich auf ONLYOFFICE Docs Community-, Developer- und Enterprise-Installationen (sofern angegeben). Paketnamen variieren je nach Edition, und benutzerdefinierte Bereitstellungsskripte können abweichende Pfade erzeugen. Genaue editionspezifische Befehle finden Sie im ONLYOFFICE Community Linux-Deinstallationsleitfaden , im Deinstallationsleitfaden der Developer Edition oder im Deinstallationsleitfaden der Enterprise Edition . Für Docker verwenden Sie bitte den ONLYOFFICE Docker-Deinstallationsleitfaden und die Docker Compose-Referenz .
Ermitteln Sie, ob Document Server ein Linux-Paket oder Docker verwendet, entfernen Sie nur dessen Komponenten und prüfen Sie die verbleibenden Daten, ohne versehentlich gemeinsam genutzte Dienste zu löschen.
Führen Sie die Ursache für langsame kollaborative Bearbeitung auf Docker-Ressourcenengpässe, Proxy-Verbindungen oder zu hohe Dokumentladezeiten zurück und wählen Sie dann die Lösung, die Ihren Messwerten entspricht.
Wählen Sie den Ort für die TLS-Terminierung, binden Sie ein vertrauenswürdiges Zertifikat und einen privaten Schlüssel sicher ein und überprüfen Sie den HTTPS-Zugriff auf einen Docker-basierten ONLYOFFICE Docs-Server.
Binden Sie den ONLYOFFICE-Editor in Ihre PHP-Anwendung ein, signieren Sie seine Konfiguration mit JWT und speichern Sie bearbeitete Dateien über einen sicheren Rückruf.
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.
