Wenn Plex, Radarr, Sonarr oder eine andere Docker-App nach jedem Neustart von ZimaOS den Zugriff auf ein entferntes SMB-NAS verliert, überprüfen Sie die Einbindung auf dem Host, bevor Sie die Anwendung ändern. Der Container kann eine Netzwerkfreigabe nur sehen, wenn ZimaOS sie erfolgreich eingebunden hat und der Docker-Bind-Pfad weiterhin auf diesen eingebundenen Speicherort verweist.
In einem Community-Fall mit einer Synology-Freigabe wurde der Zugriff jedes Mal wiederhergestellt, wenn der Benutzer denselben Ordner im Pfadauswahldialog von Docker Compose erneut auswählte. Das deutet stark auf ein Problem mit der Persistenz der Einbindung bzw. des Pfads hin. Die Erklärung im Forum, dass ZimaOS immer eine neue interne Einbindungs-ID erzeugt, war jedoch eine Schlussfolgerung aus der Community und keine von IceWhale bestätigte Grundursache. Ein guter Leitfaden sollte daher die Einbindung, den Pfad und die Startreihenfolge getrennt untersuchen.
Bestätigen Sie zunächst, ob die SMB-Freigabe nach einem Neustart eingebunden ist
Bevor Sie Plex oder Radarr öffnen, öffnen Sie „Dateien“ in ZimaOS und durchsuchen Sie die Freigabe des entfernten NAS. Wenn die Freigabe selbst nicht verfügbar ist, liegt das Problem nicht zuerst bei der Docker-App.
Wenn die Freigabe fehlt
Prüfen Sie, ob das entfernte NAS online ist, seine IP-Adresse bzw. sein Hostname weiterhin aufgelöst wird, SMB aktiviert ist und die gespeicherten Anmeldedaten noch gültig sind. Verbinden Sie die Freigabe bei Bedarf über den ZimaOS-Netzwerkspeicher-Workflow erneut.
Wenn die Freigabe in „Dateien“ sichtbar ist
Wechseln Sie anschließend zur Docker-Zuordnung. Die Einbindung auf dem Host ist vorhanden, aber die Anwendung verweist möglicherweise weiterhin auf einen veralteten oder nicht verfügbaren Pfad.
Verwenden Sie den ZimaOS-Netzwerkspeicher statt eines manuell erstellten fstab-Eintrags
Der Benutzer erwog, Folgendes zu bearbeiten: /etc/fstab. Das ist nicht die beste erste Lösung für ein Appliance-ähnliches Betriebssystem, das Netzwerkspeicher bereits über seine Benutzeroberfläche verwaltet.
Die aktuelle ZimaOS-Dokumentation zeigt den SMB-basierten Zugriff auf ein anderes NAS als Teil der Migrations- und Netzwerk-Speicher-Workflows. Verwenden Sie zuerst diesen verwalteten Weg, damit ZimaOS Anmeldedaten und Einbindungsstatus konsistent verwalten kann.
Der Leitfaden zur NAS-Migration mit ZimaOS dient als aktuelle Referenz.
Den Docker-Hostpfad prüfen, nicht nur den Containerpfad
Docker-Volume-Zuordnungen haben zwei Seiten:
- Hostpfad: der Ort, an dem ZimaOS den eingebundenen Synology-Ordner sieht;
- Containerpfad: der stabile Pfad, den Plex, Radarr oder Sonarr innerhalb des Containers sieht.
Wenn die Host-Seite nach dem Neustart ungültig ist, kann der Containerpfad in der Benutzeroberfläche der Anwendung weiterhin korrekt aussehen, obwohl er auf nichts Brauchbares verweist.
Der aktuelle ZimaOS-Leitfaden zu Docker-Pfaden erläutert diesen Unterschied.
Ordner einmalig zur Diagnose erneut auswählen
Wenn die Remote-Freigabe in Dateien sichtbar ist, die Anwendung jedoch nicht darauf zugreifen kann, öffnen Sie die App- oder Compose-Konfiguration und wählen Sie den Hostordner mithilfe der ZimaOS-Pfadauswahl erneut aus.
Wenn der Zugriff sofort wiederhergestellt ist, ohne dass Anmeldedaten oder Containerpfade geändert wurden, spricht dies stark dafür, dass der Fehler zwischen dem verwalteten Mount und der Docker-Bind-Zuordnung liegt.
Startreihenfolge nach jedem Neustart prüfen
Remote-SMB-Speicher hängt von Netzwerkverbindung, DNS-/IP-Erreichbarkeit, Authentifizierung und der Bereitschaft des NAS ab. Docker-Container können schneller starten, als der Remote-Mount verfügbar wird.
Einfacher Test
- starten Sie ZimaOS neu;
- warten Sie, bis die Remote-Freigabe in Dateien durchsucht werden kann;
- Starten Sie nur die betroffene Docker-Anwendung neu;
- Prüfen Sie, ob die Medien oder Downloads wieder verfügbar sind.
Wenn das zuverlässig funktioniert, ist der Pfad möglicherweise stabil und das eigentliche Problem liegt eher im Startzeitpunkt als in wechselnden Mount-IDs.
Berechtigungen auf beiden Systemen prüfen
Das für den SMB-Mount verwendete Synology-Konto muss Zugriff auf die Medienordner haben. Anschließend muss der ZimaOS-Mount für den Docker-Prozess zugänglich sein. Schließlich muss die Anwendung den korrekten Containerpfad verwenden.
Berechtigungsprobleme können wie ein fehlender Mount aussehen. Prüfen Sie daher „Zugriff verweigert“ getrennt von „Pfad nicht gefunden“ oder „keine solche Datei“.
Warum manuelle Änderungen an der fstab die Wiederherstellung erschweren können
Eine benutzerdefinierte Einbindung kann Anmeldedateien, Startabhängigkeiten, Timing-Optionen und ein Fehlerverhalten einführen, die ZimaOS in seiner Benutzeroberfläche nicht verwaltet. Wenn diese benutzerdefinierte Einbindung beim Start fehlschlägt, starten Apps möglicherweise trotzdem mit einem leeren Verzeichnis.
Verwenden fstab nur wenn der verwaltete Netzwerkspeicher-Workflow eine Anforderung nicht erfüllen kann und Sie bereit sind, die Einbindung über Updates hinweg zu warten.
So werden Medien-Apps robuster
- Verwenden Sie eine stabile NAS-IP-Adresse oder einen zuverlässigen lokalen DNS-Namen.
- Konfigurieren Sie die entfernte Freigabe über den Netzwerkspeicher.
- Binden Sie einen stabilen Hostordner in den Container ein.
- Verwenden Sie in Radarr, Sonarr, Download-Clients und Mediaservern durchgehend denselben Containerpfad.
- Überprüfen Sie nach Updates oder Änderungen am Speicher die Einbindung, bevor Sie die Anwendungsbibliotheken ändern.
Der Leitfaden zur LAN-Fehlerbehebung hilft dabei festzustellen, ob der Fehler auf der Netzwerkebene beginnt, während die Grundlagen zu Docker-Pfaden den Docker-Kontext erläutern.
FAQ
Warum verlieren meine Docker-Apps nach einem Neustart von ZimaOS eine Synology-Freigabe?
Am wahrscheinlichsten liegt das Problem darin, dass die SMB-Freigabe nicht erneut eingebunden wird, die App einen veralteten Hostpfad verwendet oder der Container startet, bevor die entfernte Freigabe bereit ist. Testen Sie diese Ursachen getrennt.
Sollte ich /etc/fstab bearbeiten?
Nicht als erste Maßnahme. Bevorzugen Sie den ZimaOS-Netzwerkspeicher, damit das System die Freigabe verwaltet. Manuelle Einbindungen erhöhen den Wartungsaufwand und die Komplexität bei der Startreihenfolge.
Warum funktioniert die App, wenn ich denselben Ordner erneut auswähle?
Dabei wird die Bind-Zuordnung auf der Host-Seite aktualisiert. Das ist ein Hinweis auf ein Einbindungs- oder Pfadproblem, selbst wenn sich der sichtbare Ordnername nicht geändert hat.
Kann ich eine entfernte SMB-Freigabe für Plex und die Arr-Apps verwenden?
Ja, sofern ZimaOS es zuverlässig einbindet, die Berechtigungen stimmen und alle Container einheitliche Host- und Containerpfade verwenden.
