Zum Hauptinhalt springen

Fehlerbehebung für ONLYOFFICE Docs auf Docker

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:

  • Container-Protokolle:

    sudo docker logs <CONTAINER_ID>

  • Container-Version:

    sudo docker inspect --format='{{.Config.Image}}' <CONTAINER_ID>

  • Liste der eingebundenen Volumes:

    sudo docker inspect --format='{{range .Mounts}}{{.Source}} -> {{.Destination}}{{"\n"}}{{end}}' <CONTAINER_ID>

  • Host-Betriebssystem und Docker-Version:

    uname -a && docker --version

Installation und Systemanforderungen​

F: Ich möchte den Docker-basierten Server auf meinem lokalen Server installieren. Wie mache ich das?

A: Der neueste Docker-basierte Online-Office-Server ist auf Docker hub verfügbar. Bitte wählen Sie ONLYOFFICE Docs aus und folgen Sie den Installationsanweisungen.

F: Welches System benötige ich, um die Serverlösung zu installieren und erfolgreich zu nutzen?

A: Die Systemanforderungen sind:

  • CPU: Dual-Core 2 GHz oder besser
  • RAM: 4 GB oder mehr
  • Festplatte (HDD): mindestens 20 GB freier Speicherplatz
  • SWAP: mindestens 4 GB, hängt aber vom Host-Betriebssystem ab. Mehr ist besser
  • Betriebssystem: amd64/arm64, jede vom Docker-Team unterstützte Version

Netzwerk und DNS​

F: Ich habe eine der Server-Versionen mit dem Docker-Dienst installiert, habe aber Probleme mit dem DNS-Server oder der eigenen Namensauflösung. Was kann falsch sein?

A: Docker verwendet standardmäßig Google-DNS-Server, und der Server versucht, diese bei jeder Netzwerk-Anfrage zu kontaktieren. Wenn Ihr ONLYOFFICE Docs keinen Internetzugang haben soll, empfehlen wir, die Standard-Docker-DNS-Adresse auf die Adresse Ihres lokalen DNS-Servers zu ändern. Dazu bearbeiten Sie die Datei /etc/default/docker und ändern die IP-Adresse in der folgenden Zeile auf die IP-Adresse eines DNS-Servers in Ihrem lokalen Netzwerk:

docker_OPTS="--dns 8.8.8.8"

Bei RPM-basierten Betriebssystemen wie CentOS kann die Konfigurationsdatei hier liegen: /etc/docker/daemon.json

F: Die Dokumenteneditoren öffnen sich und die Benutzeroberfläche erscheint, aber das Dokument selbst lädt nicht und zeigt ständig den Ladefortschritt an. Was kann ich tun?

A: Der Grund könnte sein, dass der Computer sich selbst über den Internet-Loopback erreichen können muss, d.h. er muss für sich selbst von außen erreichbar sein. Um dies zu ermöglichen, bearbeiten Sie die iptables so, dass die Weiterleitungen wie folgt aussehen:

iptables -t nat -A PREROUTING -d <public_ip> -j DNAT --to-destination <local_ip>
iptables -t nat -A POSTROUTING -s <local_ip> -j SNAT --to-source <public_ip>

Vergessen Sie nicht, die public_ip- und local_ip-Adressen durch die tatsächlichen IP-Adressen zu ersetzen.

Authentifizierung und Sicherheit​

F: Die JWT-Authentifizierung schlägt nach der Integration von ONLYOFFICE Docs mit meiner Plattform fehl. Wie kann ich das beheben?

A: Überprüfen Sie, ob das in ONLYOFFICE Docs konfigurierte JWT-Geheimnis genau mit dem in den Konnektor-Einstellungen Ihrer Plattform konfigurierten Geheimnis übereinstimmt. Prüfen Sie auch, ob der JWT-Header-Name übereinstimmt (Standard ist "Authorization"). Häufige Fehler:

  • Führende oder nachgestellte Leerzeichen im Geheimniswert.

  • Verwendung des standardmäßigen zufälligen Geheimnisses anstelle eines benutzerdefinierten. Überprüfen Sie Ihr Geheimnis mit:

    sudo docker exec <CONTAINER_ID> /var/www/onlyoffice/documentserver/npm/json -f /etc/onlyoffice/documentserver/local.json services.CoAuthoring.secret.session.string

Leistung und Ressourcennutzung​

F: ONLYOFFICE Docs verwendet viel Speicher. Ist das normal?

A: Der Speicherverbrauch 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-Nutzung normal. Wenn der Speicherverbrauch unerwartet hoch ist, prüfen Sie auf hängengebliebene oder vergessene Dokumente unter /var/lib/onlyoffice/documentserver/App_Data/cache/files/forgotten/.

F: Der Container startet ständig neu. Was soll ich tun?

A: Prüfen Sie die Container-Protokolle auf den spezifischen Fehler:

sudo docker logs <CONTAINER_ID>

Häufige Ursachen sind:

  • Unzureichender Speicher (der Container benötigt mindestens 4 GB RAM).
  • Port 80 wird bereits von einer anderen Anwendung verwendet. Stoppen Sie entweder die andere Anwendung oder ändern Sie den Port von ONLYOFFICE Docs.
  • Fehler bei der Datenbankinitialisierung. Wenn Sie eine externe Datenbank verwenden, überprüfen Sie die Verbindungsparameter.

Dokumentenverarbeitung​

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

A: Prüfen Sie das Konverter-Log auf Fehler, indem Sie folgenden Befehl ausführen:

sudo docker exec <CONTAINER_ID> cat /var/log/onlyoffice/documentserver/converter/out.log

Häufige Ursachen sind unzureichender Festplattenspeicher und fehlende Schriftarten.

F: Beim Stoppen von ONLYOFFICE Docs kam es zu Datenverlust. Wie kann ich Datenverlust verhindern?

A: Aufgrund der Betriebsweise speichert ONLYOFFICE Docs ein Dokument erst, nachdem alle Benutzer, die es bearbeitet haben, das Dokument geschlossen haben. 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 oder Serverneustart. Führen Sie dazu folgendes Skript auf dem Server aus, auf dem ONLYOFFICE Docs installiert ist:

sudo docker exec <CONTAINER> documentserver-prepare4shutdown.sh
hinweis

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

Cache und Anpassung​

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

A: Leeren Sie den Cache zwangsweise, indem Sie folgenden Befehl ausführen:

sudo docker exec <CONTAINER_ID> documentserver-flush-cache.sh

Der Cache sollte für alle Server-Benutzer zurückgesetzt werden.

hinweis

Bitte beachten Sie, dass bei der Docker-Installation alle Aktionen innerhalb des Containers ausgeführt werden müssen.

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. Ersetzen Sie nach Erhalt der neuen Datei 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.