Behebung des Problems, dass der ONLYOFFICE Document Server auf einem VPS nicht genügend Speicherplatz hat

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.

1. Bestätigen Sie, wo der Speicherdruck auftritt.

Führen Sie die ersten Befehle auf dem VPS-Host aus, nicht innerhalb des ONLYOFFICE-Containers:

free -h
swapon --show
docker stats --no-stream

free -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.

Ein Linux-Terminalfenster, das die Befehle `free -h` und `swapon --show` anzeigt.
Schritt 1: Führen Sie auf dem VPS-Host die Befehle free -h und swapon --show aus, um den verfügbaren RAM anzuzeigen und festzustellen, ob der Swap-Speicher aktiv ist.
Ein Linux-Terminalfenster, das docker stats --no-stream anzeigt
Schritt 1: docker stats --no-stream vergleicht die aktuelle Speichernutzung des ONLYOFFICE-Containers mit seinem Limit.

Ü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.

2. Überprüfen Sie die Containerprotokolle und die bekannten kritischen Anwendungsfälle von ONLYOFFICE.

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 30

Die 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.

Ein Linux-Terminalfenster, das den Befehl „docker logs“ mit einem Platzhalter für die Container-ID anzeigt.
Schritt 2: Überprüfen Sie die aktuellen Protokolle des Containers, bevor Sie den VPS ändern oder zwischengespeicherte Dateien löschen.

3. Vermeidbare Nachfrage reduzieren und ein zu niedriges Docker-Limit korrigieren.

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 --show

Fü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 0

Wenn 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.

Ein Linux-Terminalfenster, das den dokumentierten Befehl „prepare-for-shutdown“ von ONLYOFFICE anzeigt.
Schritt 4: Führen Sie vor einem geplanten Neustart des Containers das von ONLYOFFICE dokumentierte Vorbereitungsskript aus, damit aktive Bearbeitungssitzungen sauber getrennt werden können.

4. Starten Sie das System sicher neu und überprüfen Sie anschließend das Ergebnis.

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.

Kurzleitfaden zur Entscheidungsfindung

Was Sie beobachtenDer 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.

Offizielle Referenzen

Einen Kommentar hinterlassen

So verschieben Sie ein Bild in Microsoft Word

So verschieben Sie ein Bild in Microsoft Word

Lernen Sie, wie Sie in Word ein Bild verschieben, den Textumbruch auswählen, es mit einem Absatz verbinden oder auf der Seite fixieren und Probleme mit Bildern beheben, die sich nicht verschieben lassen.

So fügen Sie ein Kontrollkästchen in Excel ein: Zwei einfache Methoden

So fügen Sie ein Kontrollkästchen in Excel ein: Zwei einfache Methoden

Erfahren Sie, wie Sie in Excel mit dem In-Cell-Tool ein Kontrollkästchen einfügen, markierte Elemente mit Formeln zählen oder in älteren Desktop-Versionen ein verknüpftes Formularsteuerelement hinzufügen.

So füllen Sie Buchstaben in Excel automatisch aus: A bis Z und darüber hinaus

So füllen Sie Buchstaben in Excel automatisch aus: A bis Z und darüber hinaus

Generieren Sie in Excel Buchstaben von A bis Z, Kleinbuchstaben oder Bezeichnungen jenseits von Z mit einer Ausfüllgriffformel, einer SEQUEENCE oder einer wiederverwendbaren benutzerdefinierten Liste.

So streichen Sie Text in Excel durch: Tastenkombinationen und Schritt-für-Schritt-Anleitungen

So streichen Sie Text in Excel durch: Tastenkombinationen und Schritt-für-Schritt-Anleitungen

Erfahren Sie, wie Sie in Excel unter Windows, Mac und im Web durchstreichen, einen Teil einer Zelle formatieren und die Linie entfernen, ohne ihren Wert zu löschen.

Was ist Microsoft Access? Wie funktionieren seine Datenbanktools?

Was ist Microsoft Access? Wie funktionieren seine Datenbanktools?

Microsoft Access ist eine Windows-Datenbankanwendung zum Speichern zusammengehöriger Datensätze, Erstellen von Abfragen, Dateneingabeformularen und Generieren von Berichten. Erfahren Sie, wie es funktioniert und wann es sich eignet.

Office Outlook 2010 Import und Export: Daten mit einer PST-Datei verschieben

Office Outlook 2010 Import und Export: Daten mit einer PST-Datei verschieben

Erfahren Sie, wie Sie eine PST-Datei in Outlook 2010 importieren oder E-Mails, Kontakte, Kalender und Aufgaben exportieren. Folgen Sie den richtigen Menüs, um fehlende Ordner oder Duplikate zu vermeiden.

Höhe und Breite der Gitternetzlinien in Word 2010 ändern

Höhe und Breite der Gitternetzlinien in Word 2010 ändern

Erfahren Sie, wie Sie in Word 2010 die Höhe und Breite der Rasterlinien anpassen, die sichtbare Linienfrequenz ändern und den zugrunde liegenden horizontalen und vertikalen Rasterabstand festlegen.

Outlook-PST-Passwort mit Nucleus Kernel wiederherstellen

Outlook-PST-Passwort mit Nucleus Kernel wiederherstellen

Stellen Sie ein vergessenes Outlook PST-Passwort mit den aktuellen Schritten von Kernel wieder her, einschließlich der Anleitung zur Identifizierung der richtigen Datei, zum Erstellen einer Sicherungskopie und zur Überprüfung der Grenzen des Tools.

So fügen Sie eine interaktive Webseite in eine PowerPoint-Folie ein

So fügen Sie eine interaktive Webseite in eine PowerPoint-Folie ein

Mit dem LiveWeb-Add-in können Sie eine Website auf einer PowerPoint-Folie platzieren, deren Größe und Aktualisierungsverhalten festlegen und die Kompatibilität vor der Präsentation überprüfen.

Fügen Sie Ihrem Outlook-Kalender nationale Feiertage hinzu

Fügen Sie Ihrem Outlook-Kalender nationale Feiertage hinzu

Fügen Sie länderspezifische Feiertage in der neuen Outlook-Version, Outlook im Web oder dem klassischen Outlook hinzu. Erfahren Sie, wie Sie doppelte Termine vermeiden und fehlende Daten für 2026/27 überprüfen.