Fehlerbehebung für ONLYOFFICE Docs auf Docker

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,8 GHz oder besser
• RAM: 4 GB oder mehr
• Festplatte (HDD): mindestens 40 GB freier Speicherplatz
• SWAP: mindestens 4 GB, hängt aber vom Host-Betriebssystem ab. Mehr ist besser
• Betriebssystem
  amd64-Linux-Distribution mit Kernel-Version 3.10 oder höher
• Zusätzliche Anforderungen
  • Docker: jede Version, die vom Docker-Team unterstützt wird

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.

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

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.

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

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.

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.