تثبيت Localtonet على OpenWrt
تجريبي OpenWrt 24.10 و25.12+ x64 وARM64
في هذه الصفحة 12 قسمًا
شغّل عميل Localtonet مباشرة على راوتر OpenWrt. تثبّت الحزمة العميل وملف التوكن وإعدادات UCI وخدمة تبدأ مع الراوتر.
حزم OpenWrt تجريبية. هي ملفات غير موقّعة تثبّتها يدويًا، وليست حزمًا من مستودع OpenWrt موقّع. تحقّق من توافق البرنامج الثابت وأنفاقك وVPN على جهازك قبل أن تعتمد عليها.
قبل أن تبدأ #
- راوتر بإصدار OpenWrt ومعمارية معالج مدعومين (راجع القسم التالي).
- صلاحية الجذر (root) على الراوتر عبر SSH.
- اتصال بالإنترنت على الراوتر أثناء التثبيت. يُنزّل مدير الحزم الاعتماديات من مستودعات الحزم الخاصة ببرنامجك الثابت.
- مساحة تخزين وذاكرة كافيتان (راجع التخزين والذاكرة).
- AuthToken من توكناتي لا يستخدمه جهاز آخر.
الإصدارات والمعماريات المدعومة #
غيّر OpenWrt مدير الحزم بين الإصدارات، لذا هناك صيغتان للحزم. اختر الصيغة المناسبة لبرنامجك الثابت:
| إصدار OpenWrt | صيغة الحزمة | مدير الحزم | المعماريات |
|---|---|---|---|
| 24.10 | IPK | opkg | x64 وARM64 |
| 25.12 وما بعده | APK v3 | apk | x64 وARM64 |
APK هنا تعني حزمة OpenWrt. ملفات .apk هذه ليست تطبيقات Android ولا يمكن تثبيتها على هاتف. لنظام Android راجع Android.
ما هو غير مدعوم #
- راوترات MIPS وMIPSEL وARMv7. لا توجد حزم لهذه المعماريات.
- التثبيت من مستودع حزم. الحزم ملفات محلية؛ ولا يعثر عليها الراوتر أو يحدّثها عبر
opkg updateأوapk update. - فرض حزمة على معمارية مختلفة. لا تتجاوز أبدًا فحص المعمارية في مدير الحزم.
تحقّق من المعمارية #
يجب أن تطابق معمارية الحزمة برنامجك الثابت. اسأل الراوتر عن المعماريات التي يقبلها:
OpenWrt 24.10 (opkg) #
opkg print-architectureOpenWrt 25.12+ (apk)
apk --print-archيبلّغ راوتر x64 عن x86_64. وتبلّغ راوترات ARM64 عن اسم يبدأ بـ aarch64_، ويختلف هذا الاسم بين إصدارات البرنامج الثابت. تأتي كل حزمة مع ملف تعليمات قصير يذكر معمارية الحزمة بالضبط، مثل x86_64 أو aarch64_generic. في صفحة التنزيلات اختر حزمتك ضمن OpenWrt وافتح تعليمات إعداد الحزمة لقراءتها. قارن تلك المعمارية بما يبلّغ عنه الراوتر. وإن لم تتطابقا فلا تثبّت الحزمة.
التخزين والذاكرة #
تحتوي الحزمة على العميل مع بيئة التشغيل الخاصة به، لذا فهي أكبر بكثير من حزمة OpenWrt المعتادة. تحقّق من الراوتر قبل التثبيت:
df -h
free- الفلاش (overlay). تُثبَّت ملفات البرنامج ضمن
/usr/lib/localtonet. وقد يحتاج الراوتر ذو شريحة الفلاش الصغيرة إلى extroot (تخزين خارجي بوصفه overlay الجذر) لاستيعابها. - الذاكرة RAM و
/tmp. عند بدء العميل يفك مكتباته الأصلية في/tmp/localtonet/bundle. وفي OpenWrt يُحفظ/tmpفي الذاكرة، فتُقتطع هذه المساحة من ذاكرة الراوتر.
ما تثبّته الحزمة #
| المسار | ما هو |
|---|---|
/usr/bin/localtonet | الأمر localtonet. |
/usr/lib/localtonet | ملفات البرنامج. |
/etc/localtonet/auth-token | ملف التوكن. يحتوي على العنصر النائب DUMMY_AUTH_TOKEN إلى أن تستبدله. قابل للقراءة من root فقط. |
/etc/config/localtonet | إعدادات UCI الخاصة بالخدمة. |
/etc/init.d/localtonet | نص الخدمة (procd). |
تعتمد الحزمة على libc وlibgcc1 وlibstdcpp6 وlibopenssl3 وzlib وca-bundle وkmod-tun وip-full وbash وiptables-nft وip6tables-nft. يثبّت مدير الحزم الناقص منها من مستودعات برنامجك الثابت، ولهذا تحدّث تعليمات الإعداد قوائم الحزم أولًا. يجب أن يطابق kmod-tun نواة البرنامج الثابت المثبّت، لذا احصل عليه دائمًا من مستودعات ذلك البرنامج الثابت نفسه.
ملف التوكن والإعدادات #
لا يوصّل تثبيت الحزمة أي شيء. تبقى الخدمة متوقفة إلى أن تنجز أمرين: ضع توكنك في ملف التوكن وفعّل الخدمة في UCI. الأوامر الدقيقة لحزمتك موجودة في تعليمات الإعداد في نهاية هذه الصفحة؛ ويشرح هذا القسم ما تفعله.
ملف التوكن #
يحتوي /etc/localtonet/auth-token على AuthToken في سطر واحد ولا شيء غيره. استبدل العنصر النائب DUMMY_AUTH_TOKEN بتوكنك، مثلًا باستخدام vi. أبقِ الملف قابلًا للقراءة من root فقط (الوضع 600).
ثم تشغّل تعليمات الإعداد العميل مرة واحدة بالخيارات --headless --authtoken-file /etc/localtonet/auth-token --check-config. يفحص هذا الملف دون الاتصال بـ Localtonet:
| الناتج | المعنى |
|---|---|
Localtonet headless configuration OK. | يحتوي الملف على توكن سليم الصيغة: 33 حرفًا دون مسافات. لا يثبت الفحص أن التوكن صالح لحسابك. |
Invalid Localtonet headless configuration. Check the token file or environment settings. | الملف مفقود، أو لا يزال يحتوي على العنصر النائب، أو طول التوكن ليس 33 حرفًا. |
إعدادات UCI #
تقرأ الخدمة إعداداتها من /etc/config/localtonet. يحتوي التثبيت الجديد على:
config localtonet 'main'
option enabled '0'
option token_file '/etc/localtonet/auth-token'| الخيار | ما يفعله | القيم |
|---|---|---|
enabled | هل تشغّل الخدمة العميل. وما دام 0 فلا يفعل تشغيل الخدمة شيئًا. | 0 (الافتراضي) أو 1 |
token_file | مسار الملف الذي يقرأ العميل منه التوكن. | الافتراضي /etc/localtonet/auth-token |
اعرض القيم الحالية في أي وقت:
uci show localtonetالخدمة #
يعمل العميل بوصفه خدمة procd باسم localtonet. يسجّل تثبيت الحزمة تشغيلها عند الإقلاع، لكنها لا تشغّل العميل إلا عندما تكون enabled تساوي 1 وملف التوكن غير فارغ. بعد أن تضبط enabled على 1 وتثبّت التغيير، أعد تشغيل الخدمة مرة واحدة؛ ومن ثم تبدأ مع الراوتر.
| الأمر | ما يفعله |
|---|---|
/etc/init.d/localtonet restart | يوقف العميل ثم يشغّله. نفّذه بعد تغيير ملف التوكن أو الإعدادات. |
/etc/init.d/localtonet stop | يوقف العميل إلى حين إعادة التشغيل التالية أو إعادة إقلاع الراوتر. |
/etc/init.d/localtonet disable | يمنع تشغيل الخدمة عند الإقلاع. |
/etc/init.d/localtonet enable | يعيد تشغيل الخدمة عند الإقلاع. |
لإيقاف العميل مع إبقاء الحزمة مثبّتة:
uci set localtonet.main.enabled='0'
uci commit localtonet
/etc/init.d/localtonet restartإذا توقف العميل بشكل غير متوقع، يعيد procd تشغيله.
بعد اتصال العميل، أنشئ الأنفاق وشغّلها في لوحة التحكم بتوكن الراوتر. يمكن أن يكون عنوان IP المحلي للنفق هو 127.0.0.1 لخدمة على الراوتر نفسه، أو عنوان الشبكة المحلية لأي جهاز خلف الراوتر، مثل 192.168.1.20.
السجلات #
يكتب العميل في سجل نظام OpenWrt. اعرض أسطره أو تابعها مباشرة:
logread -e localtonet
logread -f -e localtonet| السطر | المعنى |
|---|---|
Localtonet - headless log | بدأ العميل. |
Connection: … | حالة الاتصال بـ Localtonet. |
AuthTokenName: … | اسم التوكن الذي سجّل به الراوتر الدخول. |
OPEN …, ADDED …, STATUS …, CLOSED … | عُثر على نفق لهذا التوكن أو أُضيف أو تغيرت حالته أو أُزيل. |
Authentication failed: AuthToken was rejected. | لم تقبل Localtonet التوكن الموجود في ملف التوكن. |
AuthToken file missing | الخدمة مفعّلة، لكن ملف التوكن غير موجود أو فارغ. |
الترقية والإزالة #
للترقية، ثبّت الحزمة الأحدث فوق القديمة وأعد تشغيل الخدمة. يُحتفظ بملف التوكن وإعدادات UCI. وكلا الملفين مدرجان أيضًا في قائمة الملفات التي يحتفظ بها OpenWrt عند ترقية البرنامج الثابت، لكن يجب تثبيت الحزمة نفسها من جديد بعد تفليش برنامج ثابت جديد.
لإزالة العميل:
OpenWrt 24.10 (opkg) #
opkg remove localtonetOpenWrt 25.12+ (apk)
apk del localtonetتؤدي إزالة الحزمة إلى إيقاف الخدمة وإخراجها من تسلسل الإقلاع.
VPN على OpenWrt #
تجلب الحزمة ما تحتاجه ميزة VPN على الراوتر: kmod-tun وip-full وbash وiptables-nft وip6tables-nft. يعتمد سلوك التوجيه وجدار الحماية على برنامجك الثابت وقواعد جدار الحماية الخاصة بك، لذا اختبر VPN على جهازك قبل أن تعتمد عليه. راجع مدير VPN للاطلاع على الميزة نفسها.
استكشاف الأخطاء وإصلاحها #
يرفض مدير الحزم الحزمة بسبب المعمارية
بُنيت الحزمة لمعمارية مختلفة عن برنامجك الثابت. قارن ناتج opkg print-architecture أو apk --print-arch بالمعمارية المذكورة في ملف تعليمات الحزمة (تعليمات إعداد الحزمة في صفحة التنزيلات). لا تفرض التثبيت. راوترات MIPS وMIPSEL وARMv7 غير مدعومة.
يرفض apk تثبيت الملف باعتباره غير موثوق
حزم APK ملفات محلية غير موقّعة. يتطلب تثبيت إحداها الخيار --allow-untrusted، كما تبيّن تعليمات إعداد الحزمة.
يفشل التثبيت لتعذّر العثور على اعتمادية
حدّث قوائم الحزم أولًا (opkg update أو apk update) وتأكد من أن الراوتر متصل بالإنترنت. تأتي الاعتماديات من مستودعات برنامجك الثابت نفسه.
الخدمة مفعّلة لكن لا يظهر شيء في السجل
تحقّق من uci show localtonet. إذا كانت enabled لا تزال 0، فاضبطها على 1 وثبّت التغيير وأعد تشغيل الخدمة. وإذا أظهر السجل AuthToken file missing، فضع توكنك في الملف المحدد بـ token_file.
لا يبدأ العميل أو تنفد ذاكرة الراوتر
تحقّق من مساحة الفلاش الحرة والذاكرة بالأمرين df -h وfree. يحتاج العميل إلى مساحة ضمن /usr/lib/localtonet وفي /tmp.
صفحات ذات صلة #
OpenWrt
تجريبي. اختر IPK لإصدار OpenWrt 24.10 أو APK v3 لإصدار 25.12+. ملفات APK هذه حزم OpenWrt وليست تطبيقات Android.
x64 و ARM64 فقط. يجب أن تطابق معمارية الحزمة البرنامج الثابت لديك؛ راجع تعليمات إعداد الحزمة والأمر opkg print-architecture أو apk --print-arch. لا تدعم هذه الحزم المعماريات MIPS و MIPSEL و ARMv7. تحقّق من مساحة التخزين والذاكرة RAM المتاحة قبل التثبيت.
-
OpenWrt 24.10 · x64 · IPK
تعليمات الإعداد
1. ثبّت الحزمة المنزَّلة. افتح الطرفية في المجلد الذي يحتوي على
localtonet-openwrt-24.10-x64.ipk.شغّل هذه الأوامر على الراوتر بصلاحيات root. تأكد من أن معمارية الحزمة تطابق البرنامج الثابت قبل التثبيت.
opkg print-architecture opkg update opkg install ./localtonet-openwrt-24.10-x64.ipk2. اضبط AuthToken. حرّر
/etc/localtonet/auth-tokenبصلاحيات root واستبدلDUMMY_AUTH_TOKENبتوكنك في سطر واحد. ثم احمِ الملف وتحقّق من الإعدادات:chmod 600 /etc/localtonet/auth-token localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config3. شغّل الخدمة. بعد نجاح فحص الإعدادات:
uci set localtonet.main.enabled='1' uci commit localtonet /etc/init.d/localtonet enable /etc/init.d/localtonet restart logread -e localtonetللترقية، ثبّت الحزمة الجديدة وشغّل
/etc/init.d/localtonet restart. تبقى إعداداتك محفوظة. -
OpenWrt 24.10 · ARM64 · IPK
تعليمات الإعداد
1. ثبّت الحزمة المنزَّلة. افتح الطرفية في المجلد الذي يحتوي على
localtonet-openwrt-24.10-arm64.ipk.شغّل هذه الأوامر على الراوتر بصلاحيات root. تأكد من أن معمارية الحزمة تطابق البرنامج الثابت قبل التثبيت.
opkg print-architecture opkg update opkg install ./localtonet-openwrt-24.10-arm64.ipk2. اضبط AuthToken. حرّر
/etc/localtonet/auth-tokenبصلاحيات root واستبدلDUMMY_AUTH_TOKENبتوكنك في سطر واحد. ثم احمِ الملف وتحقّق من الإعدادات:chmod 600 /etc/localtonet/auth-token localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config3. شغّل الخدمة. بعد نجاح فحص الإعدادات:
uci set localtonet.main.enabled='1' uci commit localtonet /etc/init.d/localtonet enable /etc/init.d/localtonet restart logread -e localtonetللترقية، ثبّت الحزمة الجديدة وشغّل
/etc/init.d/localtonet restart. تبقى إعداداتك محفوظة. -
OpenWrt 25.12+ · x64 · APK v3
تعليمات الإعداد
1. ثبّت الحزمة المنزَّلة. افتح الطرفية في المجلد الذي يحتوي على
localtonet-openwrt-25.12-x64.apk.شغّل هذه الأوامر على الراوتر بصلاحيات root. تأكد من أن معمارية الحزمة تطابق البرنامج الثابت قبل التثبيت.
حزمة APK المحلية هذه غير موقّعة، لذا يتطلب التثبيت
--allow-untrusted.apk --print-arch apk update apk add --allow-untrusted ./localtonet-openwrt-25.12-x64.apk2. اضبط AuthToken. حرّر
/etc/localtonet/auth-tokenبصلاحيات root واستبدلDUMMY_AUTH_TOKENبتوكنك في سطر واحد. ثم احمِ الملف وتحقّق من الإعدادات:chmod 600 /etc/localtonet/auth-token localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config3. شغّل الخدمة. بعد نجاح فحص الإعدادات:
uci set localtonet.main.enabled='1' uci commit localtonet /etc/init.d/localtonet enable /etc/init.d/localtonet restart logread -e localtonetللترقية، ثبّت الحزمة الجديدة وشغّل
/etc/init.d/localtonet restart. تبقى إعداداتك محفوظة. -
OpenWrt 25.12+ · ARM64 · APK v3
تعليمات الإعداد
1. ثبّت الحزمة المنزَّلة. افتح الطرفية في المجلد الذي يحتوي على
localtonet-openwrt-25.12-arm64.apk.شغّل هذه الأوامر على الراوتر بصلاحيات root. تأكد من أن معمارية الحزمة تطابق البرنامج الثابت قبل التثبيت.
حزمة APK المحلية هذه غير موقّعة، لذا يتطلب التثبيت
--allow-untrusted.apk --print-arch apk update apk add --allow-untrusted ./localtonet-openwrt-25.12-arm64.apk2. اضبط AuthToken. حرّر
/etc/localtonet/auth-tokenبصلاحيات root واستبدلDUMMY_AUTH_TOKENبتوكنك في سطر واحد. ثم احمِ الملف وتحقّق من الإعدادات:chmod 600 /etc/localtonet/auth-token localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config3. شغّل الخدمة. بعد نجاح فحص الإعدادات:
uci set localtonet.main.enabled='1' uci commit localtonet /etc/init.d/localtonet enable /etc/init.d/localtonet restart logread -e localtonetللترقية، ثبّت الحزمة الجديدة وشغّل
/etc/init.d/localtonet restart. تبقى إعداداتك محفوظة.
اقرأ تعليمات إعداد حزمتك قبل التثبيت. الحزم غير موقّعة، ويجب التحقق من توافق البرنامج الثابت ومن عمل الأنفاق و VPN على الجهاز المقصود. لا تفرض أبدًا معمارية غير مطابقة.