تشغيل Localtonet على NAS أو Home Assistant
قوالب الإعداد AMD64 وARM64
في هذه الصفحة 7 أقسام
- ما هي القوالب
- ما ليسا عليه
- قبل أن تبدأ
- إعداد NAS باستخدام Docker Compose
- فك ضغط ملف ZIP وانسخ المجلد nas إلى جهاز NAS
- إنشاء ملف التوكن
- اترك compose.yaml كما هو
- تشغيل المشروع
- إنشاء نفق وتشغيله
- ما يفعله قالب Compose
- إعداد Home Assistant OS أو Supervised
- نسخ مجلد التطبيق
- إعادة تحميل متجر التطبيقات وتثبيت Localtonet
- إدخال التوكن وتشغيل التطبيق
- إنشاء نفق وتشغيله
- الوصول إلى خدماتك
- السجلات والتحديثات
- صفحات ذات صلة
يوفّر Localtonet قوالب نشر تشغّل عميل Localtonet كحاوية على جهاز NAS يدعم Docker وعلى Home Assistant. تضيف AuthToken الخاص بك وتشغّل الحاوية، ثم تدير الأنفاق من لوحة التحكم.
ما هي القوالب #
التنزيل أرشيف ZIP صغير يحتوي على قالبين، بخمسة ملفات في المجموع:
| القالب | يُستخدم على | الملفات | ما تغيّره |
|---|---|---|---|
NAS / Docker Compose (المجلد nas) | Synology Container Manager وQNAP Container Station وأي NAS آخر يشغّل Docker، ومضيفو Home Assistant Container أو Core | nas/compose.yaml وnas/auth-token.example | التوكن فقط: انسخ auth-token.example إلى auth-token واستبدل DUMMY_AUTH_TOKEN بـ AuthToken الخاص بك. اترك compose.yaml كما هو. |
تطبيق Home Assistant (المجلد home-assistant) | Home Assistant OS وHome Assistant Supervised | home-assistant/localtonet/config.json، وهو تعريف التطبيق المحلي (كان يُسمّى سابقًا إضافة)، وhome-assistant/repository.json | لا شيء في الملفات. تدخل التوكن في Home Assistant بعد تثبيت التطبيق. لا يستخدم التثبيت المحلي الملف repository.json. |
الملف الخامس، README.txt، نسخة نصية قصيرة من الخطوات الواردة في هذه الصفحة.
يشغّل القالبان عميل Localtonet في حاوية، دون مطالبات، كما تصفه صفحة Docker. وهما معدّان لـ AMD64 (معالجات Intel وAMD) وARM64. تحقق من معالج جهاز NAS لديك قبل أن تبدأ؛ فجهاز NAS ذو معالج ARM بـ 32 بت لا يستطيع تشغيله.
ما ليسا عليه #
- ليسا حزمتي Synology SPK أو QNAP QPKG. لن يظهر شيء في Synology Package Center ولا في QNAP App Center.
- قالب Home Assistant ليس إدراجًا في المتجر الرسمي لـ Home Assistant. تثبّته كتطبيق محلي.
- ولا يحتويان على صورة الحاوية. يسحب جهازك الصورة التي يسمّيها القالبان،
docker.io/localtonet/localtonet، وهي صورة صفحة Docker على Docker Hub. - ولا يمنحان الحاوية الصلاحيات التي تحتاجها واجهة VPN. القالبان مخصصان للأنفاق؛ وميزة VPN ليست جزءًا منهما.
قبل أن تبدأ #
- جهاز NAS يدعم Docker وDocker Compose، أو Home Assistant OS / Supervised.
- AuthToken من توكناتي. استخدم توكنًا لا يستخدمه جهاز آخر: عندما يتصل عميل ثانٍ بالتوكن نفسه، ينقطع اتصال الأول.
- أرشيف ZIP الخاص بالقوالب. التنزيل في القائمة في نهاية هذه الصفحة وفي صفحة التنزيلات.
إعداد NAS باستخدام Docker Compose #
-
فك ضغط ملف ZIP وانسخ المجلد nas إلى جهاز NAS #
فك ضغط الأرشيف على حاسوبك. انسخ المجلد
nasإلى مجلد مشترك على جهاز NAS يستطيع مدير الحاويات لديك استخدامه. -
إنشاء ملف التوكن #
في المجلد
nas، انسخauth-token.exampleإلىauth-token. افتحauth-tokenواستبدلDUMMY_AUTH_TOKENبـ AuthToken الخاص بك، في سطر واحد دون أي شيء آخر في الملف.أبقِ ملف التوكن سرّيًا. اجعله مقصورًا على حسابك أنت في جهاز NAS ولا تضعه في مجلد مشترك أو متزامن يستطيع الآخرون قراءته. يسمح التوكن لعميل Localtonet بالاتصال بصفته هذا الجهاز.
يجب أن يكون الملف موجودًا قبل بدء الحاوية. إذا كان مفقودًا، ينشئ Docker بدلًا منه مجلدًا باسم
auth-token، ولا تستطيع الحاوية قراءة توكن منه. -
اترك compose.yaml كما هو #
لا تحتاج إلى تعديل
compose.yaml. يذكر السطرimage:فيه صورة Localtonet والإصدار الذي أُعدّ له هذا الأرشيف، مثلdocker.io/localtonet/localtonet:8.6.0. وتُشرح الأسطر الأخرى في ما يفعله قالب Compose. -
تشغيل المشروع #
استورد
compose.yamlكمشروع في مدير الحاويات لديك وشغّله:- Synology: في Container Manager، أنشئ مشروعًا من المجلد
nasوملفcompose.yamlفيه. - QNAP: في Container Station، أنشئ تطبيقًا من
compose.yaml. يربط الملف./auth-tokenنسبةً إلى ملف Compose، لذلك يجب أن يكون ملف التوكن في متناول هذا المسار. - أي مضيف Docker فيه صدفة: نفّذ الأمر أدناه من المجلد
nas.
Bashdocker compose up -dتختلف الشاشات بالضبط بين طُرز NAS وإصداراتها. اتبع وثائق الجهة المصنِّعة لإنشاء مشروع من ملف Compose.
- Synology: في Container Manager، أنشئ مشروعًا من المجلد
-
إنشاء نفق وتشغيله #
عندما تعمل الحاوية، افتح لوحة التحكم وأنشئ نفقًا بالتوكن الذي وضعته في الملف ثم اختر تشغيل، كما في البدء السريع.
ما يفعله قالب Compose #
هذا هو الملف كاملًا. الوسم في نهاية السطر image: هو إصدار Localtonet الذي أُعدّ له أرشيفك؛ و8.6.0 مثال.
services:
localtonet:
image: "docker.io/localtonet/localtonet:8.6.0"
restart: unless-stopped
network_mode: host
environment:
LOCALTONET_HEADLESS: "1"
LOCALTONET_AUTH_TOKEN_FILE: /run/secrets/localtonet_auth_token
volumes:
- ./auth-token:/run/secrets/localtonet_auth_token:ro| الإعداد | ما يفعله |
|---|---|
image | صورة Localtonet، docker.io/localtonet/localtonet، والإصدار الذي يُشغَّل. غيّر الوسم فقط عند الانتقال إلى إصدار آخر، راجع السجلات والتحديثات. |
restart: unless-stopped | يعيد Docker تشغيل الحاوية بعد إعادة التشغيل أو الانهيار، ما لم توقفها بنفسك. |
network_mode: host | تشارك الحاوية شبكة جهاز NAS. عندئذٍ يستطيع النفق الوصول إلى الخدمات على جهاز NAS نفسه عبر 127.0.0.1 وإلى الأجهزة الأخرى في شبكتك المحلية عبر عناوينها المحلية. يتطلب هذا شبكة المضيف في Linux. |
LOCALTONET_HEADLESS | يشغّل العميل دون مطالبات وبأسطر سجل نصية بسيطة. |
LOCALTONET_AUTH_TOKEN_FILE | مسار الملف، داخل الحاوية، الذي يقرأ العميل التوكن منه. |
volumes | يربط ملف auth-token لديك بقراءة فقط عند ذلك المسار. |
إعداد Home Assistant OS أو Supervised #
يشغّل Home Assistant OS وSupervised التطبيقات عبر Supervisor. القالب تطبيق محلي تنسخه إلى الجهاز.
-
نسخ مجلد التطبيق #
فك ضغط ملف ZIP. انسخ المجلد
home-assistant/localtonetإلى مجلد التطبيقات المحلية في Home Assistant ليصبح/addons/localtonet. يحتوي المجلد على ملف واحد،config.json. لا تعدّله: فهو يسمّي التطبيق Localtonet والصورةdocker.io/localtonet/localtonetوالإصدار الذي أُعدّ له هذا الأرشيف، ويترك الخيارauthtokenفارغًا لتملأه لاحقًا. -
إعادة تحميل متجر التطبيقات وتثبيت Localtonet #
أعد تحميل متجر التطبيقات في Home Assistant ليجد التطبيق المحلي، ثم ثبّت Localtonet.
-
إدخال التوكن وتشغيل التطبيق #
افتح صفحة Configuration الخاصة بالتطبيق، وأدخل AuthToken في الخيار
authtokenوشغّل التطبيق. يخفي Home Assistant القيمة كما يخفي كلمة المرور. ويبدأ التطبيق تلقائيًا مع Home Assistant من ذلك الحين. -
إنشاء نفق وتشغيله #
أنشئ نفقًا بذلك التوكن في لوحة التحكم ثم اختر تشغيل. لنشر Home Assistant نفسه، أنشئ نفق HTTP إلى
127.0.0.1والمنفذ الذي يستمع عليه Home Assistant. المنفذ الافتراضي لـ Home Assistant هو8123. لدى Home Assistant إعداداته الخاصة للطلبات التي تصل عبر بروكسي؛ وإذا رفضها فراجع وثائق HTTP في Home Assistant.
يستخدم التطبيق شبكة المضيف، فيصل مباشرة إلى Home Assistant والأجهزة الأخرى في شبكتك. ويدعم معماريتي Home Assistant هما amd64 وaarch64.
لا يوجد Supervisor في Home Assistant Container وCore، ولذلك لا يمكنهما تثبيت التطبيقات. في هذين النوعين من التثبيت، استخدم قالب NAS / Docker Compose على مضيف Docker بدلًا من ذلك.
يقع الملف home-assistant/repository.json خارج المجلد الذي تنسخه وليس جزءًا من التثبيت المحلي. وهو يحتوي على قيم نائبة (DUMMY) لعنوان المستودع والمشرف عليه؛ فتجاهله.
الوصول إلى خدماتك #
يستخدم القالبان شبكة المضيف. في حقل عنوان IP المحلي للنفق:
127.0.0.1هو جهاز NAS أو مضيف Home Assistant نفسه. استخدمه لواجهة الويب الخاصة بجهاز NAS أو Home Assistant أو أي خدمة أخرى على ذلك الجهاز، مع المنفذ الذي تستمع عليه تلك الخدمة.- عنوان شبكة محلية مثل
192.168.1.20يصل إلى جهاز آخر في شبكتك.
النفق الذي يعمل يمكن الوصول إليه من الإنترنت. قبل أن تنشر صفحة تسجيل الدخول إلى NAS أو Home Assistant، استخدم كلمات مرور قوية وتسجيل دخول بخطوتين في الخدمة نفسها، وانظر في الخيارات المتاحة في صفحة التحكم في الوصول.
السجلات والتحديثات #
تكتب الحاوية أسطر سجل نصية بسيطة: حالة اتصالها، واسم التوكن الذي سجّلت الدخول به، وسطرًا كلما أُضيف نفق أو تغيّرت حالته أو أُزيل. اقرأها في عرض السجل في مدير الحاويات لديك، أو في تبويب Log الخاص بالتطبيق في Home Assistant، أو بالأمر:
docker compose logs -f localtonetيعني السطر Invalid Localtonet headless configuration. Check the token file or environment settings. أن العميل لم يجد توكنًا صالحًا للاستخدام: ملف التوكن مفقود أو فارغ، أو ما زال يحتوي على DUMMY_AUTH_TOKEN، أو أن طول التوكن ليس 33 حرفًا. ويعني Authentication failed: AuthToken was rejected. أن التوكن سليم الشكل لكن Localtonet لا يقبله.
كل أرشيف قوالب مُعدّ لإصدار واحد من Localtonet: يثبّته ملف Compose في الوسم عند السطر image:، وتطبيق Home Assistant في الحقل version من config.json. للانتقال بجهاز NAS إلى إصدار أحدث، غيّر الوسم إلى إصدار تعرضه Docker Hub للصورة (راجع Docker) ونفّذ docker compose up -d من جديد (أو حدّث المشروع في مدير الحاويات). يبقى ملف auth-token كما هو.
صفحات ذات صلة #
NAS و Home Assistant
قوالب Docker Compose لـ Synology Container Manager و QNAP Container Station وأجهزة NAS الأخرى الداعمة لـ Docker، إضافة إلى قالب تطبيق Home Assistant لإصدار OS / Supervised. لمعماريتي AMD64 و ARM64.
هذه قوالب إعداد، وليست أدوات تثبيت SPK / QPKG ولا إدراجًا رسميًا في متجر Home Assistant. يجب توفّر صورة Docker مطابقة في السجل (registry). يمكن لمستخدمي Home Assistant Container / Core استخدام قالب Compose.
إعداد NAS أو Home Assistant
- استخرج ملف ZIP واقرأ
README.txt. - لجهاز NAS، انسخ
nas/auth-token.exampleإلىnas/auth-tokenوأدخل AuthToken الخاص بك. احتفظ بهذا الملف خاصًا. - تحقّق من وسم الصورة في
nas/compose.yaml، ثم استورده كمشروع أو شغّلdocker compose up -dمن المجلدnas. - لنظام Home Assistant OS / Supervised، اتبع تعليمات تثبيت التطبيق المحلي في ملف README وأدخل التوكن في إعدادات التطبيق.
تستخدم القوالب شبكة المضيف في Linux للوصول إلى الشبكة المحلية، ولا تمنح صلاحيات VPN.