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 GHz oder besser
• RAM: 4 GB oder mehr
• Festplatte (HDD): mindestens 20 GB freier Speicherplatz
• SWAP: mindestens 4 GB, abhängig vom Host-Betriebssystem. Mehr ist besser
• Betriebssystem (OS): amd64/arm64-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 wird, 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, also von außen für sich selbst zugänglich sein muss. 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 in meine Plattform fehl. Wie kann ich das beheben?

A:Überprüfen Sie, ob 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"). Häufige Fehler:

• Führende oder nachfolgende 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:Die Speichernutzung 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 die Speichernutzung unerwartet hoch ist, prüfen Sie auf hängengebliebene oder vergessene Dokumente im Verzeichnis /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, ob die Verbindungsparameter korrekt sind.

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 die Konverter-Protokolle auf Fehler, indem Sie den 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 ist Datenverlust aufgetreten. Wie kann man 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 Update der Anwendung oder einem Server-Neustart. Führen Sie dazu das folgende Skript auf dem Server aus, auf dem ONLYOFFICE Docs installiert ist:

sudo docker exec <CONTAINER> documentserver-prepare4shutdown.sh

F:Ich habe ein benutzerdefiniertes Interface-Theme 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:Löschen Sie den Cache zwangsweise, indem Sie den folgenden Befehl ausführen:

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

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

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. Nach Erhalt der neuen Datei ersetzen Sie die alte license.lic-Datei im Datenverzeichnis und starten 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.