Verhindern Sie, dass der ONLYOFFICE Document Server den VPS-Speicher erschöpft.

Falls ONLYOFFICE Document Server aufgrund von Speichermangel auf Ihrem VPS abstürzt oder neu startet, überprüfen Sie zunächst, ob tatsächlich ein Speichermangel vorliegt und ob das Docker-Speicherlimit zu niedrig ist. Stellen Sie anschließend ausreichend physischen RAM für die Arbeitslast bereit und verwenden Sie Swap-Speicher nur als Sicherheitspuffer. Ein wiederholter Neustart des Editors behebt einen anhaltenden Speichermangel nicht.

1. Beweisen Sie, dass der Speicherdruck die Ursache für den Fehler ist.

Beginnen Sie auf dem Linux-VPS, nicht in den ONLYOFFICE-Integrationseinstellungen. Eine Browsermeldung wie „Dokument kann nicht geladen werden“ kann auch durch Netzwerk- oder Authentifizierungsprobleme verursacht werden. Daher ist es wichtig festzustellen, ob der Linux-OOM-Killer (Out-of-Memory-Killer) tatsächlich einen Prozess beendet hat.

Führen Sie diese Befehle über SSH aus. Ersetzen Sie „ onlyoffice-document-serverContainername“ durch den angezeigten Namen docker ps -a:

free -h
docker ps -a
docker stats --no-stream onlyoffice-document-server
docker inspect --format '{{.State.OOMKilled}} {{.State.ExitCode}} {{.HostConfig.Memory}} {{.HostConfig.MemorySwap}}' onlyoffice-document-server

free -hZeigt den verfügbaren Arbeitsspeicher (RAM) und Swap-Speicher des Hosts an. docker statsMisst einen laufenden Container, während der Befehl `inspect` den Status des Containers (OOM-Kill), den letzten Exit-Code und die konfigurierten Ressourcenlimits in Bytes ausgibt. Ein HostConfig.MemoryWert ungleich Null deutet auf eine explizite Speicherbegrenzung hin. Die Speicherstatistik von Docker kann bestimmte Dateicaches ausschließen und sollte daher mit den Host-Messungen verglichen werden, anstatt als vollständiges Bild betrachtet zu werden. Siehe die Docker-Statistikreferenz .

Wenn der Container gestoppt wurde, docker statskann sein vorheriger Spitzenwert nicht mehr angezeigt werden. Überprüfen Sie stattdessen das Kernel-Protokoll und die letzten Anwendungsmeldungen:

sudo journalctl -k --since "-2 hours" | grep -Ei 'out of memory|killed process|oom'
docker logs --tail 100 onlyoffice-document-server

Kernelmeldungen wie „Nicht genügend Speicher“ oder „Prozess beendet“ helfen, den betroffenen Prozess zu identifizieren. OOMKilled=trueSie deuten stark auf einen Speichermangel im Container hin, falseschließen aber nicht aus, dass der Host-Kernel einen Kindprozess beendet hat, während der Container weiterhin läuft. Ebenso bestätigt der Exit-Code 137 lediglich eine Beendigung mit SIGKILL, nicht aber deren Ursache. Liegen keine Hinweise auf einen Speichermangel vor, sollten Protokolle und Verbindungsfehler untersucht werden, bevor zusätzlicher Arbeitsspeicher (RAM) erworben wird.

2. Weisen Sie dem VPS ausreichend RAM zu, bevor Sie andere Einstellungen vornehmen.

Stand Oktober 2026 empfiehlt die offizielle README-Datei des Docker Document Servers von ONLYOFFICE mindestens 4 GB RAM und mindestens 2 GB Swap-Speicher. Die separate offizielle Dokumentation zum Ein-Klick-Installer gibt 4 GB RAM für Docker-Testumgebungen an, empfiehlt 8 GB oder mehr für den Produktivbetrieb und spezifiziert mindestens 4 GB Swap-Speicher als Installationsvoraussetzung. Da diese Dokumente unterschiedliche Einsatzszenarien beschreiben, sollten 4 GB RAM nicht als Garantie für zuverlässige Leistung im Produktivbetrieb interpretiert werden.

Verfügt Ihr VPS nur über 1–2 GB RAM, ist ein Upgrade des Tarifs die sinnvollste Lösung für eine Docker-basierte Installation. Sind bereits 4 GB vorhanden, prüfen Sie, wie viel RAM vom Betriebssystem, der Datenbank, dem Reverse-Proxy, Nextcloud und anderen Containern belegt wird. Ein Server, der im Leerlauf scheinbar ausreichend läuft, kann dennoch an seine Speichergrenzen stoßen, wenn mehrere Benutzer gleichzeitig Dokumente öffnen oder große Tabellen bearbeiten.

Auf einem stark ausgelasteten Host sollten Sie ps aux --sort=-rss | headspeicherintensive Prozesse identifizieren und den Vorgang docker statswährend einer repräsentativen Bearbeitungssitzung wiederholen. Reservieren Sie Speicherplatz für die übrigen Ressourcen des Systems, anstatt den gesamten verfügbaren RAM ONLYOFFICE zuzuweisen. Falls die Speicherauslastung die Kapazität des Hosts dauerhaft übersteigt, verschieben Sie konkurrierende Dienste oder führen Sie ein Upgrade des VPS durch. Eine Anpassung auf Anwendungsebene kann keinen fehlenden physischen Speicher erzeugen.

Prüfen Sie, ob die Docker-Speicherbeschränkung versehentlich überschritten wurde.

Docker-Container haben standardmäßig kein festes Speicherlimit. In einer Bereitstellung kann jedoch ein solches Limit mit `docker run` --memoryoder `compose up` ( z. B. `compose up`) festgelegt werden mem_limit. Beispielsweise kann ein Containerlimit von 2 GB zu OutOfMemoryErrors (OOM) führen, selbst wenn auf einem Host mit 8 GB RAM noch genügend Arbeitsspeicher vorhanden ist. Überprüfen Sie das tatsächliche Limit, bevor Sie es ändern. Ist das Limit unnötig niedrig, passen Sie die ursprüngliche Docker- oder Compose-Konfiguration an einen Wert an, der durch Messungen und die verbleibende Kapazität des Hosts gerechtfertigt ist. Weitere Informationen finden Sie in der Dokumentation zu Ressourcenbeschränkungen von Docker und in der Compose-Dienstspezifikation .

Weisen Sie einem gemeinsam genutzten VPS nicht blindlings unbegrenzten Arbeitsspeicher zu, da dies andere Dienste anfällig für OOM-bedingte Abstürze auf dem gesamten Host machen kann. Überprüfen Sie außerdem --memory-swapdie Einstellungen in der Compose-Datei memswap_limit; Docker berücksichtigt dabei den kombinierten Arbeitsspeicher und Swap-Speicher. Gleiche Grenzwerte für Arbeitsspeicher und kombinierten Arbeitsspeicher deaktivieren den Swap-Speicher für den Container. Wenn Sie ONLYOFFICE mit Compose verwalten, nehmen Sie die Änderung in der zugehörigen Compose-Datei vor, damit die Einstellung auch nach dem Neustart des Containers erhalten bleibt.

3. Fügen Sie einen Auslagerungspuffer hinzu, falls der VPS keinen besitzt.

Auslagerungsspeicher kann kurzzeitige Speicherspitzen abfangen, wird aber auf der Festplatte gespeichert und ist deutlich langsamer als RAM. Prüfen Sie dies swapon --showdaher df -h /zuerst. Das folgende Beispiel fügt einem VPS mithilfe eines kompatiblen lokalen Dateisystems wie ext4 eine 2 GiB große Auslagerungsdatei hinzu, sofern diese /swapfilenoch nicht existiert und der Anbieter Auslagerungsspeicherung zulässt:

sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
swapon --show
free -h

Die neue Auslagerungsdatei wird erst nach swaponerfolgreicher Installation persistent gespeichert. Prüfen Sie mit ; ​​falls kein Eintrag grep -F '/swapfile' /etc/fstabvorhanden ist, fügen Sie ihn einmalig hinzu.

echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

Das Erstellen von Auslagerungsdateien auf Btrfs, Netzwerkdateisystemen und einigen anderen Konfigurationen erfordert eine andere Vorgehensweise. Führen Sie diese Befehle nicht über eine bereits vorhandene Auslagerungsdatei aus und gehen Sie nicht davon aus, dass fallocatesie überall funktionieren. Das Linux-Swapon-Handbuch erläutert die Dateisystembeschränkungen. Wenn der VPS unter normaler Bearbeitungslast regelmäßig auslagert, priorisieren Sie mehr RAM gegenüber einer größeren Auslagerungsdatei.

4. Überprüfen Sie den Server erneut unter realistischer Bearbeitungslast.

Die Änderung eines VPS-Tarifs oder die Aktivierung des Swap-Speichers erfordert oft keine Konfigurationsänderung in ONLYOFFICE. Wenn Sie eine Docker-Bereitstellungseinstellung geändert haben, planen Sie Wartungsarbeiten und stellen Sie sicher, dass die bestehenden Mounts, Secrets, Zertifikatspfade und Integrationseinstellungen erhalten bleiben. Die ONLYOFFICE Docker README-Datei documentserver-prepare4shutdown.shbeschreibt geplante Herunterfahrvorgänge und weist darauf hin, dass das Trennen der Editoren mehrere Minuten dauern kann. Starten Sie einen aktiv genutzten Dokumentenserver nicht einfach neu, da nicht gespeicherte Änderungen dadurch beeinträchtigt werden könnten.

Sobald der Dienst bereit ist, überprüfen Sie, ob der Container ausgeführt wird, und untersuchen Sie erneut seinen Speicher:

docker ps --filter name=onlyoffice-document-server
docker stats --no-stream onlyoffice-document-server
docker inspect --format '{{.State.OOMKilled}}' onlyoffice-document-server
docker exec onlyoffice-document-server curl -fsS http://localhost:8000/info/info.json

Die letzte Prüfung verwendet den internen Informationsendpunkt, der im offiziellen ONLYOFFICE Docker Compose-Healthcheck angegeben ist . Führen Sie ihn innerhalb des Containers aus, da Port 8000 auf dem VPS möglicherweise nicht veröffentlicht ist. Die Antwort des Endpunkts zeigt die Verfügbarkeit des Dienstes an, jedoch nicht unbedingt, dass jede Speicherintegration oder jeder Speicher-Callback funktioniert.

Überprüfen Sie, ob das Speicherproblem behoben ist.

Öffnen Sie ein kleines Dokument und anschließend ein repräsentatives großes Dokument über Ihre Nextcloud-, ownCloud- oder andere Integration. Speichern Sie eine harmlose Änderung und prüfen Sie, ob diese nach dem erneuten Öffnen der Datei angezeigt wird. Überwachen Sie während des Nutzungszeitraums, der zuvor zu Fehlern geführt hat, die Protokolle für Fehlerspeicherung (OOM) und Kernelspeicherung (z. B. OOM) free -h.docker stats

Eine erfolgreiche Fehlerbehebung bedeutet, dass sich Dokumente weiterhin normal öffnen und speichern lassen, die Speichernutzung innerhalb der VPS- und Containergrenzen bleibt und keine neuen OOM-Fehler auftreten. Wenn die Abstürze nur bei geringer Auslastung aufhören, reicht die Kapazität des VPS für Spitzenlasten nicht aus. Dimensionieren Sie den RAM entsprechend, anstatt sich auf kontinuierliches Swapping zu verlassen. Wenn RAM verfügbar bleibt und keine neuen OOM-Meldungen auftreten, Dokumente aber weiterhin nicht funktionieren, konzentrieren Sie sich bei der Untersuchung auf die ONLYOFFICE-Protokolle, den Reverse-Proxy oder Ihren Speicherkonnektor, anstatt weitere Speicheränderungen vorzunehmen.