Prüfen Sie zunächst, ob der Linux-Host oder der ONLYOFFICE-Container an seine Speichergrenze stößt. Die aktuelle ONLYOFFICE Docs Community Edition empfiehlt 4 GB RAM und mindestens 4 GB Swap-Speicher als Mindestanforderungen. Laut der zugehörigen Docker-Fehlerbehebungsseite sind 2–4 GB RAM-Nutzung für einige Dutzend aktive Benutzer normal, da der Speicherverbrauch mit geöffneten Dokumenten und gleichzeitigen Benutzern steigt. Die Hardware-Tabelle empfiehlt Kubernetes für Bereitstellungen mit mehr als 400 gleichzeitig aktiven Benutzern. Diese Werte sind Richtwerte und keine Garantie dafür, dass jeder VPS die gleiche Last bewältigt: Das Host-Betriebssystem, andere Container, die Dokumentgröße und die Limits des VPS-Anbieters spielen ebenfalls eine Rolle.
Diese Anleitung beschreibt die übliche Docker-Installation auf einem Linux-VPS. Führen Sie die vier Schritte nacheinander aus: Messen Sie die Auslastung von Host und Container, prüfen Sie die Protokolle und den Cache für vergessene Dateien, reduzieren Sie unnötige Lasten oder korrigieren Sie eine zu niedrige Container-Kapazität. Starten Sie Docker nur bei Bedarf neu und überprüfen Sie die Funktion im Normalbetrieb. Die Befehlsbeispiele verwenden <CONTAINER_ID>einen Platzhalter; ersetzen Sie diesen durch die ID oder den Namen aus der Datei docker ps. Erstellen Sie ein Backup und planen Sie Wartungsarbeiten, bevor Sie einen Editor mit aktiven Benutzern stoppen.
Führen Sie die ersten Befehle auf dem VPS-Host aus, nicht innerhalb des ONLYOFFICE-Containers:
free -h
swapon --show
docker stats --no-streamfree -hZeigt den verfügbaren Arbeitsspeicher und den Auslagerungsspeicher des Hosts an. swapon --showBestätigt, ob der Auslagerungsspeicher aktiv ist. docker statsVergleichen Sie in der Anzeige die Speichernutzung von ONLYOFFICE mit dem angezeigten Limit. Wenn der Host kaum noch Arbeitsspeicher zur Verfügung hat und mehrere Dienste RAM nutzen, ist der VPS möglicherweise unterdimensioniert. Hat der Host noch freien Speicherplatz, der ONLYOFFICE-Container ist aber nahe an einem deutlich niedrigeren Limit, könnte die Containerbegrenzung die unmittelbare Ursache sein. Ein nahezu voller Auslagerungsspeicher, anhaltendes Auslagern oder hohe Festplattenaktivität können die Bearbeitung verlangsamen, noch bevor der Host einen Prozess beendet.
Überprüfen Sie auch die konfigurierten Docker-Limits:
docker inspect --format '{{.HostConfig.Memory}} {{.HostConfig.MemorySwap}}' <CONTAINER_ID>
docker inspect --format '{{.State.OOMKilled}} {{.State.ExitCode}}' <CONTAINER_ID>Der erste Befehl gibt die Speicher- und Speicher-plus-Swap-Einstellungen in Byte aus. Ein Speicherlimit von Null bedeutet im Allgemeinen, dass keine explizite Speicherbegrenzung für den Container konfiguriert ist; es bedeutet nicht, dass der VPS über unbegrenzten RAM verfügt. Die Speicher-Swap-Einstellung von Docker ist eine kombinierte Speicher- und Swap-Obergrenze; interpretieren Sie sie daher nicht als reine Swap-Speicher-Einstellung. Der zweite Befehl meldet, ob Docker einen OOM-Kill für den Container protokolliert hat und welchen Exit-Code dieser zuletzt hatte. Docker dokumentiert diese Limits als vom Linux-Host durchgesetzte Kontrollen, und ein hostweiter OOM-Druck kann mehrere Container betreffen.
Lesen Sie die aktuellen Protokolle, bevor Sie Einstellungen ändern oder Dateien löschen:
docker logs --since 1h <CONTAINER_ID>Achten Sie auf wiederholte Neustarts, Datenbankstartfehler und Meldungen, die zeitnah zum Ausfall eines Editors auftreten. Überprüfen Sie außerdem das Host-Kernel-Protokoll auf Speichermangelereignisse, sofern Sie die Berechtigung dazu haben.
sudo dmesg -T | grep -Ei 'out of memory|killed process|oom' | tail -n 30Die Docker-Fehlerbehebungsseite von ONLYOFFICE empfiehlt ausdrücklich, /var/lib/onlyoffice/documentserver/App_Data/cache/files/forgotten/bei unerwartet hoher Speichernutzung nach festsitzenden oder vergessenen Dokumenten zu suchen. Überprüfen Sie zunächst die Größe und den Inhalt des Verzeichnisses; löschen Sie die Dateien nicht wahllos. Sie könnten für die Wiederherstellung oder Fehlerbehebung relevant sein. Wenn das Verzeichnis groß ist oder weiter wächst, sichern Sie die Dateien und Protokolle und folgen Sie dann den offiziellen Anweisungen zur Fehlerbehebung oder fragen Sie den ONLYOFFICE-Support, welche Dateien in Ihrer Version gefahrlos gelöscht werden können.
In den Dimensionierungsrichtlinien von ONLYOFFICE gilt ein Benutzer als „aktiver Benutzer“, wenn er ein Dokument im Editor geöffnet hat, auch wenn er es nur ansieht. Benutzer, die lediglich auf einer integrierten Plattform angemeldet sind, aber kein Dokument geöffnet haben, werden nicht entsprechend gezählt. Bitten Sie Benutzer, nicht benötigte Dokument-Tabs zu schließen und vermeiden Sie, große Bearbeitungsspitzen auf einem kleinen VPS einzuplanen. Wenn die Last durch das gleichzeitige Öffnen mehrerer großer Tabellen oder komplexer Dateien entsteht, vergleichen Sie den Speicherverbrauch bei geringer Auslastung und bei der tatsächlichen Spitzenlast, anstatt die Belastung allein anhand der Benutzeranzahl zu schätzen.
Wenn der VPS den Swap-Speicher deaktiviert hat, kann das Hinzufügen von Swap-Speicher kurzfristig Lastspitzen abfangen. Die aktuelle Docker-Installationsanleitung von ONLYOFFICE empfiehlt mindestens 4 GB Swap-Speicher und weist darauf hin, dass die benötigte Menge vom Host-Betriebssystem abhängt. Swap-Speicher ist festplattenbasiert und deutlich langsamer als RAM, daher ist er kein Ersatz für ausreichend Arbeitsspeicher. Bevor Sie eine Swap-Datei erstellen, prüfen Sie, ob bereits eine existiert, ob genügend freier Speicherplatz vorhanden ist und ob Ihr Dateisystem und Ihr VPS-Anbieter diese Methode unterstützen. Ein Beispiel für ein typisches Linux-Dateisystem, das Swap-Dateien unterstützt, ist:
sudo fallocate -l 4G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
swapon --showFühren Sie diese Befehle nicht über einer bestehenden .xml-Datei aus /swapfile. Um eine neu erstellte Auslagerungsdatei nach dem Neustart beizubehalten, fügen Sie /etc/fstaberst dann einen passenden Eintrag hinzu, nachdem Sie geprüft haben, ob bereits ein Eintrag vorhanden ist.
/swapfile none swap sw 0 0Wenn Docker ein niedriges Speicherlimit für Container anzeigt, überprüfen Sie die Compose-Datei oder das Deployment-Panel, mit dem der Container erstellt wurde. Erhöhen oder entfernen Sie das Limit erst, nachdem Sie den gesamten Arbeitsspeicher des VPS sowie den vom Betriebssystem, der Datenbank, der Integrationsplattform und anderen Diensten belegten Speicher geprüft haben. Weisen Sie ONLYOFFICE nicht den gesamten Arbeitsspeicher des Hosts zu. Wenn der Host selbst bereits überlastet ist, schafft eine Änderung des Docker-Limits keinen zusätzlichen physischen Speicher. Passen Sie in diesem Fall die Größe des VPS an oder verschieben Sie andere Dienste auf einen anderen Host. Compose unterstützt Speicherlimits, das konfigurierte Limit muss jedoch dem tatsächlichen Deployment-Modus und dem verfügbaren Host-Speicher entsprechen.
Ein 2-GB-VPS, auf dem ONLYOFFICE zusammen mit Nextcloud oder anderen Diensten läuft, liegt unter der vom Anbieter angegebenen Mindestanforderung von 4 GB RAM. Auch ein 4-GB-VPS kann an Speichergrenzen stoßen, wenn das Host-Betriebssystem und der Integrations-Stack sich den Speicher teilen. In solchen Fällen ist ein größerer VPS oder ein dedizierter Dokumentenserver zuverlässiger als ein wiederholter Neustart des Containers. Für mehr als 400 gleichzeitig aktive Benutzer empfiehlt die aktuelle ONLYOFFICE-Tabelle eine Kubernetes-Bereitstellung und die Kontaktaufnahme mit ONLYOFFICE zur Dimensionierung. Dieses Problem lässt sich nicht durch das Hinzufügen einer kleinen Auslagerungsdatei zu einem einzelnen VPS lösen.
Starten Sie den Dokumentenserver nicht neu, während Benutzer Dokumente bearbeiten, es sei denn, der Ausfall ist unvermeidbar. ONLYOFFICE erklärt, dass ein Dokument erst gespeichert wird, nachdem alle bearbeitenden Benutzer es geschlossen haben. Vor einem geplanten Serverstopp empfiehlt die Fehlerbehebungsanleitung das unten stehende Vorbereitungsskript. Dies kann bis zu fünf Minuten dauern, während die Benutzer die Verbindung trennen. Informieren Sie die Benutzer vorher, sichern Sie die Backups und befolgen Sie Ihre üblichen Wartungsprozeduren.
sudo docker exec <CONTAINER_ID> documentserver-prepare4shutdown.sh
sudo docker restart <CONTAINER_ID>Wenn Sie Docker Compose verwenden, nehmen Sie die dauerhafte Änderung in der Compose-Konfiguration oder im Control Panel vor und nutzen Sie den normalen Neustart-Workflow des Projekts. Eine einmalige Änderung an einem laufenden Container kann beim Neustart verloren gehen. Verwenden Sie keine --oom-kill-disableextrem hohe OOM-Priorität, um ONLYOFFICE am Laufen zu halten; Docker warnt davor, dass eine Speichererschöpfung auf dem Host den VPS und andere Dienste gefährden kann.
Nachdem der VPS oder Container wieder verfügbar ist, überprüfen Sie, ob der Container weiterhin fehlerfrei funktioniert, der Editor sich öffnet und ein Testdokument speichert, ausreichend Arbeitsspeicher auf dem Host verfügbar ist und der Container nicht wiederholt neu startet. Beobachten Sie den Arbeitsspeicher von Host und Container während einer repräsentativen Auslastungsphase. Steigt der Arbeitsspeicherverbrauch nach dem Schließen von Dokumenten kontinuierlich an, wächst das Verzeichnis „vergessene Dateien“ oder treten OOM-Ereignisse auf, sammeln Sie die Ausgaben der Befehle `<Befehl 1>`, `<Befehl 2>` free -h, swapon --show` docker stats< docker inspectBefehl 3>` und die aktuellen Protokolle für den Support. Ein erfolgreicher Neustart allein reicht nicht aus, um die Kapazität als stabil anzusehen.
| Was Sie beobachten | Der nützlichste nächste Schritt |
|---|---|
| Der Arbeitsspeicher des Hosts ist erschöpft und auch andere Dienste sind betroffen. | Aktualisieren Sie den VPS oder verschieben Sie Nicht-Editor-Dienste. Eine Container-Einstellung kann den Host-RAM nicht erweitern. |
| Der Host hat noch Speicherplatz, aber ONLYOFFICE stößt an ein niedriges Docker-Limit. | Überprüfen Sie das Compose- oder Provider-Limit und erhöhen Sie es nur innerhalb des sicheren Host-Spielraums. |
| Die Nutzung steigt mit geöffneten Dokumenten und sinkt dann wieder, wenn diese geschlossen werden. | Vergleichen Sie mit der erwarteten Parallelität und den Dokumenttypen; erwägen Sie mehr RAM, wenn normale Spitzen zu einem Speichermangel führen. |
| Die Nutzung bleibt nach einem Aktivitätsrückgang ungewöhnlich hoch. | Prüfen Sie die aktuellen Protokolle und den dokumentierten Cache für vergessene Dateien; sichern Sie die Daten und führen Sie Untersuchungen durch, bevor Sie die Bereinigung vornehmen. |
| Mehr als 400 Benutzer haben gleichzeitig Dokumente geöffnet. | Verwenden Sie den vom Anbieter vorgegebenen Cluster-/Kubernetes-Dimensionierungspfad anstelle eines einzelnen kleinen VPS. |
Verbinden Sie Seafile mit Collabora Online über Docker oder einen separaten Host. Vergleichen Sie die Vor- und Nachteile der Bereitstellung, konfigurieren Sie HTTPS- und WOPI-Einstellungen und überprüfen Sie die Bearbeitung.
Diagnostizieren Sie langsames Tippen, Scrollen und Speichern in bildreichen LibreOffice Writer-Dateien. Testen Sie die Anzeigeeinstellungen, komprimieren Sie übergroße Bilder und grenzen Sie Profil- oder Hardwareprobleme ein.
Stellen Sie Collabora CODE auf Kubernetes mit dem offiziellen Helm-Chart bereit. Konfigurieren Sie Ingress, TLS, WOPI-Hostzugriff, Secrets, Skalierung und End-to-End-Prüfungen.
Verkleinern Sie eine große LibreOffice Impress-Präsentation, indem Sie übergroße Fotos komprimieren, eine sinnvolle Auflösung und JPEG-Qualität wählen und die gespeicherte Datei überprüfen, ohne die Lesbarkeit der Folien zu beeinträchtigen.
Installieren Sie Collabora Online CODE in Docker, veröffentlichen Sie es sicher über einen Reverse-Proxy, verbinden Sie es mit Nextcloud Office und überprüfen Sie die browserbasierte Dokumentenbearbeitung.
Diagnostizieren Sie Speicherfehler in ONLYOFFICE Docs auf einem VPS, prüfen Sie Host- und Docker-Limits, überprüfen Sie Protokolle und vergessene Dokumente, fügen Sie sicher Swap-Speicher hinzu und starten Sie neu, ohne laufende Änderungen zu riskieren.
Beheben Sie Probleme beim Kopieren und Einfügen in Collabora Online mit lokalen Anwendungen, indem Sie Tastenkombinationen, Browser-Zwischenablageberechtigungen, HTTPS, iFrame-Richtlinien und Inhaltsformate testen.
Beheben Sie unscharfen Text in ONLYOFFICE Desktop Editors unter Linux, indem Sie die Skalierung der Anzeige, die Skalierung der Anwendungsoberfläche, die Verfügbarkeit von Schriftarten und den Rendering-Bereich in einer sicheren Reihenfolge überprüfen.
Erfahren Sie, wie Sie Writer-Formularsteuerelemente hinzufügen, Beschriftungen und die Tabulatorreihenfolge festlegen, mit aktivierter Option „PDF-Formular erstellen“ exportieren und Ihr interaktives PDF vor der Weitergabe testen.
Erfahren Sie, wie Sie das Drucken und Herunterladen in ONLYOFFICE Workspace, DocSpace oder Docs-Integrationen blockieren und überprüfen Sie, welche Steuerelemente für die jeweilige Freigabemethode gelten.
