Wie man Docker in einem Homelab auf einem NAS oder Heimserver verwendet

Docker ermöglicht es Ihnen, ein Homelab als wiederholbare Anwendungsplattform zu nutzen, indem Sie jeden Dienst, Port, jedes Netzwerk und jeden Pfad für persistente Daten vor der Bereitstellung definieren.

Auf einem NAS oder Heimserver bedeutet das, dass Sie DNS-Filterung, Überwachung, Medien, Dateisynchronisation, Dashboards und andere selbstgehostete Apps ausführen können, ohne jede Abhängigkeit direkt auf dem Host zu installieren. Das praktische Ziel ist nicht nur, einen Container einmal zu starten. Es geht darum, einen Stack zu bauen, der Neustarts übersteht, seine Daten durch Updates behält, nur dort erreichbar bleibt, wo es vorgesehen ist, und wiederhergestellt werden kann, wenn etwas schiefgeht.

Was Docker in einem Homelab macht

Docker verpackt eine Anwendung und ihre Laufzeitabhängigkeiten in ein Image und startet dieses Image dann als Container. Der Host stellt weiterhin CPU, Arbeitsspeicher, Speicher und Netzwerk bereit, aber jeder Dienst erhält eine definierte Umgebung, die leichter reproduzierbar ist als eine lange Liste manueller Installationsschritte.

Fünf Konzepte erklären den Großteil der Docker-Konfiguration, die Sie in einem Homelab verwenden werden:

Ein Container sollte als austauschbar betrachtet werden. Ihre Compose-Datei, Umgebungs-Einstellungen und persistente Daten sind die Teile, die den Dienst wiederherstellbar machen.

Was Sie vor der Installation von Docker benötigen

Beginnen Sie damit zu entscheiden, wo Docker ausgeführt werden soll. Ein NAS-Betriebssystem bietet möglicherweise einen visuellen App-Manager, während ein Standard-Linux-Heimserver normalerweise Docker Engine und das Compose-Plugin über die Befehlszeile verwendet. Eine virtuelle Maschine kann ebenfalls funktionieren, wenn Sie Docker vom Basis-Hypervisor trennen möchten.

• Bestätigen Sie, ob der Host amd64 oder arm64 verwendet, damit Sie kompatible Images auswählen können.
• Reservieren Sie eine stabile LAN-Adresse durch DHCP-Reservierung oder eine statische IP.
• Erstellen Sie einen persistenten Speicherort für Container-Konfigurationen und Datenbanken, getrennt von großen Medienfreigaben.
• Wählen Sie entweder Compose-Projekte oder einen visuellen Manager als primären Workflow, anstatt undokumentierte Methoden zu mischen.
• Entscheiden Sie, welche Dienste nur im LAN bleiben und welche eventuell Fernzugriff benötigen.
• Wählen Sie ein zweites Speicherziel für Backups von Compose-Dateien und persistenten Daten.

Wenn der Host selbst noch geplant wird, kann der Leitfaden auf wie man einen eigenen Heimserver baut helfen, die Speicher-, Netzwerk- und Betriebssystemgrundlage zu schaffen, bevor Docker hinzugefügt wird.

Installieren Sie Docker und überprüfen Sie den Host

Die Installationsmethode hängt vom Betriebssystem ab, aber die Validierungssequenz sollte konsistent bleiben. Einige NAS-Plattformen bündeln Docker hinter einer App-Oberfläche. Ein Linux-Host benötigt normalerweise Docker Engine und das Compose-Plugin, während Windows und macOS besser zum Lernen oder Testen als für einen dauerhaft laufenden NAS-Dienst geeignet sind.

Eine einsteigerfreundliche Docker-Homelab-Einrichtung zeigt die nützliche Abfolge von Docker-Installation, Ausführen eines ersten Containers, Organisieren von Projektordnern und Verschieben wiederholbarer Dienste in Compose. Verwenden Sie diese Abfolge als Rahmen und folgen Sie dann der für Ihr NAS oder Ihre Linux-Distribution erforderlichen Installationsmethode.

Überprüfen Sie Docker und Compose

Nach der Installation öffnen Sie ein Terminal auf dem Host und bestätigen, dass sowohl Docker als auch Compose reagieren:

docker --version
docker compose version

Wenn einer der Befehle fehlt, stoppen Sie hier und beheben Sie die Installation, bevor Sie Anwendungsordner erstellen. Unter Linux bestätigen Sie außerdem, dass der Docker-Dienst automatisch startet und dass das für die Verwaltung verwendete Konto geschützt ist. Der Zugriff auf den Docker-Daemon ist effektiv ein administrativer Zugriff auf den Host.

Führen Sie einen temporären Validierungscontainer aus

Verwenden Sie einen temporären Container, um zu bestätigen, dass der Daemon ein Image herunterladen und starten kann:

docker run --rm hello-world

Ein erfolgreicher Ergebnis bestätigt den grundlegenden Pfad vom Kommandozeilen-Client zum Docker-Daemon und Image-Registry. Der --rm Option entfernt diesen Testcontainer nach dem Beenden, sodass er nicht Teil Ihres permanenten Stacks wird.

Bestätigen Sie die grundlegenden Admin-Befehle

docker ps
docker ps -a
docker images

docker ps zeigt laufende Container an, docker ps -a beinhaltet gestoppte Container, und docker images zeigt auf dem Host gespeicherte Images an. Diese drei Ansichten reichen oft aus, um festzustellen, ob ein Problem durch einen gestoppten Container, ein nie heruntergeladenes Image oder einen nie erstellten Dienst verursacht wird.

-15% OFF

ZimaBoard 2 – Mini-Heimserver für Ihre große Idee

Single board computer zimaboard2

$339.00 - $519.00

Buy Now

Ihr erstes Docker Compose Stack bereitstellen

Einmalig docker run Befehle sind für Tests nützlich, aber Compose ist einfacher zu wiederholen, zu überprüfen, zu sichern und zu migrieren. Jedes Projekt erhält sein eigenes Verzeichnis und eine compose.yaml Datei, die Image, Ports, Speicher, Neustartverhalten und Netzwerk aufzeichnet.

Projektverzeichnis erstellen

Das folgende Beispiel erstellt eine kleine Nginx-Startseite. Sie ist bewusst einfach gehalten, testet aber denselben Workflow, den Sie für ein Dashboard, einen Mediaserver, ein Überwachungstool oder eine persönliche Cloud verwenden werden:

mkdir -p ~/docker/start-page/site
cd ~/docker/start-page
printf '<h1>Docker Homelab läuft</h1>\n' > site/index.html

Jeden Service in einem separaten Ordner zu halten, erleichtert die Identifikation seiner Compose-Datei, Umgebungswerte und persistenten Daten. Ein größeres NAS kann einen Pfad wie /docker/start-page oder stattdessen einen dedizierten gemeinsamen Ordner anstelle des Home-Verzeichnisses.

Compose-Datei erstellen

Erstellen Sie eine Datei namens compose.yaml im Projektverzeichnis:

Services:
  start-page:
    Image: nginx:alpine
    Containername: homelab-start-page
    Ports:
      - "8080:80"
    Volumes:
      - ./site:/usr/share/nginx/html:ro
    Neustart: unless-stopped
    Netzwerke:
      - homelab

Netzwerke:
homelab:
Treiber: bridge

Die Portweiterleitung sendet Anfragen von Port 8080 auf dem NAS zu Port 80 innerhalb des Containers. Das Bind-Mount macht das lokale Seite Verzeichnis innerhalb von Nginx als schreibgeschützten Inhalt verfügbar. Die Neustart-Richtlinie bringt den Service nach einem normalen Neustart zurück, es sei denn, Sie haben ihn absichtlich gestoppt.

Dieses Beispiel veröffentlicht Port 8080 auf dem Host. Lassen Sie die Portweiterleitung im Router während des Tests deaktiviert. Wenn der Service nur vom Docker-Host selbst erreichbar sein soll, binden Sie ihn mit 127.0.0.1:8080:80 stattdessen.

Service starten und überprüfen

docker compose up -d
docker compose ps
docker compose logs --tail=100

Öffnen http://NAS-IP:8080 von einem Gerät im selben Netzwerk. Die Seite sollte „Docker Homelab läuft.“ anzeigen. Starten Sie dann den Host einmal neu und bestätigen Sie, dass der Container automatisch zurückkehrt.

Die Befehle, die Sie am häufigsten verwenden werden, sind:

Vermeiden Sie das Hinzufügen von -v zu docker compose down es sei denn, Sie möchten absichtlich von Compose verwaltete Volumes entfernen. Das Entfernen des Containers ist Routine; das Entfernen persistenter Daten nicht.

Wenn Ihr NAS-Betriebssystem einen visuellen Docker-App-Manager bietet, sind dieselben Felder weiterhin wichtig. Die Oberfläche sollte das Image, Host-Ports, Container-Ports, gemountete Pfade, Umgebungsvariablen und das Neustartverhalten sichtbar machen. Dieser NAS-Betriebssystem-Workflow ist nützlich, wenn Sie eine GUI bevorzugen, aber dennoch vorhersehbare App-Pfade wünschen.

Speichern Sie Docker-Daten sicher auf einem NAS

Container sind austauschbar, aber Dienst-Daten nicht. Die meisten Homelab-Ausfälle nach einem Update entstehen durch eine Datenbank, eine Kontodatei oder eine Anwendungs-Konfiguration, die nur innerhalb der Container-Ebene gespeichert wurde. Das erneute Erstellen dieses Containers führt dann zu einer sauberen Installation statt zur Wiederherstellung des ursprünglichen Dienstes.

Ein Bind Mount verbindet eine bekannte Host-Datei oder ein Verzeichnis mit einem Container. Ein Volume wird von Docker im eigenen Speicherbereich verwaltet. Beide können Daten erhalten, unterscheiden sich jedoch in Sichtbarkeit und Backup-Workflow.

Trennen Sie Anwendungsdaten von großen Mediendateien

Bewahren Sie Konfigurationen, Datenbanken, Thumbnails, Indizes und andere kleine Dateien auf einem dedizierten docker-data Ort, der häufig gesichert wird. Große Filme, Fotos, Aufnahmen und Downloads können auf normalen Medienfreigaben bleiben. Diese Trennung macht den Backup-Bereich klarer und verhindert, dass Anwendungs-Metadaten mit großen sequentiellen Speicherlasten konkurrieren.

Bevor Sie eine echte Anwendung bereitstellen, notieren Sie jeden Host-Pfad, der in der Compose-Datei verwendet wird. Ein einfaches Layout könnte so aussehen:

/docker  
  /app-name  
    compose.yaml
    .env  
    /config  
    /data  

Sichern Sie, was den Dienst neu erstellt

Sichern Sie die Compose-Datei sowie alle .env Dateien, Zertifikate, benutzerdefinierte Konfigurationen und die persistenten Container-Daten. Images müssen normalerweise nicht gesichert werden, da sie erneut heruntergeladen werden können. Schützen Sie Umgebungsdateien sorgfältig, da sie Passwörter, Tokens oder Datenbank-Zugangsdaten enthalten können.

Die 3-2-1-Backup-Regel bietet ein nützliches Planungsmodell, aber ein Docker-Backup ist erst vollständig, wenn Sie den Stack neu erstellen und die Daten wiederherstellen können. Testen Sie eine Wiederherstellung an einem nicht-kritischen System, bevor Ihr Homelab auf den Dienst angewiesen ist.

Wenn Sie eine visuelle NAS-Oberfläche verwenden, überprüfen Sie, wo deren persistente Container-Daten gespeichert werden, anstatt davon auszugehen, dass die Oberfläche diese automatisch schützt.

Wie Docker-Netzwerke in einem Homelab funktionieren

Docker-Netzwerke steuern zwei verschiedene Pfade: die Kommunikation zwischen Containern und den Zugriff von Geräten außerhalb von Docker. Die Trennung dieser Pfade reduziert unnötige Portfreigaben und macht Multi-Service-Stacks leichter verständlich.

Lesen Sie Portzuordnungen von links nach rechts

In 8080:80, Port 8080 gehört zum Docker-Host und Port 80 zum Container. Geräte im LAN verbinden sich mit der NAS-Adresse und dem Host-Port. Docker leitet die Anfrage dann an den internen Port der Anwendung weiter.

Veröffentlichen Sie einen Host-Port nur, wenn ein Browser, Telefon, Fernseher oder ein anderes Nicht-Docker-Gerät direkten Zugriff benötigt. Eine Datenbank, die nur von einem anderen Container genutzt wird, benötigt normalerweise keinen veröffentlichten Port.

Verwenden Sie benutzerdefinierte Netzwerke für zusammengehörige Dienste

Compose kann für jeden Stack ein benutzerdefiniertes Bridge-Netzwerk erstellen. Container in diesem Netzwerk können sich gegenseitig über den Servicenamen erreichen, was bedeutet, dass eine Webanwendung eine Verbindung zu einem Dienst mit dem Namen Datenbank ohne sich auf eine sich ändernde Container-IP-Adresse zu verlassen.

Ein praktisches Beispiel für benutzerdefinierte Docker-Netzwerke und Container-Isolierung zeigt, wie sich Namensauflösung und Konnektivität ändern, wenn Container auf separaten Bridge-Netzwerken platziert oder mit mehr als einem Netzwerk verbunden werden.

Gruppieren Sie Dienste, die wirklich miteinander kommunizieren müssen. Halten Sie nicht zusammenhängende Stacks in separaten Netzwerken und veröffentlichen Sie keine interne Datenbank, keinen Cache oder keine Nachrichtenwarteschlange nur, damit die Container sich gegenseitig sehen können.

Trennen Sie LAN-Zugriff vom Internetzugriff

Ein Dienst, der erreichbar ist unter NAS-IP:8080 in Ihrem Heimnetzwerk ist nicht automatisch aus dem Internet erreichbar. Öffentliche Exposition erfordert normalerweise eine Router-Weiterleitungsregel, einen Tunnel, ein VPN oder einen anderen Fernzugriffspfad. Betrachten Sie diesen zusätzlichen Schritt als eine separate Sicherheitsentscheidung und nicht als Teil jeder Bereitstellung.

Docker-Dienste sicher freigeben

Fernzugriff ist der Punkt, an dem ein praktisches Homelab zu einer echten Sicherheitslücke werden kann. Die sicherere Standardlösung ist, Anwendungsoberflächen privat im LAN zu halten und nur eine kontrollierte Zugriffsschicht freizugeben, wenn Fernzugriff notwendig ist.

Verwenden Sie ein VPN für privaten Fernzugriff

Ein privates VPN oder Overlay-Netzwerk ermöglicht es genehmigten Geräten, auf Heimdienste zuzugreifen, ohne jede Anwendung direkt zu veröffentlichen. Dies ist oft der einfachste Weg für persönliche Dashboards, Admin-Panels, Dateizugriff und Dienste, die nur von wenigen vertrauenswürdigen Personen genutzt werden. Der Leitfaden zum sicheren Fernzugriff behandelt die umfassendere Entscheidung zwischen VPN-basiertem Zugriff und öffentlicher Web-Exposition bei Heimservern.

Verwenden Sie einen Reverse-Proxy als öffentlichen Einstiegspunkt

Wenn ein Webdienst öffentlich sein muss, bietet ein Reverse-Proxy einen zentralen Ort für Hostnamen, Zertifikate, Routing-Regeln und Zugriffskontrollen. Stellen Sie den Proxy bereit, anstatt für jede Anwendung einen separaten Router-Port weiterzuleiten. Halten Sie Datenbanken, Admin-Oberflächen und interne Service-Ports wann immer möglich in privaten Docker-Netzwerken.

Verwenden Sie HTTPS und gezielte Portregeln

Jeder Login oder jede Sitzung, die außerhalb des Heimnetzwerks erreichbar ist, sollte HTTPS verwenden. Überprüfen Sie regelmäßig die Router-Weiterleitungsregeln und entfernen Sie Einträge, die nicht mehr benötigt werden. Zertifikatsautomatisierung hilft, ersetzt aber keine starke Authentifizierung, zeitnahe Updates oder sorgfältige Kontrolle darüber, welche Dienste öffentlich sind.

Stack aktualisieren, überwachen und wiederherstellen

Ein Docker-Homelab bleibt überschaubar, wenn die Wartung einer wiederholbaren Reihenfolge folgt. Aktualisieren Sie nicht blind alle Dienste gleichzeitig. Beginnen Sie mit einem Backup, aktualisieren Sie einen Stack und überprüfen Sie die wichtigen Pfade, bevor Sie zur nächsten Anwendung wechseln.

Verwenden Sie eine kontrollierte Update-Reihenfolge

cd ~/docker/start-page
docker compose pull
docker compose up -d
docker compose ps
docker compose logs --tail=100

Für einen wichtigen Dienst notieren Sie den funktionierenden Image-Tag vor einem Update, damit Sie eine Rollback-Referenz haben. Testen Sie nach der Neu-Bereitstellung den Login, eingebundenen Speicher, Datenbankverbindung, LAN-Zugriff und alle Reverse-Proxy-Routen. Ein „Up“-Container-Status beweist nur, dass der Prozess läuft; er beweist nicht, dass die Anwendung gesund ist.

Beobachten Sie die Signale, die leise driften

• Systemlaufwerksnutzung durch alte Images, beschreibbare Layer, Protokolle und verwaiste Daten.
• Container-Neustartanzahl und wiederholte Fehler in den Anwendungsprotokollen.
• Unerwartete Router-Weiterleitungen oder Host-Ports, die nicht mehr benötigt werden.
• Alter des Backups, Backup-Größe und ob das neueste Archiv geöffnet werden kann.
• Speicherdruck, wenn zusätzliche Dienste zu einem kleinen NAS hinzugefügt werden.

Verwenden Sie Bereinigungsbefehle nur, nachdem Sie überprüft haben, was sie entfernen. Unbenutzte Images verbrauchen Speicherplatz, aber aggressives Aufräumen kann auch zwischengespeicherte Layer oder ungenutzte Volumes löschen, die für einen Wiederherstellungsplan noch wichtig sind.

Eine Wiederherstellung üben

Wählen Sie einen nicht-kritischen Dienst, stoppen Sie ihn, verschieben Sie seine persistenten Daten beiseite und bauen Sie ihn aus der Compose-Datei neu auf. Stellen Sie dann die Daten wieder her und bestätigen Sie, dass Konten, Einstellungen und Anwendungszustand zurückkehren. Eine erfolgreiche Wiederherstellung ist ein stärkerer Beweis als ein grüner Backup-Job.

Häufige Docker-Homelab-Probleme und Lösungen

Wählen Sie den nächsten Container für Ihr Homelab

Nachdem der erste Compose-Stack einen Neustart und ein kleines Update überstanden hat, fügen Sie einen Dienst hinzu, der einen echten Haushaltsbedarf löst. Jede Kategorie vermittelt eine andere betriebliche Lektion:

Ein DNS-basierter Filter ist nützlich, wenn der gesamte Haushalt von einem Netzwerkdienst profitiert. Für Speicher-Workflows zeigt private Dateisynchronisation, warum Konfigurationen und Datenbanken außerhalb der flüchtigen Container-Ebene bleiben müssen. Ein Plex-Medienserver fügt Medienberechtigungen, Metadatenplatzierung und mögliche Transcodierungsanforderungen hinzu.

Fügen Sie nicht mehrere kritische Dienste auf einmal hinzu. Ein kleiner Stack mit dokumentierten Pfaden, enger Exposition und einem getesteten Backup ist nützlicher als ein überfülltes Dashboard, das niemand zuverlässig wiederherstellen kann.

FAQs

Kann ich Docker auf einem ARM-basierten NAS verwenden?

Oft ja. Das Image muss einen Build für die NAS-Architektur bereitstellen. Prüfen Sie die vom Image angebotene Plattform vor der Bereitstellung, besonders bei kleineren Projekten, die amd64, aber nicht arm64 unterstützen könnten. Eine Architekturinkompatibilität kann verhindern, dass der Container startet, selbst wenn die Compose-Datei ansonsten korrekt ist.

Wie viel RAM benötigt ein Docker-Homelab?

Es gibt keine universelle Zahl, da ein DNS-Filter, Mediaserver, Datenbank und KI-Dienst sehr unterschiedliche Speicherprofile haben. Listen Sie die Dienste auf, die Sie betreiben möchten, starten Sie mit einem kleinen Stack, messen Sie die Spitzenlast über mehrere Tage und lassen Sie Spielraum für Betriebssystem, Dateisystem-Cache, Updates und temporäre Spitzen.

Brauche ich Docker Compose, wenn mein NAS eine GUI hat?

Nein. Eine gut gestaltete GUI kann ein einfaches Homelab verwalten, besonders wenn sie jeden Pfad, Port, jede Variable und Neustart-Einstellung zugänglich macht. Compose wird wertvoller, wenn Sie versionierte Konfiguration, einfachere Migration, wiederholbare Wiederherstellung oder mehrere verwandte Dienste in einem Stack wünschen.

Soll jeder Container sein eigenes Netzwerk haben?

Nicht unbedingt. Erstellen Sie Netzwerke um Anwendungsgrenzen herum, anstatt jedem einzelnen Container ein eigenes Netzwerk zuzuweisen. Eine Web-App und ihre Datenbank können ein privates Netzwerk teilen, während ein nicht verwandter Mediaserver ein anderes nutzt. Veröffentlichen Sie nur die Ports, die Nicht-Docker-Geräte benötigen.

Was ist der sicherste Weg, um remote auf Docker-Dienste zuzugreifen?

Für den persönlichen Zugriff kann ein persönliches VPN, das Sie zu Hause betreiben, die Notwendigkeit verringern, mehrere Anwendungsports öffentlich freizugeben. Öffentliche Dienste benötigen in der Regel einen Reverse-Proxy, HTTPS, starke Authentifizierung, zeitnahe Updates und eine bewusste Entscheidung darüber, was privat bleibt.

Woran erkenne ich, ob ein Docker-Backup vollständig ist?

Sie sollten in der Lage sein, die Container aus der Compose-Datei neu zu erstellen und den Anwendungszustand aus den gespeicherten persistenten Daten wiederherzustellen. Ein Backup, das nur Images oder eine Compose-Datei ohne Datenbank- und Konfigurationsverzeichnisse enthält, reicht für die meisten zustandsbehafteten Dienste nicht aus.

Bauen Sie ein Homelab, das Sie reproduzieren können

Zu lernen, wie man Docker in einem Homelab verwendet, bedeutet weniger, Container zu sammeln, sondern vielmehr, jeden Dienst wiederholbar zu machen. Überprüfen Sie zuerst Docker, behalten Sie pro Anwendung ein Compose-Projekt, speichern Sie den Zustand außerhalb des Containers, veröffentlichen Sie nur notwendige Ports und testen Sie eine Wiederherstellung, bevor der Dienst wichtig wird.

Sobald der erste Stack einen Neustart, ein Update und eine Wiederherstellungsübung übersteht, fügen Sie die nächste Anwendung mit derselben Disziplin hinzu. Diese Reihenfolge verwandelt ein NAS von einem Ort, an dem Container zufällig laufen, in einen Heimserver, den Sie verstehen, warten und wiederaufbauen können.