Community-Lösung

Nextcloud AIO funktioniert unter ZimaOS 1.5.0 nicht: Separate Berechtigungen für /mnt/data, Docker-Socket, Port 80 und Reverse-Proxy-Einrichtung

An October 2025 thread where a previously working Nextcloud AIO deployment failed after ZimaOS 1.5.0. The mastercontainer progressed but the Apache container could not write /mnt/data; another user reported Docker socket, permission, domain-check, and port-80 conflicts and switched to a standard Nextcloud Compose stack. No IceWhale staff reply confirmed a single root cause.

Die Quelle belegt nicht, dass „ZimaOS 1.5.0 Nextcloud AIO nicht ausführen kann“. Sie belegt einen enger gefassten Regressionsfall: Ein AIO-Stack, der unter 1.4.1 funktionierte, funktionierte nach 1.5.0 nicht mehr, wobei der Apache-Container wiederholt meldete, dass er nicht in /mnt/data. Ein anderer Benutzer stieß auf zusätzliche Probleme mit Docker-Socket, Domänenprüfung und Portkonflikten und entschied sich stattdessen für den regulären Nextcloud-Compose-Stack.

Die aktuelle Dokumentation von Nextcloud AIO beschreibt einen formellen Reverse-Proxy-Weg, bei dem AIOs interner Apache nicht mehr direkt auf Port 80 veröffentlicht werden muss. Dabei wird die AIO-Oberfläche auf Port 8080 verwendet und ermöglicht APACHE_PORT auf einen anderen Host-Port wie 11000 verschoben zu werden. Das ist eine bessere aktuelle Referenz, als die Berechtigungen zu erweitern oder sie manuell zu ändern, bis der Stack zufällig startet.

Der Fehler der Quelle trat ausdrücklich innerhalb von AIO auf

Der ursprüngliche Verfasser sagte:

  • AIO funktionierte unter ZimaOS 1.4.1;
  • Nach 1.5.0 startete der Stack weitgehend;
  • Der Apache-Container konnte wiederholt nicht schreiben /mnt/data;
  • privileged: true löste das Problem nicht;
  • Das vorherige Erstellen des AIO-Mastercontainer-Volumes löste das Problem nicht.

Das spricht dagegen, „einfach Berechtigungen hinzuzufügen“ als dauerhafte Lösung zu betrachten.

Ein anderer Benutzer stieß auf mehrere verschiedene AIO-Ebenen

gelbuilding meldete zunächst ein Problem mit dem Docker-Socket, anschließend /mnt/data Berechtigungsprobleme, anschließend ein Problem mit der Domänenprüfung. Sie vermuteten außerdem, dass die Verwendung von Port 80 durch das Gateway von ZimaOS mit ihrem AIO-Design nicht kompatibel war.

Dabei handelte es sich um Beobachtungen aus der Community, nicht um eine Ursachenanalyse von IceWhale.

Aktuelles Nextcloud AIO unterstützt eine dedizierte Reverse-Proxy-Konfiguration

Die aktuelle Anleitung von Nextcloud AIO empfiehlt:

  • die AIO-Verwaltungsoberfläche auf Port 8080 veröffentlichen;
  • ein APACHE_PORT beispielsweise 11000;
  • den Reverse-Proxy oder Tunnel auf diesen Apache-Port ausrichten;
  • den Docker-Socket schreibgeschützt in den Mastercontainer einbinden;
  • die erforderlichen nextcloud_aio_mastercontainer Volume.

Siehe das aktuelle Reverse-Proxy-Modell von Nextcloud AIO.

Cloudflare Tunnel beseitigt nicht die internen Port- und Berechtigungsanforderungen von AIO

Ein Tunnel macht es überflüssig, die öffentlichen Ports 80/443 am Router zu öffnen. Die AIO-Container benötigen jedoch weiterhin einen gültigen internen Pfad zwischen Mastercontainer, Apache, Docker-Socket, Datenspeicher und Tunnel/Reverse-Proxy.

Wenn die eigene Domänenvalidierung und die Proxy-Anforderungen von AIO nicht erfüllt sind, macht „Cloudflare übernimmt HTTPS“ den AIO-Stack nicht automatisch funktionsfähig.

Daten von AIO nicht rekursiv per chmod ändern, ohne zu verstehen, welcher Container sie besitzt

/mnt/data in einem AIO-Container als Teil von AIOs verwaltetem Speichermodell. Weitreichende Berechtigungsänderungen auf dem Host können den Fehler zwar verschwinden lassen, aber die Besitzverhältnisse beeinträchtigen oder später Upgrade-Fehler verursachen.

Prüfen Sie die tatsächliche AIO-Volume-/Datadir-Konfiguration und befolgen Sie zunächst die Upstream-Richtlinien zur AIO-Speicherung.

Der Benutzer aus der Quelle wählte standardmäßiges Nextcloud Compose als praktikable Alternative

gelbuilding sagte, dass ein normaler Nextcloud-Stack unter /DATA/AppData/nextcloud lief sauber auf einem freien Port und konnte weiterhin über Cloudflare Tunnel veröffentlicht werden.

Das ist eine gültige Architektur, wenn der Benutzer die explizite Kontrolle über die Nextcloud-, Datenbank- und Redis-Container gegenüber den vom AIO-Mastercontainer verwalteten nebengeordneten Containern bevorzugt.

Ein Fehler in Version 1.5.0 sollte für das aktuelle ZimaOS nicht vorausgesetzt werden

Das aktuelle ZimaOS ist deutlich neuer als die Veröffentlichung vom Oktober 2025 aus der Quelle. Bevor Sie alte Workarounds reproduzieren, testen Sie die aktuelle Nextcloud-/AIO-Compose-Konfiguration auf dem aktuellen ZimaOS und sammeln Sie die genauen Container-Logs.

AIO benötigt für sein Verwaltungsmodell Zugriff auf den Docker-Socket

Der Mastercontainer erstellt und verwaltet nebengeordnete Container. Die aktuellen Upstream-Anweisungen binden daher /var/run/docker.sock im Mastercontainer schreibgeschützt ein. Wenn der Socket fehlt oder nicht zugänglich ist, kann AIO den restlichen Stack nicht korrekt orchestrieren.

Binden Sie den Socket nicht mit unnötigen Schreibberechtigungen ein und machen Sie ihn keinen sachfremden Containern zugänglich.

Namen und Zweck des AIO-Mastercontainer-Volumes unverändert beibehalten

In den aktuellen AIO-Beispielen wird das benannte Volume nextcloud_aio_mastercontainer für die eigene Konfiguration von AIO. Der Upstream warnt davor, erforderliche Bestandteile beiläufig umzubenennen oder zu ändern, da die Update- und Verwaltungslogik die dokumentierte Struktur erwartet.

Der Reverse-Proxy-Modus ändert, welche AIO-Ports veröffentlicht werden müssen

In den aktuellen AIO-Compose-Kommentaren steht, dass die Host-Ports 80 und 8443 entfernt werden können, wenn AIO hinter einem Reverse-Proxy wie Nginx, Caddy, Apache oder Cloudflare Tunnel ausgeführt wird, während die AIO-Oberfläche auf 8080 bleibt und Apache einen separat konfigurierten Port verwenden kann.

Das ist präziser, als privilegierten Modus, um einen Portkonflikt zu umgehen.

AIO und standardmäßiges Nextcloud Compose haben unterschiedliche Betriebsmodelle

AIO vereinfacht Upgrades, Backups und zugehörige Dienste, indem der Mastercontainer den Stack verwaltet. Eine standardmäßige Compose-Bereitstellung gibt dem NAS-Administrator direkte Kontrolle über jeden Dienst, jeden Pfad und jede Proxy-Entscheidung. Der Benutzer aus der Quelle entschied sich nach Problemen mit AIO für das zweite Modell.

Keine der beiden Optionen ist dauerhaft grundsätzlich „kompatibler“; wählen Sie das Modell, das Sie bereit sind zu warten, und befolgen Sie konsequent dessen Upstream-Dokumentation.

Nextcloud-AIO-FAQ

Hat die Quelle bewiesen, dass ZimaOS 1.5.0 Nextcloud AIO generell blockiert hat?

Nein. Es werden zwei Fehlerfälle aus der Community dokumentiert, ohne eine von IceWhale bestätigte allgemeingültige Ursache.

Sollte der privilegierte Modus die erste Lösung sein?

Nein. Der ursprüngliche Verfasser hat es versucht, und der Apache-Schreibfehler blieb bestehen.

Kann AIO hinter einem Reverse-Proxy laufen, ohne Host-Port 80 zu belegen?

Ja. Die aktuelle AIO-Dokumentation enthält ein APACHE_PORTbasierter Reverse-Proxy-Workflow.