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

تثبيت Localtonet على macOS

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

في macOS يكون عميل Localtonet برنامج وحدة تحكم لأجهزة Mac بمعالجات Intel وApple Silicon. ثبّته عبر Homebrew أو من أرشيف ZIP، وشغّله باستخدام AuthToken، وثبّته بوصفه خدمة launchd إذا أردت أن يبدأ مع كل إقلاع.

قبل أن تبدأ #

التثبيت عبر Homebrew #

  1. أضف tap الخاص بـ Localtonet وثبّت #

    يضيف الـ tap مستودعًا تابعًا لجهة خارجية إلى Homebrew، لتتمكن من تثبيت الصيغ (formulae) منه وتحديثها.

    Terminal
    brew tap localtonet/tap
    brew install localtonet
  2. تحقق من التثبيت #

    Terminal
    localtonet --version

    يطبع الأمر إصدار العميل.

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

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

الجهازالأرشيف
Apple Silicon (ARM64)localtonet-osx-arm64.zip
Intel (x64)localtonet-osx-64.zip
  1. نزّل وفكّ الضغط #

    Apple Silicon
    curl -L https://localtonet.com/download/localtonet-osx-arm64.zip -o localtonet-osx-arm64.zip
    unzip localtonet-osx-arm64.zip -d ~/localtonet
    chmod 755 ~/localtonet/localtonet
    Intel
    curl -L https://localtonet.com/download/localtonet-osx-64.zip -o localtonet-osx-64.zip
    unzip localtonet-osx-64.zip -d ~/localtonet
    chmod 755 ~/localtonet/localtonet
  2. اختياري: انقله إلى PATH #

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

    Terminal
    sudo mv ~/localtonet/localtonet /usr/local/bin/localtonet

شغّل العميل #

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

    Terminal
    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 لإزالة التوكن المخزّن والخروج.

التشغيل بوصفه خدمة launchd #

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

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

    Terminal
    sudo localtonet --install-service --authtoken <YOUR_TOKEN>

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

    [CLI] Installed service 'Localtonet_<TOKEN_PREFIX>'

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

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

    Terminal
    sudo localtonet --status-service --authtoken <YOUR_TOKEN>

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

ما ينشئه التثبيت #

العنصرالموقع
تعريف مهمة launchd/Library/LaunchDaemons/Localtonet_<TOKEN_PREFIX>.plist
المخرجات القياسية للعميل/var/log/Localtonet_<TOKEN_PREFIX>.out.log
مخرجات الأخطاء للعميل/var/log/Localtonet_<TOKEN_PREFIX>.err.log

تبدأ المهمة عند إقلاع Mac، ويعيد launchd تشغيل العميل عندما ينتهي بخطأ. تشغّل المهمة الملف localtonet من المسار الذي كان عليه عند تثبيت الخدمة، مع التوكن ضمن وسائطها.

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

نفّذ كل أمر باستخدام sudo وأضف --authtoken <YOUR_TOKEN>.

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

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

الترقية #

  • Homebrew: brew upgrade localtonet
  • التثبيت اليدوي: نزّل الأرشيف الحالي واستبدل الملف localtonet.

إذا كان Localtonet يعمل بوصفه خدمة، فثبّت الخدمة مرة أخرى بعد ترقية Homebrew: أزلها ثم ثبّتها بالتوكن نفسه. ويؤدي التثبيت أيضًا إلى تشغيلها.

Terminal
brew upgrade localtonet
sudo localtonet --remove-service --authtoken <YOUR_TOKEN>
sudo localtonet --install-service --authtoken <YOUR_TOKEN>

تحتفظ المهمة بمسار الملف الذي ثُبّتت منه. وبعد ترقية يدوية تُبقي العميل في المكان نفسه، يكفي إيقاف الخدمة بـ --stop-service واستبدال الملف وتشغيل الخدمة بـ --start-service. تصف التشغيل بوصفه خدمة هذه الأوامر.

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

  1. إذا ثبّتّ الخدمة فأزلها: sudo localtonet --remove-service --authtoken <YOUR_TOKEN>
  2. لإزالة التوكن المخزّن، شغّل العميل واضغط F12.
  3. أزل العميل. مع Homebrew: brew uninstall localtonet، وbrew untap localtonet/tap لإزالة الـ tap. وبعد التثبيت اليدوي احذف الملف localtonet.

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

Install failed: 'macOS launchd service installation (system level default).' requires elevated (admin/root) privileges.

نُفّذ الأمر دون صلاحيات الجذر. كرّره باستخدام sudo.

sudo: localtonet: command not found

لا يجد sudo العميل في مسار البحث الخاص به. أعطه المسار الكامل بدلًا من ذلك. يطبعه الأمر command -v localtonet، مثل:

Bash
sudo "$(command -v localtonet)" --install-service --authtoken <YOUR_TOKEN>

بعد تثبيت يدوي دون خطوة PATH، يكون المسار ~/localtonet/localtonet.

Install failed: Plist already exists for 'Localtonet_…'

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

الخدمة مثبّتة لكن التوكن يبقى غير متصل

اقرأ سجل الأخطاء للمهمة، /var/log/Localtonet_<TOKEN_PREFIX>.err.log، وتأكد من أن الملف localtonet لا يزال موجودًا في المسار الذي كان عليه عند تثبيت الخدمة.

Wrong Token!

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

This token is used in another localtonet application!

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

الدعم