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

تشغيل Localtonet كخدمة

مساعدة بشأن هذه الصفحة
في هذه الصفحة 8 أقسام
  1. قبل أن تبدأ
  2. ثبّت الخدمة
  3. Windows
  4. اسم الخدمة
  5. ما الذي تشغّله الخدمة
  6. إدارة الخدمة
  7. Windows
  8. أين تُسجَّل الخدمة وأين سجلاتها
  9. تغيير التوكن
  10. أمور تجدر معرفتها
  11. استكشاف الأخطاء
  12. صفحات ذات صلة

ثبّت عميل Localtonet كخدمة في الخلفية ليبدأ مع الجهاز ويستمر في العمل بعد تسجيل الخروج ولا يحتاج إلى طرفية مفتوحة. يسجّله أمر واحد في خدمات Windows أو launchd في macOS أو systemd في Linux.

قبل أن تبدأ #

  • عميل وحدة التحكم مثبّت على الجهاز: Windows أو macOS أو Linux.
  • AuthToken لهذا الجهاز من توكناتي.
  • صلاحيات المسؤول: طرفية مفتوحة بخيار تشغيل كمسؤول في Windows، وsudo في macOS وLinux.
  • في Linux، توزيعة تستخدم systemd. Termux غير مدعوم؛ استخدم تطبيق Android هناك.

هل ثبّتّه من حزمة DEB أو RPM، أو على OpenWrt، أو في Docker؟ لكل منها طريقته الخاصة للبدء عند الإقلاع. راجع حزم DEB وRPM وOpenWrt وDocker بدلًا من هذه الصفحة.

ثبّت الخدمة #

شغّل العميل مرة واحدة بالخيار --install-service وبتوكنك. استبدل <YOUR_TOKEN> بـ AuthToken الخاص بك. ضع --authtoken دائمًا في هذا الأمر: تتصل الخدمة بالتوكن الذي ثبّتها به.

Windows #

افتح موجه الأوامر أو PowerShell كمسؤول في المجلد الذي يحتوي على localtonet، ثم نفّذ:

موجه الأوامر أو PowerShell (مسؤول)
localtonet --install-service --authtoken <YOUR_TOKEN>

ينشئ العميل خدمة Windows ببدء تلقائي ويشغّلها. تظهر الخدمة في services.msc بالوصف Localtonet Service. وإذا فشلت الخدمة، يعيد Windows تشغيلها بعد دقيقة.

macOS

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

يكتب العميل مهمة launchd في /Library/LaunchDaemons/<SERVICE_NAME>.plist ويحمّلها ويشغّلها. تبدأ المهمة عند الإقلاع، ويعيد launchd تشغيلها إذا خرجت بخطأ.

Linux

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

يكتب العميل وحدة systemd في /etc/systemd/system/<SERVICE_NAME>.service ويفعّلها ويشغّلها. تبدأ الوحدة عند الإقلاع، ويعيد systemd تشغيلها بعد خمس ثوانٍ من أي فشل.

إذا لم يجد sudo الملف localtonet، فشغّله بمساره، مثل sudo ./localtonet من المجلد الذي يحتويه.

عند النجاح يطبع العميل اسم الخدمة:

المخرجات
[CLI] Installed service 'Localtonet_AbCdEfGhI'

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

اسم الخدمة #

تُسمّى الخدمة Localtonet_ متبوعًا بأول تسعة أحرف من التوكن، مثل Localtonet_AbCdEfGhI. تكتب هذه الصفحة <SERVICE_NAME> للإشارة إليه. ولأن الاسم يأتي من التوكن، يمكنك تثبيت خدمة واحدة لكل توكن على الجهاز نفسه، ويحتاج كل أمر إدارة إلى التوكن نفسه ليجد خدمته.

ما الذي تشغّله الخدمة #

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

  • لا تنقل الملف ولا تحذفه. يحتوي تعريف الخدمة على مساره الكامل. وفي Linux، إذا كان الملف داخل /root، ينسخه المثبّت إلى /usr/local/lib/<SERVICE_NAME>/ وتشغّل الخدمة تلك النسخة.
  • تُحفظ الخيارات الأخرى. الخيارات مثل --net و--ip أو --proxy env في أمر التثبيت تُخزَّن في الخدمة وتُستخدم عند كل بدء. راجع مرجع سطر الأوامر.

إدارة الخدمة #

استخدم التوكن نفسه مع أحد هذه الخيارات. في macOS وLinux ضع sudo في البداية. وفي Windows استخدم طرفية المسؤول لكل شيء ما عدا الحالة.

الأمرما يفعلهالمخرجات عند النجاح
localtonet --status-service --authtoken <YOUR_TOKEN>يعرض حالة الخدمة.[CLI] Service '<SERVICE_NAME>' status: Running
localtonet --stop-service --authtoken <YOUR_TOKEN>يوقف الخدمة. تصبح أنفاقها غير متصلة. وتبدأ من جديد عند الإقلاع التالي.[CLI] Stopped service '<SERVICE_NAME>'.
localtonet --start-service --authtoken <YOUR_TOKEN>يشغّل خدمة متوقفة.[CLI] Started service '<SERVICE_NAME>'.
localtonet --remove-service --authtoken <YOUR_TOKEN>يوقف الخدمة ويزيل تسجيلها. يبقى الملف localtonet نفسه.[CLI] Removed service '<SERVICE_NAME>'.

الحالة هي إحدى هذه القيم:

الحالةالمعنى
Runningالخدمة تعمل.
Stoppedالخدمة مثبّتة لكنها لا تعمل.
Installingالخدمة قيد البدء.
NotFoundلا توجد خدمة مثبّتة لهذا التوكن.
Pausedفي Windows فقط: أُوقفت الخدمة مؤقتًا.
Errorفشلت الخدمة، أو تعذّرت قراءة حالتها.
Unknownأعاد مدير الخدمات حالة لا يتعرف عليها العميل.

يمكنك أيضًا استخدام أدوات نظام التشغيل مع اسم الخدمة:

Windows #

افتح services.msc وابحث عن <SERVICE_NAME>، أو استخدم sc في طرفية المسؤول:

موجه الأوامر (مسؤول)
sc query <SERVICE_NAME>
sc stop <SERVICE_NAME>
sc start <SERVICE_NAME>

macOS

Bash
sudo launchctl print system/<SERVICE_NAME>

Linux

Bash
systemctl status <SERVICE_NAME>
sudo systemctl restart <SERVICE_NAME>

أين تُسجَّل الخدمة وأين سجلاتها #

النظامالتسجيلالسجلات
Windowsخدمة Windows باسم <SERVICE_NAME>، ونوع بدئها تلقائي، وتعمل بحساب LocalSystem.ليس للخدمة نافذة وحدة تحكم، ولا يُعدّ المثبّت أي ملف سجل. تحقق من حالة الخدمة، ومن الجهاز وأنفاقه في لوحة التحكم.
macOS/Library/LaunchDaemons/<SERVICE_NAME>.plist، وهي مهمة launchd على مستوى النظام./var/log/<SERVICE_NAME>.out.log و/var/log/<SERVICE_NAME>.err.log
Linux/etc/systemd/system/<SERVICE_NAME>.service، مفعّلة لـ multi-user.target.سجل systemd journal: journalctl -u <SERVICE_NAME> -f

لا تطبع الخدمة جدول الأنفاق الذي يعرضه العميل في الطرفية. لمعرفة حالة جهازك وأنفاقه، استخدم لوحة التحكم.

تغيير التوكن #

لتغيير توكن جهاز، أزل الخدمة بالتوكن القديم وثبّتها من جديد بالتوكن الجديد:

Bash
sudo localtonet --remove-service --authtoken <OLD_TOKEN>
sudo localtonet --install-service --authtoken <NEW_TOKEN>

أمور تجدر معرفتها #

  • عميل واحد لكل توكن. ما دامت الخدمة تعمل، لا تشغّل عميل Localtonet آخر بالتوكن نفسه، لا على هذا الجهاز ولا على جهاز آخر. العميل الثاني الذي يتصل بتوكن يقطع اتصال الأول.
  • تحديث العميل. تواصل الخدمة تشغيل الملف الذي يشير إليه تعريفها. أوقف الخدمة، واستبدل ذلك الملف بالإصدار الجديد، ثم شغّل الخدمة من جديد.
  • لا تُخزَّن كلمات مرور البروكسي. يرفض أمر التثبيت رابط بروكسي يحتوي على كلمة مرور والخيار --proxy-user. ثبّت بالخيار --proxy env وعيّن متغيرات البروكسي في بيئة الخدمة.
  • طرفية الأجهزة. إذا كان الجهاز يشغّل Localtonet كخدمة، فنفّذ localtonet --terminal enable من طرفية المسؤول أو باستخدام sudo، لتستطيع الخدمة استخدام النتيجة. راجع طرفية الأجهزة.

استكشاف الأخطاء #

الرسالةالسبب والحل
[CLI] Install failed: '…' requires elevated (admin/root) privileges.نُفّذ الأمر دون صلاحيات المسؤول. افتح الطرفية كمسؤول في Windows، أو استخدم sudo في macOS وLinux. في Windows وLinux تظهر الرسالة نفسها عند التشغيل والإيقاف والإزالة.
[CLI] Install failed: متبوعة بـ Service '<SERVICE_NAME>' already exists. (Windows) أو Systemd unit already exists for … (Linux) أو Plist already exists for … (macOS)توجد خدمة مثبّتة لهذا التوكن بالفعل. استخدم --start-service لتشغيلها، أو --remove-service أولًا إن أردت تثبيتها من جديد.
Service installation cannot persist proxy passwords. Use --proxy env and supply credentials in the service's runtime environment.احتوى أمر التثبيت على --proxy-user أو على رابط بروكسي فيه كلمة مرور. استخدم --proxy env بدلًا من ذلك.
[CLI] Start failed: … في Windows مباشرة بعد التثبيتالخدمة تعمل بالفعل، لأن التثبيت يشغّلها. تحقق بـ --status-service.
الحالة NotFoundلا توجد خدمة للتوكن الذي مررته. تأكد من أنه التوكن الذي ثبّتّ به الخدمة.
الحالة Running لكن الجهاز غير متصل في لوحة التحكمتحقق من التوكن: انسخه من جديد من توكناتي، وأزل الخدمة وثبّتها من جديد. وتأكد أيضًا من أن عميلًا آخر لا يستخدم التوكن نفسه.
الدعم