Die Quelllösung ist ungewöhnlich aktuell. Ein Community-Mitglied verwies direkt auf Homeys offizielle Linux-Anleitungen und verwendete einen Docker-Container mit Host-Netzwerk, privilegiertem Modus, automatischem Neustart und einem persistenten ~/.homey-shs Ordner. Der ursprüngliche Verfasser antwortete, dass die Installation funktionierte.
Homeys aktuelle offizielle Supportseiten verwenden weiterhin dieselbe Containerarchitektur und bieten nun auch ein Docker-Compose-Beispiel. Unter ZimaOS lässt sich Compose in der Regel leichter dokumentieren und reproduzieren als ein einmaliger docker run Befehl.
Die aktuellen Mindestanforderungen von Homey prüfen
Der Homey Self-Hosted Server erfordert derzeit:
- Intel-/AMD- oder 64-Bit-Arm-CPU;
- mindestens 1 GB verfügbarer RAM;
- mindestens 1 GB verfügbarer Speicher;
- eine dedizierte LAN-IP-Adresse bzw. einen dedizierten LAN-Pfad, den Clients erreichen können.
ZimaOS stellt Docker bereits bereit. Führe daher nicht Homeys allgemeines „Docker installieren“-Skript auf dem Host aus.
Die verwendete Lösung basiert auf Homeys offizieller Docker-Run-Architektur
Der funktionierende Quellbefehl lautete:
-
--network host; -
--privileged; -
--restart unless-stopped; - einen persistenten Host-Ordner, der zugeordnet ist
/homey/user/; -
ghcr.io/athombv/homey-shs.
Der ursprüngliche Verfasser bestätigte, dass der Server installiert wurde und funktionierte.
Die aktuelle Homey-Dokumentation bietet ebenfalls Docker Compose
Homeys gepflegtes Compose-Beispiel verwendet dasselbe Konzept:
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/userSiehe den aktuellen Compose-Workflow für den Self-Hosted Server von Homey.
Einen bewusst gewählten persistenten Pfad unter ZimaOS verwenden
Die Upstream-Dokumentation ~/.homey-shs Der Pfad ist in einer allgemeinen Linux-Shell gültig. Unter ZimaOS ist es jedoch übersichtlicher, einen expliziten, beschreibbaren Speicherort zu wählen, etwa einen dedizierten AppData-Ordner innerhalb des Speicherbereichs, den du tatsächlich sicherst.
Ordne diesen Host-Ordner zu /homey/user und dokumentiere es, bevor du künftig Neuinstallationen durchführst.
Das Host-Netzwerk ist beabsichtigt
Homeys offizielles Compose verwendet network_mode: host, wodurch der Container direkten Zugriff auf den Netzwerk-Namensraum des Hosts erhält, anstatt eine gewöhnliche Docker-Portzuordnung zu verwenden.
Dies erleichtert die Erkennung im LAN und die Gerätekommunikation, verringert jedoch auch die Netzwerkisolierung. Prüfen Sie, welche Dienste der Container auf dem Host öffnet.
Der privilegierte Modus ist eine erhebliche Berechtigungsvergabe
Der offizielle Homey-Container läuft im privilegierten Modus. Dadurch hat der Container wesentlich umfassendere Zugriffsrechte auf den Host und Geräte als ein normaler App-Store-Dienst.
Verwenden Sie ausschließlich das offizielle Image bzw. die offizielle Quelle und halten Sie es aktuell. Fügen Sie keine fremde Software demselben privilegierten Container hinzu.
Homey-Service-Ports kennen
Homeys aktuelle Dokumentation führt standardmäßige Server-/Bridge-Ports einschließlich 4859–4862 auf. Durch das Host-Netzwerk sind diese Listener direkt auf dem ZimaOS-Host sichtbar.
Wenn eine Host-Firewall wie ZFW verwendet wird, stellen Sie sicher, dass die erforderlichen LAN-Ports bewusst freigegeben sind.
Einrichtung in der Homey-Mobile-App abschließen
Sobald der Container läuft, öffnen Sie Homey auf iOS oder Android, fügen Sie ein neues Homey hinzu und wählen Sie „Self-Hosted Server“. Falls die automatische Erkennung fehlschlägt, ermöglicht die aktuelle Homey-Konfiguration HOMEY_LOCAL_ADDRESS um die lokale IPv4-Adresse des Hosts festzulegen.
Aktualisieren durch Abrufen des Images und Neuerstellen des Containers
Homeys aktuelle Anleitung aktualisiert das Image und erstellt den Container neu, wobei der persistente Ordner auf dem Host erhalten bleibt. Die Daten bleiben erhalten, weil sie außerhalb des kurzlebigen Containers gespeichert sind.
Homeys persistenten Ordner sichern
Homey weist ausdrücklich darauf hin, die Dateien und Ordner im ausgewählten Pfad zu sichern. .homey-shs Pfad. Diese Sicherung ist wichtiger, als den Container selbst zu erhalten.
Homey-FAQ für ZimaOS
Hat der Quellbenutzer bestätigt, dass Homey funktioniert?
Ja. Sie sagten, dass die vorgeschlagene Docker-Installation gut funktioniert.
Sollten ZimaOS-Benutzer Docker mit Homeys curl-Skript installieren?
Nein. ZimaOS enthält Docker bereits; verwenden Sie nur den Container-/Compose-Teil.
Warum sollte /homey/user außerhalb des Containers persistent gespeichert werden?
Dieses Verzeichnis enthält den dauerhaften Zustand von Homey und ermöglicht die Aktualisierung oder Neuerstellung des Containers, ohne die Konfiguration zu verlieren.
