Docker-Fehlerbehebung
Diese Seite bietet speziell für Docker-Container auf Unraid, die vom Unraid-Team verwaltet werden, Problembehebungshinweise an. Für fortgeschrittene Problembehebung, tiefere technische Details oder Themen, die über die Unraid-spezifische Implementierung hinausgehen, bitte auf die offizielle Docker-Dokumentation verweisen.
Docker erleichtert es, eine Vielzahl von Anwendungen auf Ihrem Unraid-Server auszuführen, aber es können Probleme auftreten, wie z.B. Container, die nicht starten, beschädigte Docker-Abbilddateien oder Netzwerkprobleme. Diese Seite befasst sich mit einigen häufigen Problemen im Zusammenhang mit Docker auf Unraid und bietet bewährte Verfahren zu deren effektiven Lösung.
Das Docker-Image-Datei neu erstellen
A corrupted Docker image file (docker.img) is a common issue, often caused by the cache pool running out of space or an unclean shutdown. Luckily, a well-configured container stores all variable data outside the image file (usually in the appdata share), so you can safely recreate the image without losing your application settings or data.
Um die Docker-Image-Datei neu zu erstellen:
- Gehen Sie zu Einstellungen → Docker in der WebGUI.
- Setzen Sie Docker aktivieren auf Nein und klicken Sie auf Anwenden, um den Docker-Dienst zu stoppen.
- Wählen Sie die Option zum Löschen der Docker-vdisk-Datei und klicken Sie dann auf Anwenden. Sie können die Datei auch manuell löschen, falls erforderlich.
- Bestätigen Sie den Speicherort und den Dateinamen für die neue Docker-vdisk-Datei. Diese Einstellung umfasst sowohl den Ordnerpfad als auch den Dateinamen.
- Legen Sie die gewünschte Größe für die neue Abbilddatei fest. Die Standardgröße ist normalerweise für die meisten Benutzer ausreichend.
- Setzen Sie Docker Aktivieren auf Ja und klicken Sie auf Anwenden. Unraid erstellt und formatiert eine neue
docker.img-Datei mit BTRFS.
Nun sind Sie bereit, Ihre Container mit ihren gespeicherten Einstellungen neu zu installieren.
Docker-Anwendungen neu installieren
Unraid speichert automatisch eine Vorlage für jeden auf Ihrem Flash-Laufwerk installierten Container. Diese Vorlagen speichern Ihre Konfiguration, was es erleichtert, Container nach dem Erstellen der Docker-Abbilddatei wiederherzustellen.
Um Ihre Container neu zu installieren:
- Gehen Sie zum Apps-Tab in der WebGUI.
- Öffnen Sie den Abschnitt Vorherige Apps.
- Wählen Sie die Container aus, die Sie neu installieren möchten.
- Fahren Sie mit der Installation fort. Unraid wird jeden Container erneut herunterladen und Ihre vorherigen Einstellungen automatisch anwenden.
Dieser Prozess stellt Ihre Container in ihren vorherigen Zustand wieder her, sofern alle variablen Daten außerhalb der Docker-Image-Datei abgebildet wurden (zum Beispiel im appdata-Share).
Wenn ein Container nach der Neuinstallation nicht startet, prüfen Sie seine Protokolle im Kontextmenü des Docker-Tabs auf Fehlermeldungen und Hinweise zur Fehlerbehebung.
Überprüfen Sie, dass alle zugeordneten Hostpfade vorhanden sind und die richtigen Berechtigungen nach der Wiederherstellung Ihrer Container haben. Falsche Zuordnungen oder Berechtigungen sind eine häufige Ursache für Startprobleme.
Wiederherstellung von Docker-Benutzernetzwerken
Benutzerdefinierte Docker-Netzwerke bleiben nicht bestehen, wenn die Docker-Abbilddatei gelöscht wird. Bevor Sie das Abbild entfernen, dokumentieren Sie Ihre benutzerdefinierten Netzwerknamen, indem Sie ein Terminal öffnen und folgende Befehle ausführen:
docker network ls
Notieren Sie sich die Namen aller von Ihnen erstellten Netzwerke (mit Ausnahme der Standardnetzwerke bridge, host und none).
Um benutzerdefinierte Netzwerke wiederherzustellen:
-
Erstellen Sie nach dem Neu-Erstellen der Docker-Image-Datei jedes benutzerdefinierte Netzwerk erneut mit:
docker network create <network-name>Ersetzen Sie
<network-name>durch den zuvor aufgenommenen genauen Namen. -
Aktualisieren Sie Ihre Container, um die wiederhergestellten Netzwerke bei Bedarf zu verwenden.
Sie können den Hostzugriff auf benutzerdefinierte Netzwerke unter Einstellungen → Docker aktivieren, indem Sie Hostzugriff auf benutzerdefinierte Netzwerke auf Aktiviert setzen, wenn Ihre Einrichtung dies erfordert.
Wenn Container nach der Wiederherstellung nicht wie erwartet kommunizieren können, überprüfen Sie Ihre Docker-Netzwerkeinstellungen auf Konflikte oder Verbindungsprobleme.