Jak korzystać z Dockera w homelabie na NAS lub domowym serwerze

Docker pozwala używać homelabu jako powtarzalnej platformy aplikacyjnej, definiując każdą usługę, port, sieć i ścieżkę danych trwałych przed wdrożeniem.

Na NAS lub domowym serwerze oznacza to, że możesz uruchamiać filtrowanie DNS, monitorowanie, media, synchronizację plików, pulpity nawigacyjne i inne aplikacje self-hosted bez instalowania każdej zależności bezpośrednio na hoście. Praktycznym celem nie jest tylko jednorazowe uruchomienie kontenera. Chodzi o zbudowanie stosu, który przetrwa ponowne uruchomienia, zachowa dane podczas aktualizacji, będzie dostępny tylko tam, gdzie to zamierzone, i będzie można go przywrócić, gdy coś pójdzie nie tak.

Co Docker robi w homelabie

Docker pakuje aplikację i jej zależności środowiskowe do obrazu, a następnie uruchamia ten obraz jako kontener. Host nadal dostarcza CPU, pamięć, przechowywanie i sieć, ale każda usługa ma zdefiniowane środowisko, które łatwiej odtworzyć niż długą listę ręcznych kroków instalacji.

Pięć koncepcji wyjaśnia większość konfiguracji Dockera, której użyjesz w homelabie:

Kontener powinien być traktowany jako wymienny. Plik Compose, ustawienia środowiskowe i dane trwałe to elementy, które pozwalają na odzyskanie usługi.

Co musisz mieć przed instalacją Dockera

Zacznij od decyzji, gdzie będzie działać Docker. System operacyjny NAS może oferować wizualny menedżer aplikacji, podczas gdy standardowy domowy serwer Linux zwykle używa Docker Engine i wtyczki Compose z linii poleceń. Maszyna wirtualna też może działać, gdy chcesz oddzielić Dockera od bazowego hypervisora.

• Potwierdź, czy host używa amd64 czy arm64, aby wybrać kompatybilne obrazy.
• Zarezerwuj stabilny adres LAN przez rezerwację DHCP lub statyczny adres IP.
• Utwórz jedno trwałe miejsce na konfiguracje kontenerów i bazy danych, oddzielone od dużych udziałów multimedialnych.
• Wybierz jako główny sposób pracy projekty Compose lub menedżera wizualnego, zamiast mieszać nieudokumentowane metody.
• Zdecyduj, które usługi pozostaną tylko w sieci LAN, a które mogą w przyszłości wymagać dostępu zdalnego.
• Wybierz drugie miejsce do przechowywania kopii zapasowych plików Compose i danych trwałych.

Gdy sam host jest jeszcze w fazie planowania, przewodnik jak zbudować i skonfigurować własny serwer domowy może pomóc ustalić podstawy przechowywania, sieci i systemu operacyjnego przed dodaniem Dockera.

Zainstaluj Dockera i zweryfikuj hosta

Metoda instalacji zależy od systemu operacyjnego, ale sekwencja walidacji powinna pozostać spójna. Niektóre platformy NAS oferują Dockera za pośrednictwem interfejsu aplikacji. Host Linux zwykle wymaga Docker Engine i wtyczki Compose, podczas gdy Windows i macOS są lepsze do nauki lub testowania niż do stałego uruchamiania usługi NAS.

Przyjazna dla początkujących konfiguracja Docker w domowym laboratorium pokazuje użyteczną sekwencję instalacji Dockera, uruchomienia pierwszego kontenera, organizacji folderów projektów i przenoszenia powtarzalnych usług do Compose. Użyj tej sekwencji jako ram, a następnie postępuj zgodnie z metodą instalacji wymaganą przez twój własny NAS lub dystrybucję Linuksa.

Sprawdź Docker i Compose

Po instalacji otwórz terminal na hoście i potwierdź, że zarówno Docker, jak i Compose odpowiadają:

docker --version
docker compose version

Jeśli którekolwiek polecenie jest niedostępne, zatrzymaj się tutaj i napraw instalację przed tworzeniem folderów aplikacji. Na Linuksie potwierdź również, że usługa Docker uruchamia się automatycznie i że konto używane do zarządzania jest chronione. Dostęp do demona Dockera to w praktyce dostęp administracyjny do hosta.

Uruchom tymczasowy kontener walidacyjny

Użyj tymczasowego kontenera, aby potwierdzić, że demon może pobrać obraz i go uruchomić:

docker run --rm hello-world

Pomyślny wynik potwierdza podstawową ścieżkę od klienta wiersza poleceń do demona Dockera i rejestru obrazów. --rm opcja usuwa ten testowy kontener po jego zakończeniu, więc nie staje się on częścią twojego stałego stosu.

Potwierdź podstawowe polecenia administracyjne

docker ps
docker ps -a
docker images

docker ps wyświetla działające kontenery, docker ps -a zawiera zatrzymane kontenery, oraz docker images wyświetla obrazy przechowywane na hoście. Te trzy widoki często wystarczają, aby stwierdzić, czy problem jest spowodowany przez zatrzymany kontener, obraz, który nigdy nie został pobrany, czy usługę, która nigdy nie została utworzona.

-15% OFF

ZimaBoard 2 – Mini serwer domowy dla Twojego wielkiego pomysłu

Single board computer zimaboard2

$339.00 - $519.00

Buy Now

Wdróż swój pierwszy stos Docker Compose

Jednorazowe docker run polecenia są przydatne do testów, ale Compose jest łatwiejszy do powtarzania, przeglądania, tworzenia kopii zapasowych i migracji. Każdy projekt ma swój własny katalog i compose.yaml plik, który rejestruje obraz, porty, pamięć, zachowanie przy restarcie i sieć.

Utwórz katalog projektu

Poniższy przykład tworzy prostą stronę startową Nginx. Jest celowo prosty, ale testuje ten sam workflow, którego użyjesz dla dashboardu, serwera multimediów, narzędzia monitorującego lub osobistej chmury:

mkdir -p ~/docker/start-page/site
cd ~/docker/start-page
printf '<h1>Docker homelab is running</h1>\n' > site/index.html

Trzymanie każdej usługi w osobnym folderze ułatwia identyfikację jej pliku Compose, wartości środowiskowych i danych trwałych. Większy NAS może użyć ścieżki takiej jak /docker/start-page lub dedykowany folder współdzielony zamiast katalogu domowego.

Utwórz plik Compose

Utwórz plik o nazwie compose.yaml w katalogu projektu:

usługi:
  start-page:
    obraz: nginx:alpine
    nazwa_kontenera: homelab-start-page
    porty:
      - "8080:80"
    wolumeny:
      - ./site:/usr/share/nginx/html:ro
    restart: unless-stopped
    sieci:
      - homelab

sieci:
homelab:
sterownik: bridge

Mapowanie portów przekazuje żądania z portu 8080 na NAS do portu 80 wewnątrz kontenera. Montowanie wiązane udostępnia lokalny strona katalog dostępny w Nginx jako zawartość tylko do odczytu. Polityka restartu przywraca usługę po normalnym restarcie, chyba że celowo ją zatrzymałeś.

Ten przykład publikuje port 8080 na hoście. Podczas testów utrzymuj wyłączone przekierowanie portów w routerze. Gdy usługa powinna być dostępna tylko z samego hosta Dockera, powiąż ją z loopback za pomocą 127.0.0.1:8080:80 zamiast tego.

Uruchom i zweryfikuj usługę

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

Otwórz http://NAS-IP:8080 z urządzenia w tej samej sieci. Strona powinna wyświetlać „Docker homelab is running.” Następnie uruchom ponownie hosta i potwierdź, że kontener uruchamia się automatycznie.

Polecenia, których będziesz używać najczęściej, to:

Unikaj dodawania -v do docker compose down chyba że celowo chcesz usunąć wolumeny zarządzane przez Compose. Usunięcie kontenera jest rutynowe; usunięcie danych trwałych nie jest.

Jeśli system operacyjny NAS oferuje wizualny menedżer aplikacji Docker, te same pola nadal mają znaczenie. Interfejs powinien pokazywać obraz, porty hosta, porty kontenera, zamontowane ścieżki, zmienne środowiskowe oraz zachowanie przy restarcie. Ten workflow systemu operacyjnego NAS jest przydatny, gdy wolisz GUI, ale nadal chcesz przewidywalnych ścieżek aplikacji.

Bezpiecznie przechowuj dane Dockera na NAS

Kontenery są jednorazowe, ale dane usługi nie. Większość awarii homelaba po aktualizacji wynika z bazy danych, pliku konta lub konfiguracji aplikacji zapisanej tylko wewnątrz warstwy kontenera. Ponowne utworzenie tego kontenera powoduje wtedy czystą instalację zamiast przywrócenia oryginalnej usługi.

Bind mount mapuje znany plik lub katalog hosta do kontenera. Wolumin jest zarządzany przez Dockera w jego obszarze pamięci. Oba mogą zachować dane, ale różnią się widocznością i procesem tworzenia kopii zapasowej.

Oddziel dane aplikacji od dużych mediów

Przechowuj konfiguracje, bazy danych, miniatury, indeksy i inne obciążenia małymi plikami na dedykowanym docker-data lokalizacja, która jest często kopiowana. Duże filmy, zdjęcia, nagrania i pobrane pliki mogą pozostać na zwykłych udziałach multimedialnych. To rozdzielenie ułatwia określenie zakresu kopii zapasowej i może zapobiec konkurencji metadanych aplikacji z dużymi, sekwencyjnymi obciążeniami pamięci masowej.

Przed wdrożeniem prawdziwej aplikacji zapisz każdą ścieżkę hosta używaną w pliku Compose. Prosty układ może wyglądać tak:

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

Kopia zapasowa tego, co odtwarza usługę

Zrób kopię pliku Compose oraz każdego .env plik, certyfikaty, niestandardowa konfiguracja oraz trwałe dane kontenera. Obrazy zwykle nie muszą być kopiowane, ponieważ można je ponownie pobrać. Chron pliki środowiskowe ostrożnie, ponieważ mogą zawierać hasła, tokeny lub dane dostępowe do bazy danych.

Zasada 3-2-1 kopii zapasowej to przydatny model planowania, ale kopia zapasowa Dockera jest kompletna tylko wtedy, gdy możesz odtworzyć stos i przywrócić jego dane. Przetestuj jedno niekrytyczne przywrócenie, zanim twój homelab zacznie polegać na tej usłudze.

Korzystając z wizualnego interfejsu NAS, upewnij się, gdzie przechowywane są jego trwałe dane kontenera, zamiast zakładać, że interfejs automatycznie je chroni.

Jak działa sieć Docker w homelabie

Sieciowanie Dockera kontroluje dwie różne ścieżki: komunikację między kontenerami oraz dostęp z urządzeń spoza Dockera. Oddzielenie tych ścieżek zmniejsza niepotrzebne publikowanie portów i ułatwia zrozumienie stosów wielousługowych.

Czytaj mapowania portów od lewej do prawej

W 8080:80, port 8080 należy do hosta Dockera, a port 80 do kontenera. Urządzenia w sieci LAN łączą się z adresem NAS i portem hosta. Docker następnie przekazuje żądanie do wewnętrznego portu aplikacji.

Port hosta publikuj tylko wtedy, gdy przeglądarka, telefon, telewizor lub inne urządzenie spoza Dockera potrzebuje bezpośredniego dostępu. Baza danych używana tylko przez inny kontener zwykle nie wymaga publikowanego portu.

Używaj niestandardowych sieci dla powiązanych usług

Compose może utworzyć zdefiniowaną przez użytkownika sieć mostkową dla każdego stosu. Kontenery w tej sieci mogą się nawzajem odnajdywać po nazwie usługi, co oznacza, że aplikacja webowa może połączyć się z usługą o nazwie baza danych bez polegania na zmieniającym się adresie IP kontenera.

Praktyczny przykład niestandardowych sieci Docker i izolacji kontenerów pokazuje, jak zmienia się rozwiązywanie nazw i łączność, gdy kontenery są umieszczone na oddzielnych sieciach mostkowych lub podłączone do więcej niż jednej sieci.

Grupuj usługi, które naprawdę muszą się komunikować. Trzymaj niepowiązane stosy na oddzielnych sieciach i nie publikuj wewnętrznej bazy danych, pamięci podręcznej ani kolejki wiadomości tylko po to, by kontenery mogły się widzieć.

Oddziel dostęp LAN od dostępu internetowego

Usługa dostępna pod adresem NAS-IP:8080 w twojej sieci domowej nie jest automatycznie dostępne z internetu. Publiczne udostępnienie zwykle wymaga reguły przekierowania w routerze, tunelu, VPN lub innej ścieżki zdalnego dostępu. Traktuj ten dodatkowy krok jako osobną decyzję dotyczącą bezpieczeństwa, a nie część każdej instalacji.

Bezpieczne udostępnianie usług Dockera

Zdalny dostęp to miejsce, gdzie wygodny homelab może stać się prawdziwym zagrożeniem bezpieczeństwa. Bezpieczniejszym domyślnym rozwiązaniem jest utrzymanie interfejsów aplikacji prywatnych w sieci LAN i udostępnianie tylko kontrolowanej warstwy dostępu, gdy zdalne użycie jest konieczne.

Używaj VPN do prywatnego zdalnego dostępu

Prywatna sieć VPN lub sieć nakładkowa pozwala zatwierdzonym urządzeniom na dostęp do usług domowych bez konieczności bezpośredniego udostępniania każdej aplikacji. To często najprostsza droga do osobistych pulpitów nawigacyjnych, paneli administracyjnych, dostępu do plików i usług używanych tylko przez kilka zaufanych osób. Przewodnik po bezpiecznym zdalnym dostępie omawia szerszą decyzję dotyczącą serwera domowego między dostępem opartym na VPN a publiczną ekspozycją w sieci.

Używaj reverse proxy jako publicznego punktu wejścia

Gdy usługa webowa musi być publiczna, reverse proxy zapewnia jedno miejsce dla nazw hostów, certyfikatów, reguł trasowania i kontroli dostępu. Udostępniaj proxy zamiast przekierowywać osobny port routera do każdej aplikacji. Trzymaj bazy danych, interfejsy administracyjne i wewnętrzne porty usług na prywatnych sieciach Docker, gdy to możliwe.

Używaj HTTPS i przemyślanych reguł portów

Każde logowanie lub sesja dostępna spoza sieci domowej powinna używać HTTPS. Regularnie przeglądaj reguły przekierowań routera i usuwaj wpisy, które nie są już potrzebne. Automatyzacja certyfikatów pomaga, ale nie zastępuje silnej autoryzacji, terminowych aktualizacji ani ostrożnej kontroli, które usługi są publiczne.

Aktualizuj, monitoruj i przywracaj stos

Docker homelab pozostaje zarządzalny, gdy konserwacja odbywa się według powtarzalnej sekwencji. Nie aktualizuj wszystkich usług na ślepo jednocześnie. Zacznij od kopii zapasowej, zaktualizuj jeden stos i zweryfikuj ważne ścieżki, zanim przejdziesz do następnej aplikacji.

Używaj kontrolowanej sekwencji aktualizacji

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

Dla ważnej usługi zanotuj tag działającego obrazu przed aktualizacją, aby mieć punkt odniesienia do przywrócenia. Po ponownym wdrożeniu przetestuj logowanie, zamontowane magazyny, połączenie z bazą danych, dostęp do LAN i wszelkie trasy reverse-proxy. Stan kontenera „Up” oznacza tylko, że proces działa; nie dowodzi, że aplikacja jest zdrowa.

Obserwuj sygnały, które cicho się zmieniają

• Wykorzystanie dysku systemowego przez stare obrazy, zapisywalne warstwy, logi i porzucone dane.
• Liczba restartów kontenera i powtarzające się błędy w logach aplikacji.
• Nieoczekiwane przekierowania routera lub porty hosta, które nie są już potrzebne.
• Wiek kopii zapasowej, rozmiar kopii i czy najnowsze archiwum można otworzyć.
• Obciążenie pamięci przy dodawaniu kolejnych usług do małego NAS-a.

Używaj poleceń czyszczenia dopiero po sprawdzeniu, co usuną. Nieużywane obrazy zajmują miejsce, ale agresywne oczyszczanie może też usunąć warstwy cache lub nieużywane wolumeny, które są ważne dla planu odzyskiwania.

Przećwicz jedno przywrócenie

Wybierz usługę niekrytyczną, zatrzymaj ją, przenieś jej trwałe dane na bok i odbuduj ją z pliku Compose. Następnie przywróć dane i potwierdź, że konta, ustawienia i stan aplikacji wracają. Udane przywrócenie jest silniejszym dowodem niż zielone zadanie kopii zapasowej.

Typowe problemy i rozwiązania w Docker Homelab

Wybierz kolejny kontener do swojego homelabu

Po tym, jak pierwszy stos Compose przetrwa restart i małą aktualizację, dodaj jedną usługę, która rozwiązuje rzeczywistą potrzebę domową. Każda kategoria wprowadza inną lekcję operacyjną:

Filtr na poziomie DNS jest przydatny, gdy cała rodzina korzysta z jednej usługi sieciowej. W przypadku przepływów pracy związanych z przechowywaniem danych, prywatna synchronizacja plików pokazuje, dlaczego konfiguracje i bazy danych muszą pozostać poza warstwą kontenerów tymczasowych. Serwer multimedialny Plex dodaje uprawnienia do mediów, umieszczanie metadanych oraz możliwe wymagania dotyczące transkodowania.

Nie dodawaj kilku krytycznych usług naraz. Mały stos z udokumentowanymi ścieżkami, wąską ekspozycją i przetestowanym backupem jest bardziej użyteczny niż zatłoczony pulpit, którego nikt nie potrafi niezawodnie odbudować.

Najczęściej zadawane pytania

Czy mogę używać Dockera na NAS opartym na ARM?

Często tak. Obraz musi udostępniać wersję dla architektury NAS. Sprawdź platformę oferowaną przez obraz przed wdrożeniem, zwłaszcza w mniejszych projektach, które mogą wspierać amd64, ale nie arm64. Niezgodność architektury może uniemożliwić uruchomienie kontenera, nawet jeśli plik Compose jest poprawny.

Ile RAM potrzebuje Docker homelab?

Nie ma uniwersalnej liczby, ponieważ filtr DNS, serwer multimediów, baza danych i usługa AI mają bardzo różne profile pamięci. Wypisz usługi, które planujesz uruchomić, zacznij od małego stosu, zmierz szczytowe zużycie przez kilka dni i zostaw zapas dla systemu operacyjnego, pamięci podręcznej systemu plików, aktualizacji i tymczasowych skoków.

Czy potrzebuję Docker Compose, jeśli mój NAS ma GUI?

Nie. Dobrze zaprojektowany interfejs GUI może zarządzać prostym homelabem, zwłaszcza gdy udostępnia każdą ścieżkę, port, zmienną i ustawienie restartu. Compose staje się bardziej wartościowy, gdy chcesz mieć wersjonowaną konfigurację, łatwiejszą migrację, powtarzalne odzyskiwanie lub kilka powiązanych usług w jednym stosie.

Czy każdy kontener powinien mieć własną sieć?

Niekoniecznie. Twórz sieci wokół granic aplikacji, zamiast przypisywać jedną sieć do każdego kontenera. Aplikacja webowa i jej baza danych mogą dzielić jedną prywatną sieć, podczas gdy niezwiązany serwer multimediów korzysta z innej. Udostępniaj tylko porty potrzebne urządzeniom spoza Dockera.

Jaki jest najbezpieczniejszy sposób zdalnego dostępu do usług Dockera?

Dla dostępu osobistego osobisty VPN uruchamiany w domu może zmniejszyć potrzebę publicznego udostępniania wielu portów aplikacji. Usługi publiczne zwykle wymagają reverse proxy, HTTPS, silnej autoryzacji, terminowych aktualizacji i świadomej decyzji, co pozostaje prywatne.

Skąd wiem, czy kopia zapasowa Dockera jest kompletna?

Powinieneś być w stanie odtworzyć kontenery z pliku Compose i przywrócić stan aplikacji z zapisanych danych trwałych. Kopia zapasowa zawierająca tylko obrazy lub plik Compose bez katalogów bazy danych i konfiguracji nie wystarczy dla większości usług stanowych.

Zbuduj Homelab, który możesz odtworzyć

Nauka korzystania z Dockera w homelabie to mniej zbieranie kontenerów, a bardziej tworzenie powtarzalnych usług. Najpierw zweryfikuj Dockera, trzymaj jeden projekt Compose na aplikację, przechowuj stan poza kontenerem, udostępniaj tylko niezbędne porty i przetestuj przywracanie zanim usługa stanie się ważna.

Gdy pierwszy stos przetrwa ponowne uruchomienie, aktualizację i ćwiczenia odzyskiwania, dodaj kolejną aplikację z tą samą dyscypliną. Taka sekwencja zmienia NAS z miejsca, gdzie kontenery po prostu działają, w domowy serwer, który możesz zrozumieć, utrzymywać i odbudować.