Zainstaluj samodzielny serwer Homey w systemie ZimaOS: aktualny Docker Compose, sieć hosta i kopie zapasowe

Rozwiązanie źródłowe pozostaje wyjątkowo aktualne. Jeden z członków społeczności wskazał bezpośrednio oficjalne instrukcje Homey dotyczące systemu Linux i użył kontenera Docker z siecią hosta, trybem uprzywilejowanym, automatycznym ponownym uruchamianiem oraz trwałym ~/.homey-shs katalog. Autor pierwotnego posta odpowiedział, że instalacja działała.

Na aktualnych oficjalnych stronach pomocy Homey nadal stosowana jest ta sama architektura kontenera, a teraz dostępny jest również przykład Docker Compose. W ZimaOS Compose jest zazwyczaj łatwiejszy do udokumentowania i odtworzenia niż jednorazowe docker run polecenie.

Sprawdź aktualne minimalne wymagania Homey

Homey Self-Hosted Server obecnie wymaga:

• 64-bitowy procesor Intel/AMD lub Arm;
• co najmniej 1 GB dostępnej pamięci RAM;
• co najmniej 1 GB dostępnej przestrzeni dyskowej;
• dedykowany adres IP/ścieżkę w sieci LAN, do których klienci mogą uzyskać dostęp.

ZimaOS ma już Dockera, więc nie uruchamiaj na hoście ogólnego skryptu instalacyjnego Dockera firmy Homey.

Wykorzystane rozwiązanie opierało się na oficjalnej architekturze Docker Run firmy Homey

Użyte działające polecenie źródłowe:

• --network host;
• --privileged;
• --restart unless-stopped;
• trwały folder hosta zmapowany do /homey/user/;
• ghcr.io/athombv/homey-shs.

Autor pierwotnego posta potwierdził, że serwer został zainstalowany i działał.

Aktualna dokumentacja Homey zawiera również Docker Compose

Aktualny przykład Compose firmy Homey korzysta z tego samego rozwiązania:

services:
  homey-shs:
    image: ghcr.io/athombv/homey-shs:latest
    container_name: homey-shs
    restart: unless-stopped
    network_mode: host
    privileged: true
    volumes:
      - ~/.homey-shs:/homey/user

Zobacz aktualny przepływ pracy Homey Self-Hosted Server z użyciem Compose.

Użyj przemyślanej ścieżki trwałych danych w ZimaOS

Projekt nadrzędny ~/.homey-shs ścieżka jest prawidłowa w ogólnej powłoce systemu Linux, ale w ZimaOS lepiej wybrać jawną lokalizację z możliwością zapisu, na przykład dedykowany folder AppData w obrębie przestrzeni dyskowej, której kopie zapasowe faktycznie tworzysz.

Zmapuj ten folder hosta do /homey/user i udokumentuj to przed kolejnymi reinstalacjami.

Sieć hosta jest używana celowo

Oficjalna konfiguracja Compose Homey używa network_mode: host, co zapewnia kontenerowi bezpośredni dostęp do przestrzeni nazw sieci hosta zamiast standardowego mapowania portów Dockera.

Ułatwia to wykrywanie w sieci LAN i komunikację z urządzeniami, ale jednocześnie zmniejsza izolację sieciową. Sprawdź, jakie usługi kontener otwiera na hoście.

Tryb uprzywilejowany oznacza istotne przyznanie uprawnień

Oficjalny kontener Homey działa w trybie uprzywilejowanym. Daje to kontenerowi znacznie szersze możliwości dostępu do hosta i urządzeń niż w przypadku zwykłej usługi ze sklepu aplikacji.

Używaj wyłącznie oficjalnego obrazu/źródła i aktualizuj je. Nie dodawaj niepowiązanego oprogramowania do tego samego uprzywilejowanego kontenera.

Poznaj porty usługi Homey

Aktualna dokumentacja Homey wymienia domyślne porty serwera/mostu, w tym 4859–4862. Sieć hosta oznacza, że te nasłuchujące usługi są dostępne bezpośrednio na hoście ZimaOS.

Jeśli używana jest zapora hosta, taka jak ZFW, upewnij się, że wymagane porty LAN są celowo dozwolone.

Dokończ konfigurację w aplikacji mobilnej Homey

Po uruchomieniu kontenera otwórz Homey na urządzeniu z systemem iOS lub Android, dodaj nowy system Homey i wybierz opcję Serwer samodzielnie hostowany. Jeśli automatyczne wykrywanie się nie powiedzie, aktualna konfiguracja Homey umożliwia HOMEY_LOCAL_ADDRESS do zdefiniowania adresu IPv4 hosta w sieci LAN.

Aktualizacja przez pobranie obrazu i ponowne utworzenie kontenera

Aktualne instrukcje Homey przewidują aktualizację obrazu i ponowne utworzenie kontenera przy zachowaniu trwałego folderu na hoście. Dane przetrwają, ponieważ znajdują się poza nietrwałym kontenerem.

Wykonaj kopię zapasową folderu trwałych danych Homey

Homey wyraźnie zaleca wykonanie kopii zapasowej plików i folderów przechowywanych w wybranej .homey-shs ścieżkę. Ta kopia zapasowa jest ważniejsza niż zachowanie samego kontenera.

Często zadawane pytania dotyczące Homey w ZimaOS

Czy użytkownik źródłowy potwierdził, że Homey działał?

Tak. Powiedzieli, że sugerowana instalacja Dockera działała dobrze.

Czy użytkownicy ZimaOS powinni instalować Dockera za pomocą skryptu curl Homey?

Nie. ZimaOS już zawiera Dockera; użyj tylko części dotyczącej kontenera/Compose.

Dlaczego utrwalać /homey/user poza kontenerem?

Ten katalog zawiera trwały stan Homey i umożliwia aktualizowanie lub ponowne tworzenie kontenera bez utraty konfiguracji.