تثبيت Localtonet على macOS
في هذه الصفحة 9 أقسام
- قبل أن تبدأ
- التثبيت عبر Homebrew
- أضف tap الخاص بـ Localtonet وثبّت
- تحقق من التثبيت
- التثبيت اليدوي
- نزّل وفكّ الضغط
- اختياري: انقله إلى PATH
- شغّل العميل
- شغّله بتوكنك
- تحقق من الجلسة
- التشغيل بوصفه خدمة launchd
- ثبّت الخدمة
- تحقق من أنها تعمل
- ما ينشئه التثبيت
- أوامر الخدمة
- الترقية
- إلغاء التثبيت
- استكشاف الأخطاء وإصلاحها
- صفحات ذات صلة
في macOS يكون عميل Localtonet برنامج وحدة تحكم لأجهزة Mac بمعالجات Intel وApple Silicon. ثبّته عبر Homebrew أو من أرشيف ZIP، وشغّله باستخدام AuthToken، وثبّته بوصفه خدمة launchd إذا أردت أن يبدأ مع كل إقلاع.
قبل أن تبدأ #
- حساب في Localtonet. أنشئ حسابًا مجانًا إن لم يكن لديك.
- AuthToken الخاص بك. اختر نسخ في بطاقة AuthToken ضمن لوحة التحكم، أو انسخ توكنًا من توكناتي.
- للتثبيت عبر Homebrew: Homebrew.
- لخدمة launchd: حساب يستطيع استخدام
sudo.
التثبيت عبر Homebrew #
-
أضف tap الخاص بـ Localtonet وثبّت #
يضيف الـ tap مستودعًا تابعًا لجهة خارجية إلى Homebrew، لتتمكن من تثبيت الصيغ (formulae) منه وتحديثها.
Terminalbrew tap localtonet/tap brew install localtonet -
تحقق من التثبيت #
Terminallocaltonet --versionيطبع الأمر إصدار العميل.
التثبيت اليدوي #
إذا كنت تفضّل التنزيل المباشر، فخذ الأرشيف المناسب لجهاز Mac لديك. يحتوي ملف ZIP على ملف واحد هو localtonet.
| الجهاز | الأرشيف |
|---|---|
| Apple Silicon (ARM64) | localtonet-osx-arm64.zip |
| Intel (x64) | localtonet-osx-64.zip |
-
نزّل وفكّ الضغط #
Apple Siliconcurl -L https://localtonet.com/download/localtonet-osx-arm64.zip -o localtonet-osx-arm64.zip unzip localtonet-osx-arm64.zip -d ~/localtonet chmod 755 ~/localtonet/localtonetIntelcurl -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 -
اختياري: انقله إلى PATH #
بدون هذه الخطوة تشغّل العميل بمساره،
~/localtonet/localtonet. وبعدها يمكنك كتابةlocaltonetفي أي مجلد.Terminalsudo mv ~/localtonet/localtonet /usr/local/bin/localtonet
شغّل العميل #
-
شغّله بتوكنك #
Terminallocaltonet --authtoken <YOUR_TOKEN>يخزّن العميل التوكن محليًا. في المرة التالية يمكنك تشغيله بـ
localtonetوحده. وإذا شغّلته دون توكن مخزّن فإنه يسألPlease Enter AuthToken or PIN. -
تحقق من الجلسة #
تعرض الطرفية
Session Status: Connectedفوق جدول فيه صف لكل نفق قيد التشغيل:IP/UrlوProtocolوClient IPوClient PortوPingوStatus. يكون الجدول فارغًا إلى أن تشغّل نفقًا في لوحة التحكم، راجع البدء السريع.اضغط Ctrl + C لإيقاف العميل. واضغط F12 لإزالة التوكن المخزّن والخروج.
التشغيل بوصفه خدمة launchd #
تشغّل الخدمة Localtonet عند كل إقلاع، وتُبقيه يعمل بعد تسجيل خروجك، ولا تحتاج إلى طرفية مفتوحة. تتطلب أوامر الخدمة صلاحيات الجذر، لذا نفّذها باستخدام sudo.
-
ثبّت الخدمة #
Terminalsudo localtonet --install-service --authtoken <YOUR_TOKEN>يسجّل الأمر مهمة launchd على مستوى النظام لهذا التوكن ويشغّلها فورًا. ويرد باسم المهمة:
[CLI] Installed service 'Localtonet_<TOKEN_PREFIX>'<TOKEN_PREFIX>هو أول 9 أحرف من توكنك. يحصل كل توكن على مهمته الخاصة، لذا تحتاج أوامر الخدمة الأخرى إلى--authtokenنفسه للعثور عليها. -
تحقق من أنها تعمل #
Terminalsudo 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: أزلها ثم ثبّتها بالتوكن نفسه. ويؤدي التثبيت أيضًا إلى تشغيلها.
brew upgrade localtonet
sudo localtonet --remove-service --authtoken <YOUR_TOKEN>
sudo localtonet --install-service --authtoken <YOUR_TOKEN>تحتفظ المهمة بمسار الملف الذي ثُبّتت منه. وبعد ترقية يدوية تُبقي العميل في المكان نفسه، يكفي إيقاف الخدمة بـ --stop-service واستبدال الملف وتشغيل الخدمة بـ --start-service. تصف التشغيل بوصفه خدمة هذه الأوامر.
إلغاء التثبيت #
- إذا ثبّتّ الخدمة فأزلها:
sudo localtonet --remove-service --authtoken <YOUR_TOKEN> - لإزالة التوكن المخزّن، شغّل العميل واضغط F12.
- أزل العميل. مع 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، مثل:
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 بالتوكن نفسه. أغلقه، أو شغّل هذا بتوكن مختلف. استخدم عميلًا واحدًا قيد التشغيل لكل توكن.