تثبيت Localtonet على Linux
في هذه الصفحة 9 أقسام
- قبل أن تبدأ
- التثبيت بالسكربت
- شغّل سكربت التثبيت
- تحقق من التثبيت
- التثبيت اليدوي
- نزّل وفكّ الضغط
- اختياري: انقله إلى PATH
- شغّل العميل
- شغّله بتوكنك
- تحقق من الجلسة
- التشغيل كخدمة systemd
- ثبّت الخدمة
- تحقق من أنها تعمل
- أوامر الخدمة
- الوحدة وسجلاتها
- الترقية
- استبدل العميل
- أعد تشغيل الخدمة
- إلغاء التثبيت
- استكشاف الأخطاء وإصلاحها
- صفحات ذات صلة
في Linux يكون عميل Localtonet برنامجًا واحدًا لسطر الأوامر. ثبّته بسكربت التثبيت أو من أرشيف ZIP، وشغّله بـ AuthToken الخاص بك، وثبّته كخدمة systemd إذا أردت أن يبدأ بعد كل إعادة إقلاع.
قبل أن تبدأ #
- حساب Localtonet. أنشئ حسابًا مجانًا إن لم يكن لديك واحد.
- AuthToken الخاص بك. اختر نسخ في بطاقة AuthToken في لوحة التحكم، أو انسخ توكنًا من توكناتي.
curlأوwget، وunzip.- لخدمة systemd: صلاحيات root وتوزيعة تستخدم systemd.
طرق أخرى لتشغيل Localtonet على Linux. في Debian وUbuntu وFedora وRHEL يمكنك تثبيت حزمة DEB أو RPM تأتي بخدماتها الخاصة. وتوجد أدلة منفصلة لـ Docker وأجهزة التوجيه OpenWrt وTermux على Android.
التثبيت بالسكربت #
-
شغّل سكربت التثبيت #
الطرفية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غير موجود، يحاول تثبيته بمدير الحزم في توزيعتك. -
تحقق من التثبيت #
ينتهي السكربت بطباعة الإصدار المثبّت. يمكنك طباعته مرة أخرى في أي وقت:
الطرفيةlocaltonet --version
التثبيت اليدوي #
إذا فضّلت التنزيل المباشر، فخذ الأرشيف المناسب لنظامك. يحتوي كل ملف ZIP على ملف واحد هو localtonet.
| المعالج | glibc (Debian وUbuntu وFedora وRHEL ومعظم التوزيعات الأخرى) | musl (Alpine) |
|---|---|---|
| x64 | localtonet-linux-x64.zip | localtonet-linux-musl-x64.zip |
| ARM64 | localtonet-linux-arm64.zip | localtonet-linux-musl-arm64.zip |
| ARM (32 بت) | localtonet-linux-arm.zip | localtonet-linux-musl-arm.zip |
يطبع uname -m نوع معالجك: x86_64 يعني x64، وaarch64 يعني ARM64، وarmv7l يعني ARM.
-
نزّل وفكّ الضغط #
يستخدم المثال نسخة x64 لـ glibc. استبدل اسم الملف بالأرشيف المناسب لنظامك.
الطرفيةwget https://localtonet.com/download/localtonet-linux-x64.zip unzip localtonet-linux-x64.zip -d ~/localtonet chmod 755 ~/localtonet/localtonet -
اختياري: انقله إلى PATH #
بدون هذه الخطوة تشغّل العميل بمساره،
~/localtonet/localtonet. وبعدها يمكنك كتابةlocaltonetفي أي مجلد.الطرفيةsudo mv ~/localtonet/localtonet /usr/local/bin/localtonet
شغّل العميل #
-
شغّله بتوكنك #
الطرفية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 لإزالة التوكن المخزَّن والخروج.
عندما لا يكون الخرج طرفية، مثلًا عند إعادة توجيهه إلى ملف، يكتب العميل سطرًا نصيًا واحدًا لكل تغيير بدلًا من الجدول.
يحتاج VPN إلى root. إذا كان الجهاز جزءًا من شبكة في مدير VPN وكان العميل يعمل بدون root، يعرض صف VPN في الجدول Admin rights required. شغّل العميل في هذه الحالة بـ sudo أو كخدمة.
التشغيل كخدمة systemd #
تشغّل الخدمة Localtonet بعد كل إعادة إقلاع، وتبقيه يعمل بعد تسجيل خروجك، ولا تحتاج إلى طرفية مفتوحة. تحتاج أوامر الخدمة إلى root.
-
ثبّت الخدمة #
الطرفيةsudo localtonet --install-service --authtoken <YOUR_TOKEN>يكتب الأمر وحدة systemd لهذا التوكن ويفعّلها ويشغّلها فورًا. ويردّ باسم الوحدة:
[CLI] Installed service 'Localtonet_<TOKEN_PREFIX>'<TOKEN_PREFIX>هو أول 9 أحرف من توكنك. لكل توكن وحدته الخاصة، لذا تحتاج أوامر الخدمة الأخرى إلى--authtokenنفسه كي تجدها. -
تحقق من أنها تعمل #
الطرفية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>/ وتشغّل الخدمة النسخة.
الترقية #
-
استبدل العميل #
شغّل سكربت التثبيت مرة أخرى. فإعادة تشغيله آمنة وهو يستبدل العميل المثبّت بالإصدار الحالي. وبعد التثبيت اليدوي، نزّل الأرشيف الحالي واستبدل ملف
localtonet.الطرفيةcurl -fsSL https://localtonet.com/install.sh | sh -
أعد تشغيل الخدمة #
تظل الخدمة العاملة تستخدم الإصدار القديم حتى تُعاد تشغيلها.
الطرفيةsudo systemctl restart Localtonet_<TOKEN_PREFIX>إذا كانت الخدمة تشغّل نسخة تحت
/usr/local/lib/، فأزل الخدمة وثبّتها من جديد بالعميل الجديد بدلًا من ذلك.
وفي توكناتي، يعرض العمود العميل الإصدار الذي أبلغ عنه الجهاز آخر مرة، وشارة يحتاج إلى تحديث عند توفر إصدار أحدث.
إلغاء التثبيت #
- إذا ثبّتَّ الخدمة، فأزلها:
sudo localtonet --remove-service --authtoken <YOUR_TOKEN> - لإزالة التوكن المخزَّن، شغّل العميل واضغط F12.
- احذف العميل:
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 آخر على هذا الجهاز بالتوكن نفسه. أغلقه، أو شغّل هذا بتوكن مختلف. استخدم عميلًا واحدًا قيد التشغيل لكل توكن.