Dieser Artikel wurde von einer KI übersetzt

Fehlerbehebung für ONLYOFFICE Docs unter Linux

Bevor Sie den Support kontaktieren: Sammeln von Diagnoseinformationen

Wenn Sie ein Problem haben, das unten nicht behandelt wird, sammeln Sie bitte die folgenden Informationen, bevor Sie den ONLYOFFICE-Support kontaktieren:

Protokollverzeichnis: /var/log/onlyoffice/documentserver/
Pakete-Version: dpkg -l | grep onlyoffice (Debian/Ubuntu) oder rpm -qa | grep onlyoffice (CentOS)
Betriebssystem-Version: cat /etc/os-release

Probleme bei der Kompilierung

F:Ich habe den Code geklont, finde aber nur leere Ordner, es gibt keinen Quellcode.

A:Das Repository enthält Submodule. Es wird empfohlen, das Repository mit folgendem Befehl zu klonen:

git clone --recursive https://github.com/ONLYOFFICE/DocumentServer.git

Falls Sie das Repository mit folgendem Befehl geklont haben:

git clone https://github.com/ONLYOFFICE/DocumentServer.git

können Sie die Submodule wie folgt aktualisieren:

Wechseln Sie in das Verzeichnis DocumentServer:
```
cd DocumentServer
```
Führen Sie folgenden Befehl aus:
```
git submodule update --init --recursive
```

Probleme bei der Nutzung

F:Beim Stoppen von ONLYOFFICE Docs ist ein Datenverlust aufgetreten. Wie kann ich Datenverlust verhindern?

A:Aufgrund der Betriebsweise speichert ONLYOFFICE Docs ein Dokument erst, nachdem es von allen Benutzern, die es bearbeitet haben, geschlossen wurde. Um Datenverlust zu vermeiden, müssen Sie die ONLYOFFICE Docs-Benutzer zwangsweise trennen, wenn Sie ONLYOFFICE Docs stoppen müssen, z. B. bei einem Anwendungsupdate, Serverneustart usw. Führen Sie dazu folgendes Skript auf dem Server aus, auf dem ONLYOFFICE Docs installiert ist:

sudo documentserver-prepare4shutdown.sh

Die Ausführung des Skripts kann lange dauern (bis zu 5 Minuten), da es darauf wartet, dass sich alle Benutzer trennen.

F:Ich habe ein benutzerdefiniertes Interface-Thema hinzugefügt oder meine Editor-Sprachdateien aktualisiert (einige Übersetzungen korrigiert), aber der Server zeigt weiterhin die vorherigen Werte an. Wie kann ich den Cache für alle Benutzer gleichzeitig zurücksetzen?

A:Bitte führen Sie folgende Schritte aus, um den Cache zurückzusetzen:

Finden Sie die Dateien /etc/nginx/includes/ds-docservice.conf und /etc/nginx/includes/ds-spellchecker.conf. Dort muss ein Wert für Datum und Uhrzeit des Builds vorhanden sein. Ändern Sie diese Werte auf einen anderen (beliebiger Wert ist möglich, wichtig ist, dass er an allen Stellen gleich ist) und starten Sie NGINX neu:

sudo service nginx reload

Der Cache sollte für alle Serverbenutzer zurückgesetzt sein.

F:Die ONLYOFFICE Docs-Dienste starten nicht. Was soll ich tun?

A:Überprüfen Sie den Status der Dienste und sehen Sie sich eventuelle Fehlermeldungen an:

sudo systemctl status ds-docservice
sudo systemctl status ds-converter

Wenn einer der Dienste gestoppt ist, versuchen Sie ihn neu zu starten:

sudo systemctl restart ds-docservice

Häufige Ursachen sind:

Unzureichender Arbeitsspeicher (mindestens 4 GB RAM werden empfohlen).
Port 80 wird bereits von einer anderen Anwendung verwendet. Identifizieren Sie den Konfliktprozess mit sudo ss -tlnp | grep :80 und stoppen Sie ihn, oder konfigurieren Sie ONLYOFFICE Docs so, dass ein anderer Port verwendet wird.
Prüfen Sie die Protokolle für spezifischere Fehlermeldungen: /var/log/onlyoffice/documentserver/

F:JWT-Authentifizierung schlägt nach der Integration von ONLYOFFICE Docs in meine Plattform fehl. Wie behebe ich das?

A:Stellen Sie sicher, dass das in ONLYOFFICE Docs konfigurierte JWT-Geheimnis exakt mit dem in den Connector-Einstellungen Ihrer Plattform konfigurierten Geheimnis übereinstimmt. Prüfen Sie auch, ob der JWT-Header-Name übereinstimmt (Standard ist "Authorization"). Um Ihr aktuelles Geheimnis zu prüfen, lesen Sie die Konfigurationsdatei direkt aus:

cat /etc/onlyoffice/documentserver/local.json

Suchen Sie nach dem Wert unter services.CoAuthoring.secret.session.string. Häufige Fehler:

Führende oder nachgestellte Leerzeichen im Geheimniswert.
Verwendung des standardmäßigen zufälligen Geheimnisses anstelle eines benutzerdefinierten.

F:Die Dokumentenkonvertierung schlägt fehl (z. B. wird beim Öffnen von DOC-, XLS- oder PPT-Dateien ein Fehler angezeigt). Was kann ich tun?

A:Prüfen Sie das Konverter-Protokoll auf Fehler:

cat /var/log/onlyoffice/documentserver/converter/out.log

Häufige Ursachen sind unzureichender Speicherplatz und fehlende Schriftarten.

F:ONLYOFFICE Docs verbraucht viel Arbeitsspeicher. Ist das normal?

A:Der Arbeitsspeicherverbrauch skaliert mit der Anzahl der geöffneten Dokumente und gleichzeitigen Benutzer. Für einen Server mit einigen Dutzend aktiven Benutzern sind 2–4 GB RAM normal. Wenn der Speicherverbrauch unerwartet hoch ist, prüfen Sie, ob sich festhängende oder vergessene Dokumente im Verzeichnis /var/lib/onlyoffice/documentserver/App_Data/cache/files/forgotten/ befinden.

Probleme mit der Enterprise und Developer Edition

F:Ich sehe eine Warnung "Lizenz abgelaufen". Was soll ich tun?

A:Ihre license.lic-Datei ist abgelaufen. Kontaktieren Sie sales@onlyoffice.com, um Ihre Lizenz zu erneuern. Nachdem Sie die neue Datei erhalten haben, ersetzen Sie die alte license.lic-Datei im Datenverzeichnis und starten Sie ONLYOFFICE Docs neu.

F:Ich kann nicht auf das Admin-Panel zugreifen. Was soll ich tun?

A:Wenn Sie das Admin-Panel noch nicht eingerichtet haben, folgen Sie der Anleitung zur Einrichtung des Admin-Panels. Wenn Sie Ihr Admin-Passwort vergessen haben, löschen Sie den Eintrag passwordHash aus der Datei runtime.json und starten Sie neu – ein neuer Bootstrap-Code wird generiert.