تثبيت Localtonet على Windows
في هذه الصفحة 9 أقسام
في Windows يمكنك استخدام تطبيق Localtonet من Microsoft Store، أو نسخة محمولة من التطبيق نفسه، أو عميل سطر الأوامر. ويمكن لعميل سطر الأوامر أيضًا تثبيت نفسه كخدمة Windows تبدأ مع كل إقلاع.
قبل أن تبدأ #
- حساب Localtonet. أنشئ حسابًا مجانًا إن لم يكن لديك واحد.
- AuthToken الخاص بك. اختر نسخ في بطاقة AuthToken في لوحة التحكم، أو انسخ توكنًا من توكناتي.
- لخدمة Windows: نافذة موجه الأوامر (Command Prompt) أو PowerShell تعمل كمسؤول (Administrator).
اختر نسخة #
| النسخة | التنزيل | ملاحظات |
|---|---|---|
| تطبيق Microsoft Store | Localtonet في Microsoft Store | نافذة تطبيق بشاشة تسجيل دخول. يتطلب Windows 10 الإصدار 1809 (البناء 17763) أو أحدث. |
| تطبيق سطح المكتب، ZIP محمول | x64، x86، ARM64 | التطبيق نفسه بدون المتجر. فكّ ضغط ملف ZIP وشغّل التطبيق من المجلد الذي فككت إليه. |
| عميل سطر الأوامر | 64 بت، 32 بت، ARM64 | ملف ZIP يحتوي على ملف واحد هو localtonet.exe. هذه هي النسخة التي توفر أوامر الخدمة. |
تعرض صفحة التنزيلات تطبيق Microsoft Store وثلاث نسخ لسطر الأوامر تحت الملفات التنفيذية.
استخدام التطبيق #
-
ثبّت التطبيق وافتحه #
ثبّت Localtonet من Microsoft Store، أو فكّ ضغط ملف ZIP المحمول وشغّل التطبيق. يفتح التطبيق على شاشة Sign in to Localtonet.
-
سجّل الدخول بتوكنك #
الصق AuthToken في حقل Authtoken or PIN واختر Connect. إذا كان التوكن في الحافظة عند فتح الشاشة، يملأه التطبيق نيابةً عنك. وبدلًا من التوكن يمكنك كتابة رمز PIN المكوّن من 6 أرقام الذي تعرضه توكناتي لتوكن ما. ويكون الـ PIN صالحًا لمدة دقيقة واحدة.
إذا ردّ التطبيق بـ
Pin or authtoken is not valid.، فانسخ التوكن مرة أخرى وتأكد من وجود جميع أحرفه الـ 33. -
شغّل نفقًا #
بعد تسجيل الدخول، يسرد التطبيق الأنفاق التي تعمل على هذا الجهاز. وما دامت القائمة تعرض No active tunnels، فأنشئ نفقًا وشغّله في لوحة التحكم، راجع البدء السريع. يزيل Sign Out التوكن من التطبيق، ويغلقه Quit Localtonet.
استخدام عميل سطر الأوامر #
-
نزّل وفكّ الضغط #
نزّل ملف ZIP المناسب لمعالجك وفكّ ضغطه في مجلد يبقى في مكانه، مثل
C:\Localtonet. الخدمة التي تثبّتها لاحقًا تشغّلlocaltonet.exeمن هذا المجلد. -
شغّله بتوكنك #
افتح موجه الأوامر (Command Prompt) أو PowerShell في ذلك المجلد وشغّل:
موجه الأوامرlocaltonet --authtoken <YOUR_TOKEN>لا يشغّل PowerShell برنامجًا من المجلد الحالي إلا إذا كتبت المسار، لذا يكون الأمر هناك:
PowerShell.\localtonet --authtoken <YOUR_TOKEN>يخزّن العميل التوكن محليًا. وفي المرة التالية يمكنك تشغيله بـ
localtonetوحدها. وإذا شغّلته دون توكن مخزَّن فإنه يسألPlease Enter AuthToken or PIN. -
تحقق من الجلسة #
تعرض النافذة
Session Status: Connectedفوق جدول فيه صف لكل نفق قيد التشغيل:IP/UrlوProtocolوClient IPوClient PortوPingوStatus. يظل الجدول فارغًا حتى تشغّل نفقًا في لوحة التحكم. ويظهر اسم توكنك أسفل الجدول.اضغط Ctrl + C لإيقاف العميل. واضغط F12 لإزالة التوكن المخزَّن والخروج.
التشغيل كخدمة Windows #
تشغّل الخدمة Localtonet مع كل إقلاع، وتبقيه يعمل بعد تسجيل خروجك، ولا تحتاج إلى طرفية مفتوحة. شغّل هذه الأوامر بعميل سطر الأوامر، في موجه الأوامر (Command Prompt) أو PowerShell الذي يعمل كمسؤول (Administrator).
-
ثبّت الخدمة #
موجه الأوامر (المسؤول)localtonet --install-service --authtoken <YOUR_TOKEN>يسجّل الأمر خدمة Windows لهذا التوكن، ويضبط نوع بدئها على تلقائي ويشغّلها فورًا. ويردّ باسم الخدمة:
[CLI] Installed service 'Localtonet_<TOKEN_PREFIX>'<TOKEN_PREFIX>هو أول 9 أحرف من توكنك. لكل توكن خدمته الخاصة، لذا تحتاج أوامر الخدمة الأخرى إلى--authtokenنفسه كي تجدها. -
تحقق من أنها تعمل #
موجه الأوامر (المسؤول)localtonet --status-service --authtoken <YOUR_TOKEN>تردّ الخدمة العاملة بـ
[CLI] Service 'Localtonet_<TOKEN_PREFIX>' status: Running. وتظهر الخدمة أيضًا فيservices.mscبالاسم نفسه، ووصفهاLocaltonet Service. وفي لوحة التحكم يظهر التوكن متصل تحت توكناتي.
أوامر الخدمة #
أضف --authtoken <YOUR_TOKEN> إلى كل أمر.
| الأمر | ما يفعله | يتطلب صلاحيات المسؤول |
|---|---|---|
--install-service | ينشئ الخدمة ببدء تلقائي ويشغّلها. يعيد Windows تشغيل الخدمة بعد دقيقة واحدة من أي فشل. | نعم |
--start-service | يشغّل الخدمة المثبّتة، مثلًا بعد أن أوقفتها. | نعم |
--stop-service | يوقف الخدمة. وتبدأ مجددًا عند الإقلاع التالي. | نعم |
--status-service | يطبع الحالة: Running أو Stopped أو Installing أثناء بدء الخدمة أو Paused أو NotFound عندما لا توجد خدمة لهذا التوكن أو Error أو Unknown. | لا |
--remove-service | يوقف الخدمة ويحذفها. | نعم |
تُثبَّت الخدمة بالخيارات التي تمررها مع --install-service، لذا أضف خيارات العميل مثل --net و--ip إلى ذلك الأمر. الخيارات مسرودة في مرجع CLI.
تشغّل الخدمة localtonet.exe من المجلد الذي كان فيه عند تثبيت الخدمة، ويكون التوكن جزءًا من أمر بدئها. لا تنقل الملف ولا تحذفه ما دامت الخدمة مثبّتة.
التحديث #
- تطبيق Microsoft Store: يحدّث Microsoft Store التطبيق.
- عميل سطر الأوامر والتطبيق المحمول: نزّل ملف ZIP الحالي من صفحة التنزيلات واستبدل الملفات القديمة. لا يسمح Windows باستبدال
localtonet.exeأثناء تشغيله، لذا أغلق العميل أولًا. وإذا كان يعمل كخدمة، فشغّل--stop-service، واستبدل الملف، ثم شغّل--start-service.
يطبع localtonet --version الإصدار المثبّت. وفي توكناتي، يعرض العمود العميل الإصدار الذي أبلغ عنه الجهاز آخر مرة، وشارة يحتاج إلى تحديث عند توفر إصدار أحدث.
إلغاء التثبيت #
- إذا ثبّتَّ الخدمة، فأزلها:
localtonet --remove-service --authtoken <YOUR_TOKEN>كمسؤول. - لإزالة التوكن المخزَّن، شغّل عميل سطر الأوامر واضغط F12.
- احذف المجلد الذي يحتوي على
localtonet.exe، أو ألغِ تثبيت تطبيق المتجر من إعدادات Windows.
استكشاف الأخطاء وإصلاحها #
'localtonet' is not recognized
الطرفية ليست في المجلد الذي يحتوي على localtonet.exe، أو أنك في PowerShell. انتقل إلى المجلد أولًا. وفي PowerShell شغّل العميل بالأمر .\localtonet.
Install failed: 'Windows service installation' requires elevated (admin/root) privileges.
الطرفية لا تعمل كمسؤول. افتح موجه الأوامر أو PowerShell باستخدام تشغيل كمسؤول وكرر الأمر. وترد الأوامر --start-service و--stop-service و--remove-service برسالة من النوع نفسه.
Install failed: Service 'Localtonet_…' already exists.
توجد خدمة لهذا التوكن مثبّتة بالفعل. تحقق منها بـ --status-service. ولتثبيتها مرة أخرى، مثلًا بخيارات أخرى أو من مجلد آخر، شغّل --remove-service أولًا.
Start failed: Service could not be started
تتضمن الرسالة ردّ أداة sc الخاصة بـ Windows. يعني الخطأ 1056 أن الخدمة تعمل بالفعل. وهذا متوقع عند تشغيل --start-service مباشرةً بعد --install-service، لأن أمر التثبيت يشغّل الخدمة أصلًا. ويعني الخطأ 1060 أنه لا توجد خدمة لهذا التوكن.
الحالة NotFound، لكنني ثبّتُّ الخدمة
يُبنى اسم الخدمة من التوكن. فإذا مررت توكنًا مختلفًا عن الذي ثبّتَّ به الخدمة، يبحث العميل عن خدمة أخرى. استخدم التوكن نفسه، أو ابحث في services.msc عن خدمة تبدأ بـ Localtonet_.
Service installation cannot persist proxy passwords.
جمعتَ --install-service مع --proxy-user أو مع رابط بروكسي يحتوي على كلمة مرور. لا تُثبَّت الخدمة بكلمات مرور البروكسي. استخدم --proxy env وقدّم بيانات الاعتماد في بيئة الخدمة. راجع مرجع CLI.
Wrong Token!
يتوقع العميل AuthToken المكوّن من 33 حرفًا من توكناتي، أو رمز PIN من 6 أرقام لم تنتهِ صلاحيته. انسخ التوكن مرة أخرى وأدخله عند الطلب.
This token is used in another localtonet application!
توجد نافذة Localtonet أخرى على هذا الحاسوب تعمل بالتوكن نفسه. أغلقها، أو شغّل هذه بتوكن مختلف. استخدم عميلًا واحدًا قيد التشغيل لكل توكن.
يبقى التوكن غير متصل في لوحة التحكم
يعني «غير متصل» أن الجهاز مفصول. تحقق من أن نافذة العميل ما زالت مفتوحة أو أن حالة الخدمة Running، وأن العميل شُغّل بالتوكن الذي تنظر إليه.