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

تثبيت Localtonet على OpenWrt

تجريبي OpenWrt 24.10 و25.12+ x64 وARM64

مساعدة بشأن هذه الصفحة
في هذه الصفحة 12 قسمًا
  1. قبل أن تبدأ
  2. الإصدارات والمعماريات المدعومة
  3. ما هو غير مدعوم
  4. تحقّق من المعمارية
  5. OpenWrt 24.10 (opkg)
  6. التخزين والذاكرة
  7. ما تثبّته الحزمة
  8. ملف التوكن والإعدادات
  9. ملف التوكن
  10. إعدادات UCI
  11. الخدمة
  12. السجلات
  13. الترقية والإزالة
  14. OpenWrt 24.10 (opkg)
  15. VPN على OpenWrt
  16. استكشاف الأخطاء وإصلاحها
  17. صفحات ذات صلة

شغّل عميل Localtonet مباشرة على راوتر OpenWrt. تثبّت الحزمة العميل وملف التوكن وإعدادات UCI وخدمة تبدأ مع الراوتر.

حزم OpenWrt تجريبية. هي ملفات غير موقّعة تثبّتها يدويًا، وليست حزمًا من مستودع OpenWrt موقّع. تحقّق من توافق البرنامج الثابت وأنفاقك وVPN على جهازك قبل أن تعتمد عليها.

قبل أن تبدأ #

  • راوتر بإصدار OpenWrt ومعمارية معالج مدعومين (راجع القسم التالي).
  • صلاحية الجذر (root) على الراوتر عبر SSH.
  • اتصال بالإنترنت على الراوتر أثناء التثبيت. يُنزّل مدير الحزم الاعتماديات من مستودعات الحزم الخاصة ببرنامجك الثابت.
  • مساحة تخزين وذاكرة كافيتان (راجع التخزين والذاكرة).
  • AuthToken من توكناتي لا يستخدمه جهاز آخر.

الإصدارات والمعماريات المدعومة #

غيّر OpenWrt مدير الحزم بين الإصدارات، لذا هناك صيغتان للحزم. اختر الصيغة المناسبة لبرنامجك الثابت:

إصدار OpenWrtصيغة الحزمةمدير الحزمالمعماريات
24.10IPKopkgx64 وARM64
25.12 وما بعدهAPK v3apkx64 وARM64

APK هنا تعني حزمة OpenWrt. ملفات .apk هذه ليست تطبيقات Android ولا يمكن تثبيتها على هاتف. لنظام Android راجع Android.

ما هو غير مدعوم #

  • راوترات MIPS وMIPSEL وARMv7. لا توجد حزم لهذه المعماريات.
  • التثبيت من مستودع حزم. الحزم ملفات محلية؛ ولا يعثر عليها الراوتر أو يحدّثها عبر opkg update أو apk update.
  • فرض حزمة على معمارية مختلفة. لا تتجاوز أبدًا فحص المعمارية في مدير الحزم.

تحقّق من المعمارية #

يجب أن تطابق معمارية الحزمة برنامجك الثابت. اسأل الراوتر عن المعماريات التي يقبلها:

OpenWrt 24.10 (opkg) #

Bash
opkg print-architecture

OpenWrt 25.12+ (apk)

Bash
apk --print-arch

يبلّغ راوتر x64 عن x86_64. وتبلّغ راوترات ARM64 عن اسم يبدأ بـ aarch64_، ويختلف هذا الاسم بين إصدارات البرنامج الثابت. تأتي كل حزمة مع ملف تعليمات قصير يذكر معمارية الحزمة بالضبط، مثل x86_64 أو aarch64_generic. في صفحة التنزيلات اختر حزمتك ضمن OpenWrt وافتح تعليمات إعداد الحزمة لقراءتها. قارن تلك المعمارية بما يبلّغ عنه الراوتر. وإن لم تتطابقا فلا تثبّت الحزمة.

التخزين والذاكرة #

تحتوي الحزمة على العميل مع بيئة التشغيل الخاصة به، لذا فهي أكبر بكثير من حزمة OpenWrt المعتادة. تحقّق من الراوتر قبل التثبيت:

Bash
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. يحتوي التثبيت الجديد على:

/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

اعرض القيم الحالية في أي وقت:

Bash
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يعيد تشغيل الخدمة عند الإقلاع.

لإيقاف العميل مع إبقاء الحزمة مثبّتة:

Bash
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. اعرض أسطره أو تابعها مباشرة:

Bash
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) #

Bash
opkg remove localtonet

OpenWrt 25.12+ (apk)

Bash
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.ipk

    2. اضبط AuthToken. حرّر /etc/localtonet/auth-token بصلاحيات root واستبدل DUMMY_AUTH_TOKEN بتوكنك في سطر واحد. ثم احمِ الملف وتحقّق من الإعدادات:

    chmod 600 /etc/localtonet/auth-token
    localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config

    3. شغّل الخدمة. بعد نجاح فحص الإعدادات:

    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.ipk

    2. اضبط AuthToken. حرّر /etc/localtonet/auth-token بصلاحيات root واستبدل DUMMY_AUTH_TOKEN بتوكنك في سطر واحد. ثم احمِ الملف وتحقّق من الإعدادات:

    chmod 600 /etc/localtonet/auth-token
    localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config

    3. شغّل الخدمة. بعد نجاح فحص الإعدادات:

    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.apk

    2. اضبط AuthToken. حرّر /etc/localtonet/auth-token بصلاحيات root واستبدل DUMMY_AUTH_TOKEN بتوكنك في سطر واحد. ثم احمِ الملف وتحقّق من الإعدادات:

    chmod 600 /etc/localtonet/auth-token
    localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config

    3. شغّل الخدمة. بعد نجاح فحص الإعدادات:

    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.apk

    2. اضبط AuthToken. حرّر /etc/localtonet/auth-token بصلاحيات root واستبدل DUMMY_AUTH_TOKEN بتوكنك في سطر واحد. ثم احمِ الملف وتحقّق من الإعدادات:

    chmod 600 /etc/localtonet/auth-token
    localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config

    3. شغّل الخدمة. بعد نجاح فحص الإعدادات:

    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 على الجهاز المقصود. لا تفرض أبدًا معمارية غير مطابقة.

الدعم