لا يزال الحل المصدر حديثًا على نحو غير معتاد. وقد أشار أحد أفراد المجتمع مباشرةً إلى تعليمات Homey الرسمية لنظام Linux، واستخدم حاوية Docker مع شبكة المضيف، ووضع الامتيازات، وإعادة التشغيل التلقائي، و ~/.homey-shs مجلد. وقد أفاد صاحب المنشور الأصلي بأن التثبيت نجح.
لا تزال صفحات الدعم الرسمية الحالية من Homey تستخدم بنية الحاوية نفسها، وتوفر الآن أيضًا مثالًا على Docker Compose. في ZimaOS، يكون Compose عادةً أسهل في التوثيق وإعادة الإنتاج من أمر docker run الأمر.
تحقق من الحد الأدنى الحالي لمتطلبات Homey
يتطلب خادم Homey المستضاف ذاتيًا حاليًا:
- وحدة معالجة مركزية Intel/AMD أو Arm بمعمارية 64 بت؛
- ذاكرة وصول عشوائي متاحة لا تقل عن 1 غيغابايت؛
- مساحة تخزين متاحة لا تقل عن 1 غيغابايت؛
- عنوان IP أو مسار مخصص ضمن الشبكة المحلية يمكن للعملاء الوصول إليه.
يوفّر ZimaOS Docker بالفعل، لذا لا تشغّل نص تثبيت Docker العام من Homey على المضيف.
استخدم الحل الأصلي بنية Docker Run الرسمية من Homey
استخدم أمر المصدر العامل ما يلي:
-
--network host; -
--privileged; -
--restart unless-stopped; - مجلد مضيف دائم مرتبط بـ
/homey/user/; -
ghcr.io/athombv/homey-shs.
أكد صاحب المنشور الأصلي أن الخادم ثُبّت وعمل.
توثّق Homey حاليًا أيضًا استخدام Docker Compose
يستخدم مثال Compose الذي تصونه Homey التصميم نفسه:
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اطّلع على سير عمل Compose الحالي لخادم Homey المستضاف ذاتيًا.
استخدم مسارًا دائمًا مقصودًا في ZimaOS
المنبع ~/.homey-shs المسار صالح في صدفة Linux عامة، ولكن في ZimaOS من الأنظف اختيار موقع تخزين قابل للكتابة بشكل صريح، مثل مجلد AppData مخصص ضمن مساحة التخزين التي تُجري لها نسخًا احتياطية فعلية.
اربط مجلد المضيف هذا بـ /homey/user وتوثيقه قبل عمليات إعادة التثبيت المستقبلية.
استخدام شبكة المضيف مقصود
يستخدم Compose الرسمي الخاص بـ Homey network_mode: host، ما يمنح الحاوية وصولًا مباشرًا إلى مساحة أسماء شبكة المضيف بدلًا من تعيين منافذ Docker المعتاد.
يساعد ذلك في اكتشاف الأجهزة على شبكة LAN والتواصل معها، لكنه يقلل أيضًا من عزل الشبكة. راجع الخدمات التي تفتحها الحاوية على المضيف.
الوضع ذو الامتيازات يمنح صلاحيات كبيرة
تعمل حاوية Homey الرسمية بامتيازات كاملة. ويمنح ذلك الحاوية إمكانات أوسع بكثير للوصول إلى المضيف/الأجهزة مقارنةً بخدمة عادية من متجر التطبيقات.
استخدم الصورة/المصدر الرسمي فقط، واحرص على تحديثه. لا تضف برامج غير مرتبطة إلى الحاوية ذات الامتيازات نفسها.
تعرّف على منافذ خدمة Homey
تسرد وثائق Homey الحالية منافذ الخادم/الجسر الافتراضية، بما في ذلك 4859-4862. تعني شبكة المضيف أن هذه المنافذ المستمعة تظهر مباشرةً على مضيف ZimaOS.
إذا كان جدار حماية على المضيف، مثل ZFW، مستخدمًا، فتأكد من السماح بالمنافذ المطلوبة لشبكة LAN بشكل مقصود.
إكمال الإعداد في تطبيق Homey للهواتف المحمولة
بعد تشغيل الحاوية، افتح Homey على iOS أو Android، وأضف Homey جديدًا، ثم اختر الخادم المستضاف ذاتيًا. إذا فشل الاكتشاف التلقائي، يتيح إعداد Homey الحالي HOMEY_LOCAL_ADDRESS لتحديد عنوان IPv4 لشبكة LAN على المضيف.
التحديث عبر سحب الحاوية وإعادة إنشائها
تحدّث تعليمات Homey الحالية الصورة وتعيد إنشاء الحاوية مع الإبقاء على مجلد المضيف الدائم. وتبقى البيانات لأنها موجودة خارج الحاوية المؤقتة.
إجراء نسخ احتياطي لمجلد Homey الدائم
يذكر Homey صراحةً ضرورة إجراء نسخ احتياطي للملفات والمجلدات المخزنة في .homey-shs المسار. وتلك النسخة الاحتياطية أهم من الحفاظ على الحاوية نفسها.
الأسئلة الشائعة حول Homey على ZimaOS
هل أكد المستخدم المصدر أن Homey عمل؟
نعم. قالوا إن تثبيت Docker المقترح كان يعمل جيدًا.
هل ينبغي لمستخدمي ZimaOS تثبيت Docker باستخدام سكربت curl الخاص بـ Homey؟
لا. يتضمن ZimaOS Docker بالفعل؛ استخدم جزء الحاوية/Compose فقط.
لماذا يجب حفظ /homey/user خارج الحاوية؟
يحتوي ذلك الدليل على الحالة الدائمة لـ Homey، ويسمح بتحديث الحاوية أو إعادة إنشائها دون فقدان الإعدادات.
