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

شغّل Localtonet في Docker

مساعدة بشأن هذه الصفحة
في هذه الصفحة 12 قسمًا
  1. قبل أن تبدأ
  2. الخطوات
  3. اسحب الصورة
  4. شغّل الحاوية بتوكنك
  5. أنشئ نفقًا وشغّله
  6. كيف تعمل الحاوية
  7. التشغيل في الخلفية وإعادة التشغيل تلقائيًا
  8. طرق تمرير التوكن
  9. Docker Compose
  10. الوصول إلى خدمتك من الحاوية
  11. اقرأ السجل
  12. التحديث
  13. أرشيفات الصور للمضيفين بلا وصول إلى السجل
  14. استكشاف الأخطاء وإصلاحها
  15. صفحات ذات صلة

تشغّل الصورة الرسمية localtonet/localtonet عميل Localtonet داخل حاوية. مرّر AuthToken الخاص بك، ثم أنشئ الأنفاق وشغّلها في لوحة التحكم كالمعتاد.

قبل أن تبدأ #

  • Docker على مضيف 64 بت. تُنشر الصورة لـlinux/amd64 وlinux/arm64، ويختار Docker ما يناسب مضيفك. وللأجهزة ذات معالج ARM بنظام 32 بت، استخدم إصدار Linux بدلًا من ذلك.
  • AuthToken من توكناتي. امنح كل حاوية توكنًا خاصًا بها: فعند اتصال عميل ثانٍ بالتوكن نفسه يُفصل الأول.

الخطوات #

  1. اسحب الصورة #

    السحب أولًا يضمن أنك تشغّل الإصدار الحالي لا صورة أقدم ما زالت على المضيف.

    Bash
    docker pull localtonet/localtonet

    الصورة على Docker Hub. وإلى جانب latest يعرض Docker Hub وسمًا لكل إصدار إذا أردت تثبيت إصدار بعينه.

  2. شغّل الحاوية بتوكنك #

    كل ما يلي اسم الصورة يُمرَّر إلى عميل Localtonet. استبدل <YOUR_TOKEN> بـ AuthToken الخاص بك.

    Bash
    docker run localtonet/localtonet --authtoken <YOUR_TOKEN>

    تطبع الحاوية حالة اتصالها وتبقى في الواجهة الأمامية. اضغط Ctrl + C لإيقافها.

  3. أنشئ نفقًا وشغّله #

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

كيف تعمل الحاوية #

تشغّل الصورة العميل في الوضع بدون واجهة (headless). وهذا يغيّر ثلاثة أمور مقارنةً بالعميل على سطح المكتب:

  • لا يطرح أي سؤال. وإذا كان التوكن مفقودًا أو بصيغة غير صحيحة، تطبع الحاوية خطأ وتخرج برمز الخروج 2.
  • يكتب أسطر سجل نصية عادية بدلًا من جدول الحالة المباشر، حتى عند تشغيله بالخيار -it.
  • لا يحفظ التوكن. لا تعلن الصورة أي وحدات تخزين، لذا مرّر التوكن في كل مرة تُنشأ فيها حاوية: في سطر الأوامر أو في متغير بيئة أو في ملف.

لا تُضبط الأنفاق في الحاوية. تنشئها وتشغّلها وتوقفها في لوحة التحكم، وتلتقطها الحاوية عبر اتصالها.

التشغيل في الخلفية وإعادة التشغيل تلقائيًا #

استخدم -d للفصل عن الطرفية وسياسة إعادة تشغيل ليبدأ Docker الحاوية مرة أخرى بعد إعادة التشغيل أو عند حدوث عطل:

Bash
docker run -d \
  --name localtonet \
  --restart unless-stopped \
  localtonet/localtonet --authtoken <YOUR_TOKEN>

أدرها بأوامر Docker المعتادة:

الأمرما يفعله
docker psيعرض الحاويات قيد التشغيل.
docker logs -f localtonetيتابع سجل العميل.
docker stop localtonetيوقف العميل. وتصبح أنفاقه غير متصلة.
docker start localtonetيشغّله مرة أخرى بالتوكن نفسه.
docker rm -f localtonetيزيل الحاوية.

طرق تمرير التوكن #

التوكن في سطر الأوامر ظاهر في docker inspect وفي قائمة العمليات على المضيف. وتقرأ الصورة التوكن أيضًا من البيئة أو من ملف:

المصدرطريقة الاستخدامملاحظات
--authtoken <YOUR_TOKEN>وسيط بعد اسم الصورة.الأبسط. وله الأولوية على LOCALTONET_AUTH_TOKEN.
LOCALTONET_AUTH_TOKENمتغير بيئة يحمل التوكن.يُستخدم عند عدم تمرير الوسيط --authtoken.
LOCALTONET_AUTH_TOKEN_FILEمتغير بيئة يحمل المسار، داخل الحاوية، لملف لا يحتوي إلا على التوكن.ملف التوكن له الأولوية دائمًا على توكن يُمرَّر مباشرة. والوسيط --authtoken-file <PATH> يؤدي الغرض نفسه.

تضبط الصورة نفسها LOCALTONET_HEADLESS=1. ولا تحتاج إلى ضبطه.

مع ملف التوكن، أبقِ التوكن خارج تعريف الحاوية وركّبه للقراءة فقط:

Bash
printf '%s' '<YOUR_TOKEN>' > auth-token
chmod 600 auth-token

docker run -d \
  --name localtonet \
  --restart unless-stopped \
  -e LOCALTONET_AUTH_TOKEN_FILE=/run/secrets/localtonet_auth_token \
  -v "$(pwd)/auth-token:/run/secrets/localtonet_auth_token:ro" \
  localtonet/localtonet

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

للتحقق من مصدر التوكن دون اتصال، أضف --check-config. يتحقق العميل من أن التوكن موجود وبصيغة سليمة (33 حرفًا، بلا مسافات)، ويطبع Localtonet headless configuration OK. ثم يخرج. ولا يسأل الخادم عمّا إذا كان التوكن صالحًا.

Bash
docker run --rm \
  -e LOCALTONET_AUTH_TOKEN_FILE=/run/secrets/localtonet_auth_token \
  -v "$(pwd)/auth-token:/run/secrets/localtonet_auth_token:ro" \
  localtonet/localtonet --check-config

Docker Compose #

الإعداد نفسه بصيغة ملف Compose. ضع التوكن في ملف باسم auth-token بجوار compose.yaml:

compose.yaml
services:
  localtonet:
    image: localtonet/localtonet
    restart: unless-stopped
    environment:
      LOCALTONET_AUTH_TOKEN_FILE: /run/secrets/localtonet_auth_token
    volumes:
      - ./auth-token:/run/secrets/localtonet_auth_token:ro
Bash
docker compose up -d
docker compose logs -f localtonet

عندما تكون الخدمة التي تريد نشرها في مشروع Compose نفسه على مضيف Linux، انشر منفذها على المضيف وشغّل حاوية Localtonet بشبكة المضيف. يجب أن يكون العنوان المحلي للنفق عنوان IP، لذا لا يمكن استخدام اسم خدمة Compose مثل web له:

compose.yaml
services:
  web:
    image: nginx
    ports:
      - "8080:80"

  localtonet:
    image: localtonet/localtonet
    restart: unless-stopped
    network_mode: host
    environment:
      LOCALTONET_AUTH_TOKEN_FILE: /run/secrets/localtonet_auth_token
    volumes:
      - ./auth-token:/run/secrets/localtonet_auth_token:ro

في هذا المثال، اضبط العنوان المحلي للنفق على 127.0.0.1 ومنفذه المحلي على 8080.

لأجهزة NAS أو Home Assistant، توجد قوالب جاهزة في صفحة NAS وHome Assistant.

الوصول إلى خدمتك من الحاوية #

يخبر عنوان IP المحلي والمنفذ المحلي للنفق العميل بمكان خدمتك. يتصل العميل من داخل الحاوية، حيث 127.0.0.1 هو الحاوية نفسها لا جهازك. أدخل عنوان IP: فالعميل لا يحلّ أسماء Docker مثل host.docker.internal ولا اسم خدمة Compose ولا اسم حاوية. استخدم القيمة المناسبة لمكان تشغيل الخدمة:

مكان تشغيل الخدمةالعنوان المحلي الذي تدخلهما يلزم أيضًا
على مضيف Docker، نظام Linux127.0.0.1شغّل الحاوية بالخيار --network host (في Compose: network_mode: host). تشارك الحاوية حينئذٍ شبكة المضيف.
على مضيف Docker، بدون شبكة المضيف (بما في ذلك Docker Desktop على Windows أو macOS)عنوان IP الخاص بالمضيف في الشبكة المحلية، مثل 192.168.1.10يجب أن تستمع الخدمة على عنوان تستطيع الحاوية الوصول إليه، لا على 127.0.0.1 فقط، ويجب أن يسمح جدار حماية المضيف بالاتصال.
في حاوية أخرى127.0.0.1 مع --network host على Linux، وإلا فعنوان IP الخاص بالمضيف في الشبكة المحليةانشر منفذ تلك الحاوية على المضيف (-p، وفي Compose: ports) واستخدم المنفذ المنشور منفذًا محليًا للنفق.
على جهاز آخر في شبكتكعنوان IP الخاص بذلك الجهاز في الشبكة المحلية، مثل 192.168.1.20لا شيء.
Linux، الخدمة على المضيف
docker run -d \
  --name localtonet \
  --restart unless-stopped \
  --network host \
  localtonet/localtonet --authtoken <YOUR_TOKEN>

يمكنك تغيير عنوان نفق موجود في إعداداته تحت العنوان المحلي. راجع مرجع الإعدادات.

اقرأ السجل #

يعرض docker logs -f localtonet سطرًا لكل تغيير. وكل سطر بعد الأول يبدأ بطابع زمني:

السطرالمعنى
Localtonet - headless logبدأ العميل.
Connection: …حالة الاتصال بـ Localtonet. يظهر سطر جديد عند تغيّرها.
AuthTokenName: …اسم التوكن الذي سجّلت به الحاوية الدخول، كما يظهر في توكناتي.
OPEN …, ADDED …نفق تابع لهذا التوكن. تُستخدم OPEN للأنفاق الموجودة عند بدء العميل، وADDED للأنفاق التي تظهر لاحقًا.
STATUS …تغيّرت حالة نفق.
CLOSED …أُزيل نفق من هذا العميل.
Authentication failed: AuthToken was rejected.لم يقبل Localtonet التوكن.

لا يُكتب التوكن نفسه في السجل أبدًا.

التحديث #

اسحب الصورة مرة أخرى وأعد إنشاء الحاوية:

Bash
docker pull localtonet/localtonet
docker rm -f localtonet
docker run -d --name localtonet --restart unless-stopped localtonet/localtonet --authtoken <YOUR_TOKEN>

مع Compose، شغّل docker compose pull ثم docker compose up -d. وللبدء دائمًا من أحدث صورة، أضف --pull always إلى docker run.

أرشيفات الصور للمضيفين بلا وصول إلى السجل #

إذا لم يستطع المضيف الوصول إلى Docker Hub، فنزّل الصورة بصيغة أرشيف TAR على جهاز آخر وانسخها إليه ثم حمّلها:

البنيةالأرشيف
AMD64localtonet-docker-amd64.tar
ARM64localtonet-docker-arm64.tar
Bash
docker load --input localtonet-docker-amd64.tar

يطبع docker load ما حمّله. وإذا طبع معرّف صورة بدلًا من اسم، فامنح الصورة اسمًا قبل تشغيلها:

Bash
docker tag <IMAGE_ID> localtonet/localtonet
docker run -d --name localtonet --restart unless-stopped localtonet/localtonet --authtoken <YOUR_TOKEN>

استكشاف الأخطاء وإصلاحها #

تخرج الحاوية فورًا مع "Invalid Localtonet headless configuration"

الرسالة كاملة هي Invalid Localtonet headless configuration. Check the token file or environment settings. لم يجد العميل توكنًا صالحًا للاستخدام: لم يُمرَّر شيء، أو أن القيمة ليست بطول 33 حرفًا، أو تحتوي على مسافة أو فاصل سطر في وسطها، أو أن مسار ملف التوكن غير موجود في الحاوية. وإذا ركّبت ملف توكن، فتحقق على المضيف من أنه ملف لا مجلد. ومع سياسة إعادة التشغيل تظل الحاوية تعيد التشغيل إلى أن تصلح التوكن، لذا اقرأ docker logs localtonet.

يعرض السجل "Authentication failed: AuthToken was rejected."

التوكن بصيغة سليمة لكن Localtonet لا يقبله. انسخه مرة أخرى من توكناتي وأعد إنشاء الحاوية.

النفق يعمل لكن العنوان العام لا يصل إلى خدمتي

تحقق من العنوان المحلي للنفق. لا يعمل 127.0.0.1 إلا مع --network host على Linux. وإلا فاستخدم عنوان IP الخاص بالمضيف في الشبكة المحلية. أما اسم مثل host.docker.internal أو اسم حاوية أخرى فلا يعمل في هذا الحقل، كما هو موضح في الوصول إلى خدمتك من الحاوية.

تفقد الحاوية اتصالها باستمرار

تأكد من أن لا عميل آخر يستخدم التوكن نفسه. فالعميل الثاني الذي يتصل بالتوكن يفصل الأول. أنشئ توكنًا واحدًا لكل حاوية أو جهاز في توكناتي.

الدعم