انتقل إلى المحتوى
Localtonet Localtonet لوحة التحكم

تشغيل Localtonet على NAS أو Home Assistant

قوالب الإعداد AMD64 وARM64

مساعدة بشأن هذه الصفحة
في هذه الصفحة 7 أقسام
  1. ما هي القوالب
  2. ما ليسا عليه
  3. قبل أن تبدأ
  4. إعداد NAS باستخدام Docker Compose
  5. فك ضغط ملف ZIP وانسخ المجلد nas إلى جهاز NAS
  6. إنشاء ملف التوكن
  7. اترك compose.yaml كما هو
  8. تشغيل المشروع
  9. إنشاء نفق وتشغيله
  10. ما يفعله قالب Compose
  11. إعداد Home Assistant OS أو Supervised
  12. نسخ مجلد التطبيق
  13. إعادة تحميل متجر التطبيقات وتثبيت Localtonet
  14. إدخال التوكن وتشغيل التطبيق
  15. إنشاء نفق وتشغيله
  16. الوصول إلى خدماتك
  17. السجلات والتحديثات
  18. صفحات ذات صلة

يوفّر Localtonet قوالب نشر تشغّل عميل Localtonet كحاوية على جهاز NAS يدعم Docker وعلى Home Assistant. تضيف AuthToken الخاص بك وتشغّل الحاوية، ثم تدير الأنفاق من لوحة التحكم.

ما هي القوالب #

التنزيل أرشيف ZIP صغير يحتوي على قالبين، بخمسة ملفات في المجموع:

القالبيُستخدم علىالملفاتما تغيّره
NAS / Docker Compose (المجلد nas)Synology Container Manager وQNAP Container Station وأي NAS آخر يشغّل Docker، ومضيفو Home Assistant Container أو Corenas/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 Supervisedhome-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 #

  1. فك ضغط ملف ZIP وانسخ المجلد nas إلى جهاز NAS #

    فك ضغط الأرشيف على حاسوبك. انسخ المجلد nas إلى مجلد مشترك على جهاز NAS يستطيع مدير الحاويات لديك استخدامه.

  2. إنشاء ملف التوكن #

    في المجلد nas، انسخ auth-token.example إلى auth-token. افتح auth-token واستبدل DUMMY_AUTH_TOKEN بـ AuthToken الخاص بك، في سطر واحد دون أي شيء آخر في الملف.

    أبقِ ملف التوكن سرّيًا. اجعله مقصورًا على حسابك أنت في جهاز NAS ولا تضعه في مجلد مشترك أو متزامن يستطيع الآخرون قراءته. يسمح التوكن لعميل Localtonet بالاتصال بصفته هذا الجهاز.

    يجب أن يكون الملف موجودًا قبل بدء الحاوية. إذا كان مفقودًا، ينشئ Docker بدلًا منه مجلدًا باسم auth-token، ولا تستطيع الحاوية قراءة توكن منه.

  3. اترك compose.yaml كما هو #

    لا تحتاج إلى تعديل compose.yaml. يذكر السطر image: فيه صورة Localtonet والإصدار الذي أُعدّ له هذا الأرشيف، مثل docker.io/localtonet/localtonet:8.6.0. وتُشرح الأسطر الأخرى في ما يفعله قالب Compose.

  4. تشغيل المشروع #

    استورد compose.yaml كمشروع في مدير الحاويات لديك وشغّله:

    • Synology: في Container Manager، أنشئ مشروعًا من المجلد nas وملف compose.yaml فيه.
    • QNAP: في Container Station، أنشئ تطبيقًا من compose.yaml. يربط الملف ./auth-token نسبةً إلى ملف Compose، لذلك يجب أن يكون ملف التوكن في متناول هذا المسار.
    • أي مضيف Docker فيه صدفة: نفّذ الأمر أدناه من المجلد nas.
    Bash
    docker compose up -d

    تختلف الشاشات بالضبط بين طُرز NAS وإصداراتها. اتبع وثائق الجهة المصنِّعة لإنشاء مشروع من ملف Compose.

  5. إنشاء نفق وتشغيله #

    عندما تعمل الحاوية، افتح لوحة التحكم وأنشئ نفقًا بالتوكن الذي وضعته في الملف ثم اختر تشغيل، كما في البدء السريع.

ما يفعله قالب Compose #

هذا هو الملف كاملًا. الوسم في نهاية السطر image: هو إصدار Localtonet الذي أُعدّ له أرشيفك؛ و8.6.0 مثال.

nas/compose.yaml
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. القالب تطبيق محلي تنسخه إلى الجهاز.

  1. نسخ مجلد التطبيق #

    فك ضغط ملف ZIP. انسخ المجلد home-assistant/localtonet إلى مجلد التطبيقات المحلية في Home Assistant ليصبح /addons/localtonet. يحتوي المجلد على ملف واحد، config.json. لا تعدّله: فهو يسمّي التطبيق Localtonet والصورة docker.io/localtonet/localtonet والإصدار الذي أُعدّ له هذا الأرشيف، ويترك الخيار authtoken فارغًا لتملأه لاحقًا.

  2. إعادة تحميل متجر التطبيقات وتثبيت Localtonet #

    أعد تحميل متجر التطبيقات في Home Assistant ليجد التطبيق المحلي، ثم ثبّت Localtonet.

  3. إدخال التوكن وتشغيل التطبيق #

    افتح صفحة Configuration الخاصة بالتطبيق، وأدخل AuthToken في الخيار authtoken وشغّل التطبيق. يخفي Home Assistant القيمة كما يخفي كلمة المرور. ويبدأ التطبيق تلقائيًا مع Home Assistant من ذلك الحين.

  4. إنشاء نفق وتشغيله #

    أنشئ نفقًا بذلك التوكن في لوحة التحكم ثم اختر تشغيل. لنشر 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، أو بالأمر:

Bash
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
  1. استخرج ملف ZIP واقرأ README.txt.
  2. لجهاز NAS، انسخ nas/auth-token.example إلى nas/auth-token وأدخل AuthToken الخاص بك. احتفظ بهذا الملف خاصًا.
  3. تحقّق من وسم الصورة في nas/compose.yaml، ثم استورده كمشروع أو شغّل docker compose up -d من المجلد nas.
  4. لنظام Home Assistant OS / Supervised، اتبع تعليمات تثبيت التطبيق المحلي في ملف README وأدخل التوكن في إعدادات التطبيق.

تستخدم القوالب شبكة المضيف في Linux للوصول إلى الشبكة المحلية، ولا تمنح صلاحيات VPN.

الدعم