Für die Bearbeitung von Dokumenten im Browser brauchst du auf dem NAS zwei getrennte Komponenten: OnlyOffice Docs als Document Server und eine angebundene Dateiplattform wie Nextcloud. Eine akute Gefahr für vorhandene Dateien besteht bei einer sauber getrennten Installation nicht, trotzdem solltest du zuerst den Zustand von Speicherpool, Volume und Backup prüfen. Richte anschließend persistente Container-Speicher ein und teste den Document Server mit einer Kopie statt mit wichtigen Originaldateien. Vor diesem Test dürfen keine vorhandenen Freigaben überschrieben, Container-Verzeichnisse gelöscht oder produktive Dokumentbestände verschoben werden.
Warum der Document Server allein nicht ausreicht
OnlyOffice Docs stellt die Editoren für Textdokumente, Tabellen und Präsentationen bereit. Der Dienst verwaltet jedoch nicht automatisch deine Ordner, Benutzerkonten und Freigaben auf dem NAS. Öffnest du lediglich die Startseite des Document Servers, erhältst du daher noch keine vollständige Dokumentablage.
Die Dateiplattform übernimmt Anmeldung, Dateiauswahl, Rechte und Versionierung. Ein Connector übergibt das gewählte Dokument an OnlyOffice Docs und speichert Änderungen wieder in der Plattform. Für eine typische selbst gehostete Lösung besteht der Aufbau aus:
- einem laufenden OnlyOffice-Docs-Container,
- einer Plattform mit passendem OnlyOffice-Connector, beispielsweise Nextcloud,
- einer Netzwerkverbindung in beide Richtungen,
- einem gemeinsamen JWT-Geheimnis zur Absicherung der Kommunikation,
- einem Browserzugang über HTTPS.
Eine gewöhnliche SMB-Freigabe wie ein Windows-Netzlaufwerk ersetzt diese Integration nicht. Der Document Server sollte auch nicht direkt Schreibzugriff auf einen beliebigen Dokumentordner erhalten. Die angebundene Plattform steuert den Zugriff und verhindert, dass die Office-Anwendung die NAS-Berechtigungen umgeht.
Kompatibilität und Ressourcen vor der Installation klären
Das NAS muss eine von OnlyOffice Docs unterstützte Container-Architektur besitzen und genügend Arbeitsspeicher sowie freien Platz bereitstellen. Prüfe im Datenblatt deines NAS-Prozessors, in der Container-Verwaltung und in der offiziellen Rubrik zur Installation von OnlyOffice Docs für Docker, ob das vorgesehene Image zur CPU-Architektur passt. Verlasse dich nicht allein darauf, dass die NAS-Oberfläche das Image in einer Suche anzeigt.
OnlyOffice Docs ist erheblich anspruchsvoller als ein einfacher Dateibrowser. Mehrere gleichzeitig geöffnete Dokumente, große Dateien und komplexe Tabellen erhöhen den Bedarf an Prozessorleistung und Arbeitsspeicher. Reserviere dem Container nicht den gesamten verfügbaren Speicher, weil auch das NAS-Betriebssystem, die Dateiplattform und Hintergrundaufgaben arbeitsfähig bleiben müssen.
Vor dem Start sollten diese Voraussetzungen erfüllt sein:
- Der Speicherpool und das Volume melden einen normalen Zustand.
- Vom Dokumentbestand existiert ein externes oder anderweitig getrenntes Backup.
- Die Container-Anwendung des NAS ist installiert und funktionsfähig.
- Für Konfiguration, Protokolle, Daten und Schriften stehen eigene persistente Ordner bereit.
- Ein interner DNS-Name oder ein sauber geplanter Hostname ist vorhanden.
- Die Systemzeit von NAS, Document Server und Dateiplattform stimmt überein.
Ein RAID schützt höchstens gegen bestimmte Laufwerksausfälle. Es ersetzt weder das Backup der Dokumente noch eine Sicherung der Plattformdatenbank und Container-Konfiguration.
OnlyOffice Docs als Container bereitstellen
Suche in der Container-Verwaltung des NAS nach dem offiziellen Image mit der Bezeichnung onlyoffice/documentserver. Prüfe Herausgeber, unterstützte Architektur und Versionshinweise, bevor du das Image lädst. Verwende für den produktiven Betrieb keinen unkontrollierten Wechsel auf jede neu erscheinende Version, sondern lege eine nachvollziehbare Image-Version fest und teste Aktualisierungen getrennt.
- Erstelle einen eigenen Container oder ein Projekt für OnlyOffice Docs.
- Ordne dem Container persistente NAS-Ordner für Daten, Protokolle, Bibliotheken und benutzerdefinierte Schriften zu. Die erforderlichen Container-Ziele müssen mit der Dokumentation der verwendeten Image-Version übereinstimmen.
- Lege ein langes, zufälliges JWT-Geheimnis fest. Dasselbe Geheimnis wird später im Connector der Dateiplattform eingetragen.
- Verbinde den Container mit einem Netzwerk, über das ihn die Dateiplattform erreichen kann. Bei getrennten Docker-Netzen muss die Erreichbarkeit ausdrücklich hergestellt werden.
- Veröffentliche den internen HTTP-Port nur dort, wo er für Reverse Proxy oder lokalen Test benötigt wird. Eine direkte Freigabe des Container-Ports ins Internet ist nicht erforderlich.
- Starte den Container und beobachte zunächst Zustand, Ressourcenverbrauch und Protokoll.
Persistente Speicherzuordnungen sind wichtig, weil ein Container bei einer Neuerstellung ersetzt werden kann. Ohne korrekt eingebundene Ordner gehen anpassbare Konfigurationen, Protokolle oder zusätzliche Schriften möglicherweise verloren. Die eigentlichen Nutzerdokumente sollten weiterhin in der angebundenen Dateiplattform liegen und nicht in einem undokumentierten Containerpfad.
Erst den Dienst prüfen, dann die Dokumentplattform anbinden
Der gestartete Container muss einen gesunden Dienstzustand erreichen. Rufe die Document-Server-Adresse zunächst aus demselben Netz auf, in dem später auch die Dateiplattform arbeitet. Eine erreichbare Startseite bestätigt nur, dass der Webdienst antwortet; sie beweist noch nicht, dass Rückrufe, JWT und Dokumentzugriff funktionieren.
Bleibt die Seite unerreichbar, arbeite in dieser Reihenfolge:
- Prüfe, ob der Container läuft oder wiederholt neu startet.
- Kontrolliere im Container-Protokoll, ob ein interner Dienst nicht startet, Speicher fehlt oder ein eingebundener Ordner nicht beschreibbar ist.
- Teste die veröffentlichte Adresse und den zugeordneten Port innerhalb des lokalen Netzes.
- Prüfe Firewall-Regeln und Container-Netzwerk, falls der Dienst lokal läuft, aber von der Dateiplattform nicht erreichbar ist.
- Untersuche erst danach Reverse Proxy, Zertifikat und externen DNS-Namen.
Ein wiederholt neu startender Container ist kein Fall für eine sofortige Neuinstallation. Sichere zuerst Protokoll, Container-Einstellungen und Screenshots der Volume-Zuordnungen. Eine Neuerstellung ohne diese Informationen kann die eigentliche Ursache verdecken.
Nextcloud mit OnlyOffice Docs verbinden
Bei Nextcloud erfolgt die Anbindung über die App mit dem Namen ONLYOFFICE. Die App ist der Connector zwischen Dateiverwaltung und Document Server. Installiere sie in der App-Verwaltung von Nextcloud und öffne danach den zugehörigen Einstellungsbereich in der Administration. Die genaue Position kann sich zwischen Nextcloud-Versionen ändern; orientiere dich am Funktionsnamen ONLYOFFICE statt an einem ungeprüften Menüpfad.
Trage dort die Adresse ein, unter der Nextcloud den Document Server tatsächlich erreicht. Verwende nicht automatisch localhost: Aus Sicht eines Nextcloud-Containers bezeichnet localhost den Nextcloud-Container selbst und nicht OnlyOffice Docs. Läuft beides in einem gemeinsamen Container-Netz, kann häufig ein interner Dienstname verwendet werden. Bei getrennten Netzen ist eine erreichbare NAS-Adresse oder eine dafür eingerichtete interne Adresse nötig.
Übernimm außerdem dasselbe JWT-Geheimnis, das beim Document Server hinterlegt wurde. Einige Connector-Versionen bieten zusätzliche Felder für interne Adressen an. Diese sind nützlich, wenn Browser, Nextcloud und Document Server unterschiedliche Wege verwenden:
- Der Browser braucht eine für den Benutzer erreichbare HTTPS-Adresse.
- Nextcloud muss Anfragen an OnlyOffice Docs senden können.
- OnlyOffice Docs muss die von Nextcloud bereitgestellten Dokument- und Rückrufadressen erreichen können.
Speichere die Konfiguration und nutze die integrierte Verbindungsprüfung, sofern die eingesetzte Connector-Version sie anbietet. Eine erfolgreiche Prüfung ist notwendig, aber noch nicht die endgültige Erfolgskontrolle.
HTTPS und Reverse Proxy ohne unnötige Portfreigabe
Für reguläre Nutzung sollte der Browser OnlyOffice Docs über HTTPS erreichen. Ein Reverse Proxy auf dem NAS oder in der vorhandenen Infrastruktur kann eine eigene Subdomain an den internen Document-Server-Port weiterleiten. Das Zertifikat muss zum verwendeten Hostnamen passen und von Browser, Nextcloud sowie Document Server akzeptiert werden.
Der Reverse Proxy muss die für OnlyOffice Docs erforderlichen langen Verbindungen und WebSocket-Verbindungen korrekt weitergeben. Öffnet sich die Editoroberfläche, verliert aber regelmäßig die Verbindung oder bleibt beim Laden stehen, ist der Proxy daher ein wichtiger Prüfpunkt. Verwende die Reverse-Proxy-Vorgaben der offiziellen OnlyOffice-Dokumentation passend zur installierten Version; frei übertragene Einstellungen einer anderen Anwendung reichen nicht zuverlässig aus.
Für Zugriff von außerhalb des Heim- oder Firmennetzes ist eine direkte Portweiterleitung auf den Container nicht die bevorzugte Lösung. Nutze eine abgesicherte Veröffentlichung mit HTTPS, restriktiver Firewall und aktueller Authentifizierung oder greife über ein VPN auf die interne Umgebung zu. Das Administratorkonto der Dateiplattform sollte zusätzlich mit Mehrfaktor-Authentifizierung geschützt sein.
Der erste Bearbeitungstest muss Speichern und Rechte einschließen
Lege in Nextcloud einen Testordner und darin eine unkritische DOCX-, XLSX- oder PPTX-Datei an. Öffne die Datei über die Weboberfläche, ändere einen eindeutig erkennbaren Inhalt und schließe den Editor ordnungsgemäß. Lade die Datei danach erneut und prüfe, ob die Änderung erhalten blieb.
Teste danach mit einem zweiten Benutzerkonto. Gib diesem Konto nur die Rechte, die es im späteren Betrieb besitzen soll. Kann das zweite Konto eine schreibgeschützte Datei dennoch verändern, liegt das Problem in der Plattformfreigabe oder ihrer Rechteauswertung und nicht in einer normalen Editorfunktion. Scheitert dagegen bereits das Laden des Dokuments, sind Erreichbarkeit, JWT, Rückrufadresse und Zertifikatsvertrauen wahrscheinlicher.
Eine vollständige Erfolgskontrolle umfasst vier Ergebnisse:
- Die Datei öffnet sich im Browsereditor.
- Eine Änderung wird nach dem Schließen dauerhaft gespeichert.
- Ein zweites Konto erhält genau die vorgesehenen Lese- oder Schreibrechte.
- Die ursprüngliche Datei kann aus Backup oder Versionierung wiederhergestellt werden.
Der Wiederherstellungstest gehört zur Einrichtung, weil gemeinsames Bearbeiten versehentliche Änderungen nicht verhindert. Snapshots oder Dateiversionen erleichtern den Rücksprung, ersetzen aber kein getrenntes Backup.
Fehler anhand des Zeitpunkts eingrenzen
Der Moment des Abbruchs zeigt meist, welche Ebene geprüft werden muss. Dadurch vermeidest du, Container, Netzwerk und Benutzerrechte gleichzeitig zu verändern.
Die Document-Server-Seite ist nicht erreichbar
Prüfe Containerstatus, Protokoll, Portzuordnung und Netzwerk. Startet der Container immer wieder neu, kontrolliere zuerst Ressourcen und Schreibrechte der persistenten Ordner. Änderungen an Nextcloud helfen in diesem Zustand nicht, weil bereits der Office-Dienst selbst nicht verfügbar ist.
Der Connector meldet einen Verbindungsfehler
Teste die eingetragene Adresse aus Sicht der Nextcloud-Instanz. Ein im Browser erreichbarer Hostname kann für den Nextcloud-Container dennoch unauflösbar oder durch eine Firewall gesperrt sein. Stimmen Erreichbarkeit und DNS, vergleiche das JWT-Geheimnis auf beiden Seiten exakt und prüfe, ob ein Zertifikatsfehler die Verbindung verhindert.
Der Editor erscheint, das Dokument lädt aber nicht
In diesem Fall erreicht der Browser häufig den Editor, während der Document Server die Datei oder Rückrufadresse der Plattform nicht erreicht. Prüfe die interne Nextcloud-Adresse, Namensauflösung und Proxy-Regeln. Verwende keine unsichere Zertifikatsausnahme als dauerhafte Abkürzung; korrigiere Zertifikatskette und Hostnamen.
Bearbeiten funktioniert, Speichern jedoch nicht
Untersuche die Protokolle von Document Server und Dateiplattform unmittelbar nach einem Test. Kontrolliere außerdem Benutzerrechte, freien Speicherplatz, Dateisperren und die Erreichbarkeit der Rückrufadresse. Bleibt nur eine einzelne Datei betroffen, teste eine neu erstellte Datei desselben Formats. So trennst du ein beschädigtes oder ungewöhnlich aufgebautes Dokument von einem allgemeinen Integrationsfehler.
Updates mit Rückweg statt im laufenden Betrieb testen
Sichere vor einem Update die Container-Konfiguration, persistenten OnlyOffice-Verzeichnisse sowie die Datenbank und Konfiguration der angebundenen Plattform. Das Dokument-Backup bleibt davon getrennt. Notiere die bisher verwendete Image-Version, damit du bei einem Integrationsfehler nicht auf eine unbekannte Ausgangslage zurückfällst.
Aktualisiere nicht gleichzeitig OnlyOffice Docs, Nextcloud und den Connector. Ändere jeweils nur eine Komponente und wiederhole danach den Test aus Öffnen, Bearbeiten, Speichern und Rechteprüfung. Ein bloß erreichbarer Anmeldebildschirm ist keine ausreichende Kontrolle.
Mit dieser Trennung bleibt die Installation nachvollziehbar: Die Dateiplattform verwaltet Dokumente und Benutzer, OnlyOffice Docs übernimmt die Bearbeitung, und der Connector verbindet beide Systeme. Erst wenn Kommunikation, Speichern, Berechtigungen und Wiederherstellung geprüft sind, sollte der neue Browsereditor für produktive Dateien freigegeben werden.