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

تثبيت Localtonet على Linux

مساعدة بشأن هذه الصفحة
في هذه الصفحة 9 أقسام
  1. قبل أن تبدأ
  2. التثبيت بالسكربت
  3. شغّل سكربت التثبيت
  4. تحقق من التثبيت
  5. التثبيت اليدوي
  6. نزّل وفكّ الضغط
  7. اختياري: انقله إلى PATH
  8. شغّل العميل
  9. شغّله بتوكنك
  10. تحقق من الجلسة
  11. التشغيل كخدمة systemd
  12. ثبّت الخدمة
  13. تحقق من أنها تعمل
  14. أوامر الخدمة
  15. الوحدة وسجلاتها
  16. الترقية
  17. استبدل العميل
  18. أعد تشغيل الخدمة
  19. إلغاء التثبيت
  20. استكشاف الأخطاء وإصلاحها
  21. صفحات ذات صلة

في Linux يكون عميل Localtonet برنامجًا واحدًا لسطر الأوامر. ثبّته بسكربت التثبيت أو من أرشيف ZIP، وشغّله بـ AuthToken الخاص بك، وثبّته كخدمة systemd إذا أردت أن يبدأ بعد كل إعادة إقلاع.

قبل أن تبدأ #

طرق أخرى لتشغيل Localtonet على Linux. في Debian وUbuntu وFedora وRHEL يمكنك تثبيت حزمة DEB أو RPM تأتي بخدماتها الخاصة. وتوجد أدلة منفصلة لـ Docker وأجهزة التوجيه OpenWrt وTermux على Android.

التثبيت بالسكربت #

  1. شغّل سكربت التثبيت #

    الطرفية
    curl -fsSL https://localtonet.com/install.sh | sh

    يكتشف السكربت نوع معالجك (x64 أو ARM64 أو ARM) وما إذا كان النظام يستخدم glibc أو musl، وينزّل النسخة المطابقة ويثبّتها في /usr/local/bin/localtonet. كما ينشئ الرابط /usr/bin/localtonet كي يعمل sudo localtonet في التوزيعات التي لا يبحث فيها sudo داخل /usr/local/bin.

    يستخدم السكربت sudo عندما لا يستطيع مستخدمك الكتابة في مجلد التثبيت، ولهذا قد يطلب كلمة مرورك. وإذا كان unzip غير موجود، يحاول تثبيته بمدير الحزم في توزيعتك.

  2. تحقق من التثبيت #

    ينتهي السكربت بطباعة الإصدار المثبّت. يمكنك طباعته مرة أخرى في أي وقت:

    الطرفية
    localtonet --version

التثبيت اليدوي #

إذا فضّلت التنزيل المباشر، فخذ الأرشيف المناسب لنظامك. يحتوي كل ملف ZIP على ملف واحد هو localtonet.

المعالجglibc (Debian وUbuntu وFedora وRHEL ومعظم التوزيعات الأخرى)musl (Alpine)
x64localtonet-linux-x64.ziplocaltonet-linux-musl-x64.zip
ARM64localtonet-linux-arm64.ziplocaltonet-linux-musl-arm64.zip
ARM (32 بت)localtonet-linux-arm.ziplocaltonet-linux-musl-arm.zip

يطبع uname -m نوع معالجك: x86_64 يعني x64، وaarch64 يعني ARM64، وarmv7l يعني ARM.

  1. نزّل وفكّ الضغط #

    يستخدم المثال نسخة x64 لـ glibc. استبدل اسم الملف بالأرشيف المناسب لنظامك.

    الطرفية
    wget https://localtonet.com/download/localtonet-linux-x64.zip
    unzip localtonet-linux-x64.zip -d ~/localtonet
    chmod 755 ~/localtonet/localtonet
  2. اختياري: انقله إلى PATH #

    بدون هذه الخطوة تشغّل العميل بمساره، ~/localtonet/localtonet. وبعدها يمكنك كتابة localtonet في أي مجلد.

    الطرفية
    sudo mv ~/localtonet/localtonet /usr/local/bin/localtonet

شغّل العميل #

  1. شغّله بتوكنك #

    الطرفية
    localtonet --authtoken <YOUR_TOKEN>

    يخزّن العميل التوكن محليًا لمستخدمك. وفي المرة التالية يمكنك تشغيله بـ localtonet وحدها. وإذا شغّلته دون توكن مخزَّن فإنه يسأل Please Enter AuthToken or PIN.

  2. تحقق من الجلسة #

    تعرض الطرفية Session Status: Connected فوق جدول فيه صف لكل نفق قيد التشغيل: IP/Url وProtocol وClient IP وClient Port وPing وStatus. يظل الجدول فارغًا حتى تشغّل نفقًا في لوحة التحكم، راجع البدء السريع.

    اضغط Ctrl + C لإيقاف العميل. واضغط F12 لإزالة التوكن المخزَّن والخروج.

عندما لا يكون الخرج طرفية، مثلًا عند إعادة توجيهه إلى ملف، يكتب العميل سطرًا نصيًا واحدًا لكل تغيير بدلًا من الجدول.

يحتاج VPN إلى root. إذا كان الجهاز جزءًا من شبكة في مدير VPN وكان العميل يعمل بدون root، يعرض صف VPN في الجدول Admin rights required. شغّل العميل في هذه الحالة بـ sudo أو كخدمة.

التشغيل كخدمة systemd #

تشغّل الخدمة Localtonet بعد كل إعادة إقلاع، وتبقيه يعمل بعد تسجيل خروجك، ولا تحتاج إلى طرفية مفتوحة. تحتاج أوامر الخدمة إلى root.

  1. ثبّت الخدمة #

    الطرفية
    sudo localtonet --install-service --authtoken <YOUR_TOKEN>

    يكتب الأمر وحدة systemd لهذا التوكن ويفعّلها ويشغّلها فورًا. ويردّ باسم الوحدة:

    [CLI] Installed service 'Localtonet_<TOKEN_PREFIX>'

    <TOKEN_PREFIX> هو أول 9 أحرف من توكنك. لكل توكن وحدته الخاصة، لذا تحتاج أوامر الخدمة الأخرى إلى --authtoken نفسه كي تجدها.

  2. تحقق من أنها تعمل #

    الطرفية
    sudo localtonet --status-service --authtoken <YOUR_TOKEN>

    تردّ الخدمة العاملة بـ [CLI] Service 'Localtonet_<TOKEN_PREFIX>' status: Running. وفي لوحة التحكم يظهر التوكن متصل تحت توكناتي.

أوامر الخدمة #

شغّل كل أمر بـ sudo وأضف --authtoken <YOUR_TOKEN>.

الأمرما يفعله
--install-serviceيكتب ملف الوحدة ويفعّل الوحدة ويشغّلها.
--start-serviceيشغّل الوحدة، مثلًا بعد أن أوقفتها.
--stop-serviceيوقف الوحدة. تبقى مفعّلة وتبدأ مجددًا بعد إعادة الإقلاع.
--status-serviceيطبع الحالة، مثل Running أو Stopped أو Error عندما تفشل الوحدة.
--remove-serviceيوقف الوحدة ويعطّلها ويحذف ملف الوحدة.

تُثبَّت الخدمة بالخيارات التي تمررها مع --install-service. الخيارات مسرودة في مرجع CLI.

الوحدة وسجلاتها #

ملف الوحدة هو /etc/systemd/system/Localtonet_<TOKEN_PREFIX>.service. يعيد systemd تشغيل العميل بعد خمس ثوانٍ من أي فشل. ولأنها وحدة systemd عادية، يمكنك أيضًا إدارتها بـ systemctl وقراءة خرجها بـ journalctl:

الطرفية
systemctl list-units 'Localtonet_*'
systemctl status Localtonet_<TOKEN_PREFIX>
journalctl -u Localtonet_<TOKEN_PREFIX> -f

تشغّل الوحدة ملف localtonet من المسار الذي كان عليه عند تثبيت الخدمة. وهناك استثناء واحد: إذا كان ذلك المسار تحت /root/، ينسخ أمر التثبيت الملف إلى /usr/local/lib/Localtonet_<TOKEN_PREFIX>/ وتشغّل الخدمة النسخة.

الترقية #

  1. استبدل العميل #

    شغّل سكربت التثبيت مرة أخرى. فإعادة تشغيله آمنة وهو يستبدل العميل المثبّت بالإصدار الحالي. وبعد التثبيت اليدوي، نزّل الأرشيف الحالي واستبدل ملف localtonet.

    الطرفية
    curl -fsSL https://localtonet.com/install.sh | sh
  2. أعد تشغيل الخدمة #

    تظل الخدمة العاملة تستخدم الإصدار القديم حتى تُعاد تشغيلها.

    الطرفية
    sudo systemctl restart Localtonet_<TOKEN_PREFIX>

    إذا كانت الخدمة تشغّل نسخة تحت /usr/local/lib/، فأزل الخدمة وثبّتها من جديد بالعميل الجديد بدلًا من ذلك.

وفي توكناتي، يعرض العمود العميل الإصدار الذي أبلغ عنه الجهاز آخر مرة، وشارة يحتاج إلى تحديث عند توفر إصدار أحدث.

إلغاء التثبيت #

  1. إذا ثبّتَّ الخدمة، فأزلها: sudo localtonet --remove-service --authtoken <YOUR_TOKEN>
  2. لإزالة التوكن المخزَّن، شغّل العميل واضغط F12.
  3. احذف العميل: sudo rm /usr/local/bin/localtonet /usr/bin/localtonet بعد التثبيت بالسكربت، أو المجلد الذي فككت إليه الأرشيف.

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

Install script: Unsupported architecture

للسكربت نسخ لـ x64 (x86_64) وARM64 (aarch64) وARM 32 بت (armv7l). أنواع المعالجات الأخرى غير مدعومة في نسخ Linux.

Install script: Neither curl nor wget found

ثبّت curl أو wget بمدير الحزم لديك وشغّل السكربت مرة أخرى.

Install script: Failed to install 'unzip'

لم يستطع السكربت تثبيت unzip بنفسه. ثبّته بمدير الحزم لديك وشغّل السكربت مرة أخرى.

Installed but not found in PATH

افتح صدفة (shell) جديدة، أو شغّل العميل بمساره الكامل، /usr/local/bin/localtonet.

sudo: localtonet: command not found

بعد التثبيت اليدوي لا يكون العميل في مسار بحث sudo. استخدم المسار الكامل، مثل sudo ~/localtonet/localtonet --install-service --authtoken <YOUR_TOKEN>، أو انقل الملف إلى /usr/local/bin أولًا.

Install failed: 'Linux systemd service installation' requires elevated (admin/root) privileges.

شُغّل الأمر بدون root. كرره بـ sudo. وينطبق الأمر نفسه على --start-service و--stop-service و--remove-service.

Install failed: Systemd unit already exists for 'Localtonet_…'

توجد خدمة لهذا التوكن مثبّتة بالفعل. تحقق منها بـ --status-service. ولتثبيتها مرة أخرى، شغّل --remove-service أولًا.

تفشل أوامر الخدمة على نظام بلا systemd

يستخدم وضع الخدمة systemd. في الأنظمة التي لا تتوفر فيها، شغّل العميل بطريقة أخرى، مثلًا داخل حاوية Docker. ولعميل سطر الأوامر وضع بلا واجهة لهذا الغرض: يعمل --headless بدون مطالبات ويقرأ التوكن من ملف يُحدَّد بـ --authtoken-file. راجع مرجع CLI.

Wrong Token!

يتوقع العميل AuthToken المكوّن من 33 حرفًا من توكناتي، أو رمز PIN من 6 أرقام لم تنتهِ صلاحيته. انسخ التوكن مرة أخرى وأدخله عند الطلب.

This token is used in another localtonet application!

يعمل عميل Localtonet آخر على هذا الجهاز بالتوكن نفسه. أغلقه، أو شغّل هذا بتوكن مختلف. استخدم عميلًا واحدًا قيد التشغيل لكل توكن.

الدعم