OnlyOffice ist seit Nextcloud Hub (18.0) in Nextcloud integriert. Mit dem Community Document Server kann man eine integrierte Version des OnlyOffice-Servers installieren und so Office-Dokumente direkt in der Cloud betrachten und bearbeiten. Allerdings funktioniert diese integrierte Version alles andere als gut und ist für den produktiven Einsatz wenig geeignet. OnlyOffice kann zwar als Docker Container bereitgestellt werden, da dort aber kein Editieren auf Mobilgeräten möglich ist, ist das für viele keine Alternative. Mit nur wenig Aufwand, kann man (die entsprechende DiskStation vorausgesetzt) aber Collabora als Docker Container bereitstellen.
Container Manager
Ab DSM 7.2 heißt das Docker-Paket “Container Manager”, die Anleitung dazu findet ihr hier.
Probleme der integrierten OnlyOffice-Version
Die, als Community Document Server, in Nextcloud integrierte Version von OnlyOffice scheint einige Fehler aufzuweisen. Einige Leser haben von Datenverlust berichtet, wenn ein Dokument über OnlyOffice (im Browser oder Mobil) bearbeitet wurde. Ich selbst habe das selbst schon einige Male erlebt. Ein weiteres Problem ist die fehlende Erfassung einer Änderung seitens Nextcloud. Das bearbeitete Dokument wird zwar gespeichert, wird aber in der Cloud nicht richtig erfasst. Öffnet man das Dokument in OnlyOffice, erhält man den neuesten Stand. Auf andere Geräte wird dieser Stand aber nicht synchronisiert.
Und ein weiterer, schwerwiegender Fehler betrifft die Versionsverwaltung. Die funktioniert mit OnlyOffice nämlich nicht richtig. Nextcloud zeigt zwar alle erfasste Versionen an (unter Details > Versionen) ruft man aber eine ältere Version eines Excel-Dokuments auf, wird immer die neueste Version in OnlyOffice geöffnet. Im Editor kann man auch nicht auf die Versionshistorie zugreifen. Bei Word-Dokumenten öffnet sich zwar der Editor inklusive Fenster mit Versionshistorie, bleibt aber beim Laden des Dokuments stecken. Das Wiederherstellen und anschließende Öffnen des Dokuments funktioniert in beiden Fällen, ist aber kein praktikabler Workaround. Die nicht funktionierende Versionsverwaltung ist übrigens schon sehr lange bekannt.
Die Fehler treten nicht bei allen Usern auf und sind auch nicht auf Installationen auf einer DiskStation begrenzt. Generell lautet der Konsens, dass die integrierte OnlyOffice-Version nicht wirklich für einen produktiven Betrieb geeignet ist. Da gegenüber Nextclouds OnlyOffice-Version die Original-Version kein Editieren auf Mobilgeräten erlaubt, ist Collabora/LibreOffice die bessere alternative.
Vorbereitung
Bevor wir loslegen, hier eine kleine Checkliste an Dingen die ihr benötigt.
- Nextcloud, installiert auf der DiskStation, eine Anleitung dazu findet ihr in diesem Artikel. Nextcloud läuft dabei direkt am Webserver der DiskStation. Ihr könnt Collabora als Docker Container auf der DiskStation auch für eine Nextcloud-Installation auf einem anderen Gerät oder Nextcloud als Docker Container bereitstellen. In diesen Fällen kann aber eine zusätzliche Konfiguration notwendig sein, um die Kommunikation mit dem Container sicherzustellen.
- Eine DiskStation mit installiertem Docker. Docker findet ihr im Paket-Zentrum. Sollte das nicht der Fall sein, ist eure DiskStation zu schwach.
- Ihr benötigt eine gültige Subdomain, die ihr ausschließlich für OnlyOffice verwendet.
Subdomain und SSL-Zertifikat
Wollt ihr auf eure Cloud und Collabora über das Internet zugreifen, sind eine eigene Domain und SSL-Zertifikate unerlässlich. Habt ihr Nextcloud über HTTPS abgesichert, können keine Verbindungen zu externen Diensten via HTTP aufgebaut werden. Auch einige Docker Images setzen standardmäßig eine verschlüsselte Verbindung voraus. Im LAN würde zwar eine lokale Domain und ein selbst-signiertes Zertifikat ausreichen, ich habe das aber nicht getestet und kann daher nicht sagen, ob Collabora das zulässt, wenn ja, dann ist vermutlich eine zusätzliche Konfiguration des Containers notwendig.
Für die Anleitung gehe ich davon aus, dass ihr eine Subdomain (DDNS-Domain) eingerichtet habt, die auf eure externe IP verweist.
Installation
Vergewissert euch noch einmal, ob die folgende Anleitung auch das ist, was ihr erreichen wollt. Nextcloud ist direkt auf der DiskStation installiert, lediglich Collabora wird per Docker bereitgestellt.
Collabora/LibreOffice als Docker Container bereitstellen
Öffnet Docker auf eurer DiskStation und wechselt in den Bereich Registrierung. Sucht dort über das Suchfeld nach “collabora”. Ladet das Image “collabora/code” herunter.
Libreoffice
Anstelle von Collabora könnt ihr auch nach LibreOffice suche. Die erforderlichen Schritte zur Einrichtung sind ident.
Abweichende Schritte
Je nach Docker-Version (bzw. DSM-Version 7.0 oder 7.1) weichen die nachfolgenden Schritte leicht ab. Unter DSM 7.0 findet ihr alle notwendigen Optionen in den erweiterten Einstellungen. Nach dem Update auf 7.1 und einem einhergehenden Docker-Update sind einige der Optionen direkt über den Container-Erstellen-Dialog erreichbar. Diese Anleitung basiert auf dem neuen Dialog.
Nachdem das Image heruntergeladen wurde, wechselt in den gleichnamigen Bereich und klickt doppelt auf das Image, um einen neuen Container zu erstellen. Wählt zuerst “Die gewählten Netzwerke verwenden” und wählt “bridge”, klickt anschließend auf Weiter. Ihr könnt die Ressourcen für den Container einschränken, wenn ihr wollt. Im Leerlauf benötigt der Container quasi keine CPU-Leitung, aber einige Hundert MB RAM (Werte können je nach Nutzung weiter ansteigen). Wie die Ressourcenbelegung des Containers während der Nutzung aussieht, hängt davon ab, wie viele Dokumente gleichzeitig bearbeitet werden bzw. wie viele Nutzer darauf zugreifen.
Klickt auf Erweiterte Einstellungen und wechselt in den Reiter Umgebung, damit der Container funktioniert, müssen einige Umgebungsvariablen hinzugefügt werden. Klickt auf Hinzufügen um eine neue Variable anzulegen. Folgende Variablen müsst ihr hinzufügen:
| Name | Wert | Erklärung |
admin | col_admin (Beispiel) | ein beliebiger Benutzername für den Administrator-Benutzer des Containers |
password | 1supersafepassphrase! (Beispiel) | Passwort für den Admin |
aliasgroup1 | https://cloud.mydomain.com:443 (Beispiel) | Die URL eurer Nextcloud |
DONT_GEN_SSL_CERT | 1 | Damit kein SSL-Zertifikat erstellt wird, die SSL-Absicherung erfolgt an anderer Stelle |
extra_params | --o:security.seccomp=false --o:security.capabilities=false --o:ssl.enable=false --o:ssl.termination=true | Die Parameter in extra_params haben folgende Bedeutung:--o:security.seccomp=false schaltet die Verwendung von Seccomp ab.--o:security.capabilities=false schaltet die Verwendung von Capabilities ab. Es braucht dann auch kein CAP_ADD mehr.--o:ssl.enable=false schaltet SSL/TLS im Container ab.--o:ssl.termination=true sagt dem Container, dass er hinter einem Proxy sitzt, der SSL/TLS macht. |
SSL im Container ist nicht notwendig. Zuerst müsste jemand auf eure DiskStation gelangen um das ausnutzen zu können und da habt ihr dann sowieso ganz andere Probleme als den Container. Die Verbindung zu eurer DiskStation selbst bzw. zum Container von außen, sichern wir an anderer Stelle ncoh ab.
Klickt auf Speichern und anschließend auf Weiter. Im nächsten Fenster müsst ihr den internen Container Port (9980) auf einen lokalen Port mappen. Das ist notwendig, da der Container eben nicht im Hostnetzwerk (also eurer DiskStation) läuft, sondern in einem eigenen. Vergebt den lokalen Port manuell, die Auswahl “Automatisch” kann dazu führen, dass der Container beim Starten nicht immer die selben Portnummern zugewiesen bekommt, das ist aber wichtig um Collabora mit eurer Nextcloud zu verbinden. Sollte 9980 bereits von einer anderen Anwendung eurer DiskStation verwendet werden, werdet ihr darauf hingewiesen. Ihr müsst dann selbst eine Nummer eingeben, die noch nicht verwendet wird. Klickt jetzt Weiter bis ihr zur Zusammenfassung kommt und klickt auf Fertig. Der Container wird angelegt und startet.
Wechselt in den Bereich Container und markiert zuerst den Collabora-Container und klickt anschließend auf Details. Im Reiter Terminal könnt ihr den Startvorgang des Containers mitverfolgen. Es werden nur Ausgaben angezeigt, die nach dem Öffnen des Detailfensters erfolgen. Vergangene Ausgaben findet ihr im Reiter Protokoll. Der Start dauert einige Zeit und erfordert einige Ressourcen. Wartet auf die Meldung "Ready to accept connections on port 9980". Der Container ist jetzt einsatzbereit.
Reverse-Proxy einrichten
Euer Container ist jetzt unter jeder Adresse, unter der eure DiskStation erreichbar ist + den lokalen Ports erreichbar. Ist eure DiskStation per Domain erreichbar, die per SSL-Zertifikat abgesichert ist, würde das schon reichen. Um Dokumente von außen aufrufen zu können, müsstet ihr den lokalen Port aber am Router freigeben. Besser ist es daher, einen Reverse-Proxy mit eigener Sub-Domain einzurichten. Dann muss nur der HTTPS-Port am Router weitergeleitet werden. Das sollte bereits der Fall sein, wenn ihr eure Cloud von außen erreichen könnt.
Öffnet die Systemsteuerung und geht in den Bereich Anwendungsportal > Erweitert > Reverse Proxy. Klickt auf Erstellen und vergebt einen beliebigen Namen. Unter Quelle wählt ihr “HTTPS” aus und gebt die Sub-Domain ein und gebt als Port 443 an. Aktiviert zusätzlich noch HSTS. Als Ziel könnt ihr “HTTP” lassen und als Hostname gebt ihr "localhost" ein. Als Port verwendet ihr den lokalen HTTP-Port des Containers. Geht sicher, dass ihr die selbst vergebene Portnummer des Containers eingebt und NICHT die vorgegebene Portnummer 9980.
Damit der Container richtig funktioniert, müssen im Reiter Benutzerdefinierte Kopfzeile noch zwei Wertepaare hinzugefügt werden:
| Headername | Wert |
| Upgrade | $http_upgrade |
| Connection | $connection_upgrade |
Klickt anschließend auf Speichern.
Jetzt benötigt ihr für eure Sub-Domain noch ein SSL-Zertifikat. Wechselt in der Systemsteuerung dazu in den Bereich Sicherheit > Zertifikat und klickt dort auf Hinzufügen. Belasst “Neues Zertifikat hinzufügen” und klickt auf Weiter. Besitzt ihr für die Domain bereits ein Zertifikat von einem anderen Anbieter, wählt “Zertifikat importieren” und folgt dem Assistenten weiter. Andernfalls wählt ihr “Zertifikat von Let’s Encrypt abrufen”. Gebt die Sub-Domain und eine E-Mail-Adresse ein und klickt dann auf Weiter. Wartet, bis das Zertifikat erstellt wurde.
Ports öffen
Damit ihr ein Zertifikat beantragen könnt, müssen die Ports 80 und 443 in eurem Router geöffnet werden und zur DiskStation weitergeleitet werden. Auch die Firewall darf die Ports nicht blockieren oder einschränken.
DDNS-Domains
Let’s Encrypt erlaubt nur eine gewisse Anzahl an Zertifikaten pro Domain. Es kann daher nicht möglich sein, für eine DDNS-Domain ein Zertifikat zu erstellen.
Wurde das Zertifikat erfolgreich erstellt, müsst ihr es jetzt nur noch dem Reverse-Proxy zuweisen. Klickt dazu auf Einstellungen und sucht in der Liste den zuvor angelegten Reverse-Proxy (zu erkennen an der verwendeten Sub-Domain). Im Drop-Down wählt ihr dann das passende Zertifikat (ebenfalls zu erkennen an der Sub-Domain).
Der Only-Office-Container ist jetzt über eine eigene SSL-gesicherte Sub-Domain erreichbar. Testet das, indem ihr https://eure-sub-domain.com in den Browser eingebt. Ihr solltet ein schwarzes Fenster mit dem Text “OK” in der linken oberen Ecke erhalten.
Namensauflösung im LAN
In vielen privaten Netzwerken kann eine Domain nicht auf eine lokale IP-Adresse aufgelöst werden. Die Lösung dazu findet ihr in diesem Artikel unter der Überschrift “Namensauflösung im LAN”.
Nextcloud konfigurieren
Nachdem wir alles vorbereitet haben, ist es an der Zeit Collabora in der Nextcloud einzurichten. Habt ihr bereits die integrierte Version von Only-Office in Verwendung, müsst ihr zuerst die Apps “Community Document Server” und “ONLYOFFICE” deinstallieren oder zumindest deaktivieren. Wechselt dazu im Einstellungs-Menü in den App-Bereich. Ihr benötigt stattdessen die App Nextcloud Office (zu finden unter “Büro & Text”).
Wechselt anschließend in die Einstellungen und dort in den Bereich Office. Aktiviert “Verwende deinen eigenen Server” und gebt die Sub-Domain für den Collabora-Container ein. Klickt anschließend auf Save.
Das wars auch schon. Habt ihr die integrierte Version schon verwendet, funktioniert alles wie gewohnt oder sollte ich sagen es funktioniert, denn die oben geschilderten Probleme seid ihr jetzt los.
Habt ihr eine Office-Lösung für Nextcloud das erste Mal integriert, könnt ihr jetzt Office-Dokumente direkt in der Cloud öffnen und bearbeiten. Letzteres beschränkt sich auf den Browser.
Sicherheit und Zugriff
Nutzt ihr eine Firewall, müsst ihr die Container-Sub-Domain natürlich auch berücksichtigen. Anders als zu erwarten greift nicht nur Nextcloud auf diese Domain zu, wenn ihr ein Dokument öffnet muss auch das Endgerät auf die Sub-Domain zugreifen können.
Möchtet Ihr noch detailliertere Schritt-Für-Schritt-Anleitungen für euer Synology NAS, mit viel mehr Hintergrundinformationen, Tipps und Tricks? Dann holt euch mein Wissen als als umfassendes Praxis-Handbuch. Mehr Infos findet ihr in keinem Buch zu Synology und alles in der von mir gewohnten Qualität.
Die dritte Auflage enthält Aktualisierungen zu DSM 7.1 und den Updates von WebStation, Surveillance Station und Synology Photos.
Das Buch direkt beim Verlag
Das Buch auf Amazon
Hallo! bei mir läuft alles. Und alle Anzeigen sind auf Grün mit Häckchen. Nur wenn ich eine odt. starte, dann kommt nach längere Wartezeit “Laden des Dokuments fehlgeschlagen” und “Nextcloud Office konnte nicht geladen werden. Versuchen Sie es später nochmal”. Wo liegt der Fehler? Bei läuft Collabora auf einer DS218+ unter DSM 7.2 im ContainerManager.
Super Guide. Mit DSM 7.2 heißt Docker ja nun Container Manager und bietet die Möglichkeit Projekte mittels docker-compose.yml-Dateien zu erstellen. Somit erspart man sich das einzelne Anlegen der Umgebungsvariablen.
Hier mein docker-compose.yml:
version: “3.8”
services:
collabora:
image: collabora/code
container_name: collabora
ports:
– 9980:9980
environment:
– admin=col_admin
– password=euer_eigenes_admin_passwort
– aliasgroup1=https://cloud.meinedomain:443
– DONT_GEN_SSL_CERT=1
– dictionaries=de_DE en_GB en_US
– extra_params=–o:security.seccomp=false –o:security.capabilities=false –o:ssl.enable=false –o:ssl.termination=true
restart: unless-stopped
Ich hatte “nur noch” ein Problem: Der grüne Haken in Nextcloud -> Verwaltungs-Einstellungen -> Office (unterer Eintrag!) war da, nachdem ich die Reverse-Proxy-URL des Collabora-Dockers bei “URL (und Port) des Collabora Online-Servers” eingegeben hatte. Ich konnte aber immer noch keine Dokumente öffnen (es gab immer eine Fehlermeldung nach einigen Sekunden) und im Container-Log gab es viele WOPI-Verbindungsfehler (das Protokoll, mit dem sich der Collabora-Server und Nextcloud austauschen).
Die Lösung war weiter unten in den Verwaltungs-Einstellungen -> Office noch den korrekten WOPI-Adressraum einzugeben. Mein lokales Netzwerk beginnt mit 192.168.1…., daher habe ich bei “Allow List for WOPI requests” den Wert “192.168.1.0/16” eingetragen und schon hat es funktioniert.
Hallo Tobi,
Ich habe nochmal alles durchgetestet. Prinzipiell sollte eine leere WOPI Liste ok sein.
Hast du im Container bei der Umgebungsvariable aliasgroup1 auch die richtige Domain deiner Nextcloud eingegeben?
Grüße
Andreas
Da ich das mit der eigenen Subdomain irgendwie nicht hinbekommen habe (“Site Temporarily Closed. For further information please contact the webmaster.”), habe ich mit der neuen Nextcloud 25 die Installation über den built-in CODE server von Collabora versucht. Gemäss Installation funktioniert das auch wunderbar und es wird angezeigt:
“Collabora Online Server ist erreichbar.”
Ein Dokument anlegen funktioniert ebenfalls wunderbar, aber wenn ich eine Datei öffnen möchte, dann startet nicht LibreOffice im Webbrowser, sondern die Datei wird heruntergeladen.
Wenn ich auf einen Collabora Testserver wechsle, dann funktioniert alles.
Gibt es dazu schon ein Workaround?
In den Logs habe ich folgenden Fehler: PHP Startup: apc.shm_segments setting ignored in MMAP mode at Unknown#0
Nachtrag: Das wirft das Protokoll des Dockers aus:
Failed to initialize COOLWSD: SAXParseException: No element found in ‘/etc/coolwsd/coolwsd.xml’, line 1 column 0
-00001 2022-10-21 06:46:03.355147 +0000 [ coolwsd ] FTL Failed to initialize COOLWSD: SAXParseException: No element found in ‘/etc/coolwsd/coolwsd.xml’, line 1 column 0| wsd/COOLWSD.hpp:490
SAXParseException: No element found in ‘/etc/coolwsd/coolwsd.xml’, line 1 column 0
Setting up watches.
Watches established.
/etc/coolwsd/proof_key exists already.
Vielen Dank für diese wirklich gute Anleitung sowie alle anderen Tutorials, die in der Vergangenheit immer gut funktioniert haben. Leider hat es bei mir diesmal nicht geklappt. Habe heute NC auf Version 25 geupdatet, wohlwissend, dass damit OnlyOffice nicht mehr funktionieren wird. Bin damit auf Nextcloud Office umgeschwenkt, welches erfolgreich installiert wurde. Habe dann als nächstes den Docker Collabora /Code gemäß Anleitung installiert, der sich zwar starten ließ, aber immer wieder in eine Reboot-Schleife zurückfiel. Nach mehrmaligen Wiederholungen der Installation und kleinen Abwandlungen in der Einstellungsumgebung des Dockers läuft dieser nun mit Einschränkungen. Hin und wieder wir er unerwartet gestoppt. Alle weiteren Schritte habe ich dann gemäß Anleitung durchgeführt, kann aber keine Verbindung weder über Browser noch über die NC-Instanz zu dem Docker herstellen. Subdomain wurde ebenfalls dafür angelegt. Firewall kurzfristig zum Test ausgeschaltet, was aber auch keine Verbindung brachte. Gibt es hier Personen, die ähnliche Erfahrungen gemacht haben? Synology DS920+, DSM 7.1.1.-42962
Vielen Dank für den anfängerfreundlichen Guide.
Hat perfekt geklappt und läuft deutlich besser als ONLYOFFICE…