شغّل Localtonet في Docker
في هذه الصفحة 12 قسمًا
تشغّل الصورة الرسمية localtonet/localtonet عميل Localtonet داخل حاوية. مرّر AuthToken الخاص بك، ثم أنشئ الأنفاق وشغّلها في لوحة التحكم كالمعتاد.
قبل أن تبدأ #
- Docker على مضيف 64 بت. تُنشر الصورة لـ
linux/amd64وlinux/arm64، ويختار Docker ما يناسب مضيفك. وللأجهزة ذات معالج ARM بنظام 32 بت، استخدم إصدار Linux بدلًا من ذلك. - AuthToken من توكناتي. امنح كل حاوية توكنًا خاصًا بها: فعند اتصال عميل ثانٍ بالتوكن نفسه يُفصل الأول.
الخطوات #
-
اسحب الصورة #
السحب أولًا يضمن أنك تشغّل الإصدار الحالي لا صورة أقدم ما زالت على المضيف.
Bashdocker pull localtonet/localtonetالصورة على Docker Hub. وإلى جانب
latestيعرض Docker Hub وسمًا لكل إصدار إذا أردت تثبيت إصدار بعينه. -
شغّل الحاوية بتوكنك #
كل ما يلي اسم الصورة يُمرَّر إلى عميل Localtonet. استبدل
<YOUR_TOKEN>بـ AuthToken الخاص بك.Bashdocker run localtonet/localtonet --authtoken <YOUR_TOKEN>تطبع الحاوية حالة اتصالها وتبقى في الواجهة الأمامية. اضغط Ctrl + C لإيقافها.
-
أنشئ نفقًا وشغّله #
افتح لوحة التحكم، وأنشئ نفقًا بالتوكن الذي أعطيته للحاوية، ثم اختر تشغيل. يعرض البدء السريع النموذج. اقرأ الوصول إلى خدمتك من الحاوية قبل أن تملأ عنوان IP المحلي، لأن
127.0.0.1له معنى مختلف داخل الحاوية.
كيف تعمل الحاوية #
تشغّل الصورة العميل في الوضع بدون واجهة (headless). وهذا يغيّر ثلاثة أمور مقارنةً بالعميل على سطح المكتب:
- لا يطرح أي سؤال. وإذا كان التوكن مفقودًا أو بصيغة غير صحيحة، تطبع الحاوية خطأ وتخرج برمز الخروج 2.
- يكتب أسطر سجل نصية عادية بدلًا من جدول الحالة المباشر، حتى عند تشغيله بالخيار
-it. - لا يحفظ التوكن. لا تعلن الصورة أي وحدات تخزين، لذا مرّر التوكن في كل مرة تُنشأ فيها حاوية: في سطر الأوامر أو في متغير بيئة أو في ملف.
لا تُضبط الأنفاق في الحاوية. تنشئها وتشغّلها وتوقفها في لوحة التحكم، وتلتقطها الحاوية عبر اتصالها.
التشغيل في الخلفية وإعادة التشغيل تلقائيًا #
استخدم -d للفصل عن الطرفية وسياسة إعادة تشغيل ليبدأ Docker الحاوية مرة أخرى بعد إعادة التشغيل أو عند حدوث عطل:
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. ولا تحتاج إلى ضبطه.
مع ملف التوكن، أبقِ التوكن خارج تعريف الحاوية وركّبه للقراءة فقط:
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. ثم يخرج. ولا يسأل الخادم عمّا إذا كان التوكن صالحًا.
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-configDocker Compose #
الإعداد نفسه بصيغة ملف Compose. ضع التوكن في ملف باسم auth-token بجوار 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:rodocker compose up -d
docker compose logs -f localtonetعندما تكون الخدمة التي تريد نشرها في مشروع Compose نفسه على مضيف Linux، انشر منفذها على المضيف وشغّل حاوية Localtonet بشبكة المضيف. يجب أن يكون العنوان المحلي للنفق عنوان IP، لذا لا يمكن استخدام اسم خدمة Compose مثل web له:
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، نظام Linux | 127.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 | لا شيء. |
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 التوكن. |
لا يُكتب التوكن نفسه في السجل أبدًا.
التحديث #
اسحب الصورة مرة أخرى وأعد إنشاء الحاوية:
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 على جهاز آخر وانسخها إليه ثم حمّلها:
| البنية | الأرشيف |
|---|---|
| AMD64 | localtonet-docker-amd64.tar |
| ARM64 | localtonet-docker-arm64.tar |
docker load --input localtonet-docker-amd64.tarيطبع docker load ما حمّله. وإذا طبع معرّف صورة بدلًا من اسم، فامنح الصورة اسمًا قبل تشغيلها:
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 أو اسم حاوية أخرى فلا يعمل في هذا الحقل، كما هو موضح في الوصول إلى خدمتك من الحاوية.
تفقد الحاوية اتصالها باستمرار
تأكد من أن لا عميل آخر يستخدم التوكن نفسه. فالعميل الثاني الذي يتصل بالتوكن يفصل الأول. أنشئ توكنًا واحدًا لكل حاوية أو جهاز في توكناتي.