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

ثبّت Localtonet من حزمة DEB أو RPM

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

تثبّت حزم DEB وRPM عميل Localtonet مع خدمتي systemd، إحداهما للأنفاق والأخرى للأنفاق مع VPN. تقرأ الخدمتان AuthToken الخاص بك من ملف وتعملان بدون طرفية، فيبدأ العميل مع كل إقلاع.

قبل أن تبدأ #

  • نظام Linux بمعمارية 64 بت: الحزم متوفرة لمعماريتي x64 وARM64.
  • systemd 247 أو أحدث وOpenSSL 3، مثل Debian 12 أو Ubuntu 22.04+ أو RHEL 9.
  • صلاحيات root (sudo).
  • AuthToken الخاص بك. حدد نسخ على بطاقة AuthToken في لوحة التحكم، أو انسخ توكنًا من توكناتي.

في التوزيعات الأخرى، أو على ARM بمعمارية 32 بت، أو إن لم ترغب في حزمة نظام، استخدم سكربت التثبيت أو الأرشيفات الموصوفة في Linux.

ما الذي تثبّته الحزمة #

المسارما هو
/usr/bin/localtonetالأمر localtonet.
/usr/lib/localtonet/العميل نفسه.
/usr/lib/systemd/system/localtonet.serviceخدمة الأنفاق.
/usr/lib/systemd/system/localtonet-vpn.serviceخدمة VPN والأنفاق.
/etc/localtonet/auth-tokenملف التوكن. يستطيع root فقط قراءته. يُثبَّت مع القيمة البديلة DUMMY_AUTH_TOKEN.

اسم الحزمة localtonet. وتبعياتها، ومنها OpenSSL 3 وiproute2 (iproute في RPM) وiptables وkmod، يثبّتها مدير الحزم لديك. تثبيت الحزمة لا يفعّل أي خدمة ولا يشغّلها: تعيّن التوكن أولًا ثم تفعّل الخدمة التي تحتاجها.

الخطوات #

  1. نزّل الحزمة وثبّتها #

    اختر الحزمة المناسبة لتوزيعتك ومعالجك من القائمة في نهاية هذه الصفحة، ثم ثبّت الملف الذي نزّلته بـ apt (DEB) أو dnf (RPM). يعرض تعليمات الإعداد تحت كل حزمة الأوامر الدقيقة لذلك الملف.

  2. عيّن AuthToken الخاص بك #

    حرّر /etc/localtonet/auth-token بصلاحيات root بمحرر نصوص واستبدل DUMMY_AUTH_TOKEN بتوكنك في سطر واحد. ثم تأكد من أن root وحده يستطيع قراءة الملف:

    الطرفية
    sudo chmod 600 /etc/localtonet/auth-token
  3. افحص الإعداد #

    الطرفية
    sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config

    يقرأ الفحص ملف التوكن دون اتصال. ويجيب Localtonet headless configuration OK. عندما يحتوي الملف على توكن من 33 حرفًا بلا مسافات. ولا يسأل خوادم Localtonet عما إذا كان التوكن صالحًا لحسابك.

  4. فعّل خدمة #

    للأنفاق، فعّل خدمة الأنفاق واقرأ سجلها:

    الطرفية
    sudo systemctl enable --now localtonet.service
    sudo journalctl -u localtonet.service

    إذا كان هذا الجهاز ينضم أيضًا إلى شبكة VPN، ففعّل خدمة VPN بدلًا منها. راجع خدمة الأنفاق أم خدمة VPN.

  5. شغّل نفقًا #

    يظهر التوكن الآن متصل في توكناتي. أنشئ نفقًا له وشغّله في لوحة التحكم، راجع البدء السريع.

خدمة الأنفاق أم خدمة VPN #

تشغّل الخدمتان العميل نفسه وتخدمان أنفاقك كلتاهما. والفرق في الصلاحيات التي تعملان بها. فعّل إحداهما فقط: الخدمتان تتعارضان، وتشغيل إحداهما يوقف الأخرى.

localtonet.servicelocaltonet-vpn.service
تُستخدم من أجلالأنفاقVPN والأنفاق
تعمل بحسابمستخدم غير مميز ينشئه systemd للخدمةroot، مقيّد بقدرات الشبكة CAP_NET_ADMIN وCAP_NET_RAW
وحدة TUNغير مستخدمةتُحمَّل بـ modprobe tun قبل بدء العميل
مجلد العمل/var/lib/localtonet/var/lib/localtonet-vpn

للتحويل بجهاز من خدمة الأنفاق إلى خدمة VPN:

الطرفية
sudo modprobe tun
sudo systemctl disable --now localtonet.service
sudo systemctl enable --now localtonet-vpn.service
sudo journalctl -u localtonet-vpn.service

للعودة، عطّل localtonet-vpn.service وفعّل localtonet.service بالطريقة نفسها. أما شبكات VPN نفسها فتُعدّ في لوحة التحكم، راجع مدير VPN.

كيف تعمل الخدمتان #

السلوكالتفاصيل
وضع Headlessتشغّل الخدمتان كلتاهما localtonet --headless. في هذا الوضع لا يطرح العميل أي أسئلة، ولا يخزّن التوكن في إعداداته الخاصة.
التوكنيمرّر systemd الملف /etc/localtonet/auth-token إلى الخدمة. ولا تبدأ الخدمة ما دام الملف مفقودًا.
البدء عند الإقلاعتبدأ الخدمة المفعّلة بعد أن تصبح الشبكة جاهزة.
إعادة التشغيليعيد systemd تشغيل العميل بعد عشر ثوانٍ من الفشل. ولا يعيد تشغيله عندما يتوقف العميل بسبب ملف توكن غير صالح. أصلح الملف وأعد تشغيل الخدمة بنفسك.

اقرأ السجل #

في وضع headless يكتب العميل أسطرًا نصية بسيطة في السجل (journal)، سطرًا لكل تغيير:

الطرفية
sudo journalctl -u localtonet.service -f
السطرالمعنى
Connection: Connectedحالة الجلسة. وقيمها الأخرى Connecting وDisconnected.
AuthTokenName: …اسم التوكن الذي سجّل به العميل الدخول.
OPEN …, ADDED …نفق يعمل على هذا الجهاز، مع عنوانه العام وبروتوكوله وهدفه المحلي.
STATUS …غيّر نفق حالته.
CLOSED …أُوقف نفق أو أُزيل.
Authentication failed: AuthToken was rejected.التوكن في الملف غير مقبول. انسخه مرة أخرى من «توكناتي».

إذا كان أحد هذه الأسطر سيحتوي على التوكن، يكتب العميل [redacted] مكانه.

الترقية #

نزّل الحزمة الجديدة وثبّتها بالطريقة نفسها التي ثبّتّ بها أول مرة، ثم أعد تشغيل الخدمة التي تستخدمها. يبقى ملف التوكن محفوظًا.

خدمة الأنفاق
sudo systemctl restart localtonet
خدمة VPN
sudo systemctl restart localtonet-vpn.service

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

الإزالة #

Debian, Ubuntu
sudo apt remove localtonet
Fedora, RHEL
sudo dnf remove localtonet

تؤدي إزالة الحزمة إلى إيقاف الخدمتين وتعطيلهما. وملف التوكن ملف إعدادات، ومديرو الحزم يتعاملون مع هذه الملفات بحذر: بعد الإزالة، تحقق مما إذا كان /etc/localtonet/auth-token أو نسخة محفوظة منه ما زال موجودًا، واحذفه إن لم تُرد بقاء التوكن على الجهاز.

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

Invalid Localtonet headless configuration. Check the token file or environment settings.

ملف التوكن غير قابل للاستخدام. تأكد من وجود /etc/localtonet/auth-token، ومن زوال القيمة البديلة DUMMY_AUTH_TOKEN، ومن أن الملف يحتوي على التوكن المكوّن من 33 حرفًا فقط، بلا مسافات وفي سطر واحد. شغّل الفحص بـ sudo، لأن root وحده يستطيع قراءة الملف.

الخدمة مفعّلة لكنها لا تعمل

شغّل systemctl status localtonet.service. لا تبدأ الخدمة ما دام /etc/localtonet/auth-token مفقودًا، ولا يُعاد تشغيلها بعد أن توقفت بسبب ملف توكن غير صالح. أصلح الملف، وشغّل فحص الإعداد، ثم شغّل sudo systemctl restart localtonet.service.

يقول السجل: Authentication failed: AuthToken was rejected.

الملف بالصيغة الصحيحة لكن التوكن غير مقبول. انسخ التوكن مرة أخرى من توكناتي، واحفظه في ملف التوكن وأعد تشغيل الخدمة.

توقفت خدمة الأنفاق عندما شغّلت خدمة VPN

هذا مقصود. الخدمتان تتعارضان، فيوقف systemd إحداهما عند بدء الأخرى. وخدمة VPN تخدم أنفاقك أيضًا.

لا تُثبَّت الحزمة على توزيعتي

تحتاج الحزم إلى systemd 247 أو أحدث وOpenSSL 3. وفي الإصدارات الأقدم لا يستطيع مدير الحزم تلبية هذه التبعيات. استخدم سكربت التثبيت أو أرشيفًا من صفحة Linux بدلًا من ذلك.

الحزم مدرجة أدناه. حدد تعليمات الإعداد تحت حزمة لعرض الأوامر مع اسم ملفها.

حزم Linux

حزم DEB و RPM قابلة للتثبيت لمعماريتي x64 و ARM64. تتطلب systemd 247 أو أحدث و OpenSSL 3، مثل Debian 12 أو Ubuntu 22.04+ أو RHEL 9.

  • Debian / Ubuntu · x64
    تعليمات الإعداد

    1. ثبّت الحزمة المنزَّلة. افتح الطرفية في المجلد الذي يحتوي على localtonet-linux-x64.deb.

    sudo apt install ./localtonet-linux-x64.deb

    2. اضبط AuthToken. حرّر /etc/localtonet/auth-token بصلاحيات root واستبدل DUMMY_AUTH_TOKEN بتوكنك في سطر واحد. ثم احمِ الملف وتحقّق من الإعدادات:

    sudo chmod 600 /etc/localtonet/auth-token
    sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config

    3. شغّل الخدمة. بعد نجاح فحص الإعدادات:

    sudo systemctl enable --now localtonet.service
    sudo journalctl -u localtonet.service

    لاستخدام VPN، انتقل إلى خدمة VPN:

    sudo modprobe tun
    sudo systemctl disable --now localtonet.service
    sudo systemctl enable --now localtonet-vpn.service
    sudo journalctl -u localtonet-vpn.service

    للترقية، ثبّت الحزمة الجديدة وشغّل sudo systemctl restart localtonet. تبقى إعداداتك محفوظة.

    إن كنت تستخدم VPN، فأعد تشغيل localtonet-vpn.service بدلًا من ذلك.

  • Debian / Ubuntu · ARM64
    تعليمات الإعداد

    1. ثبّت الحزمة المنزَّلة. افتح الطرفية في المجلد الذي يحتوي على localtonet-linux-arm64.deb.

    sudo apt install ./localtonet-linux-arm64.deb

    2. اضبط AuthToken. حرّر /etc/localtonet/auth-token بصلاحيات root واستبدل DUMMY_AUTH_TOKEN بتوكنك في سطر واحد. ثم احمِ الملف وتحقّق من الإعدادات:

    sudo chmod 600 /etc/localtonet/auth-token
    sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config

    3. شغّل الخدمة. بعد نجاح فحص الإعدادات:

    sudo systemctl enable --now localtonet.service
    sudo journalctl -u localtonet.service

    لاستخدام VPN، انتقل إلى خدمة VPN:

    sudo modprobe tun
    sudo systemctl disable --now localtonet.service
    sudo systemctl enable --now localtonet-vpn.service
    sudo journalctl -u localtonet-vpn.service

    للترقية، ثبّت الحزمة الجديدة وشغّل sudo systemctl restart localtonet. تبقى إعداداتك محفوظة.

    إن كنت تستخدم VPN، فأعد تشغيل localtonet-vpn.service بدلًا من ذلك.

  • Fedora / RHEL · x64
    تعليمات الإعداد

    1. ثبّت الحزمة المنزَّلة. افتح الطرفية في المجلد الذي يحتوي على localtonet-linux-x64.rpm.

    sudo dnf install ./localtonet-linux-x64.rpm

    2. اضبط AuthToken. حرّر /etc/localtonet/auth-token بصلاحيات root واستبدل DUMMY_AUTH_TOKEN بتوكنك في سطر واحد. ثم احمِ الملف وتحقّق من الإعدادات:

    sudo chmod 600 /etc/localtonet/auth-token
    sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config

    3. شغّل الخدمة. بعد نجاح فحص الإعدادات:

    sudo systemctl enable --now localtonet.service
    sudo journalctl -u localtonet.service

    لاستخدام VPN، انتقل إلى خدمة VPN:

    sudo modprobe tun
    sudo systemctl disable --now localtonet.service
    sudo systemctl enable --now localtonet-vpn.service
    sudo journalctl -u localtonet-vpn.service

    للترقية، ثبّت الحزمة الجديدة وشغّل sudo systemctl restart localtonet. تبقى إعداداتك محفوظة.

    إن كنت تستخدم VPN، فأعد تشغيل localtonet-vpn.service بدلًا من ذلك.

  • Fedora / RHEL · ARM64
    تعليمات الإعداد

    1. ثبّت الحزمة المنزَّلة. افتح الطرفية في المجلد الذي يحتوي على localtonet-linux-arm64.rpm.

    sudo dnf install ./localtonet-linux-arm64.rpm

    2. اضبط AuthToken. حرّر /etc/localtonet/auth-token بصلاحيات root واستبدل DUMMY_AUTH_TOKEN بتوكنك في سطر واحد. ثم احمِ الملف وتحقّق من الإعدادات:

    sudo chmod 600 /etc/localtonet/auth-token
    sudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config

    3. شغّل الخدمة. بعد نجاح فحص الإعدادات:

    sudo systemctl enable --now localtonet.service
    sudo journalctl -u localtonet.service

    لاستخدام VPN، انتقل إلى خدمة VPN:

    sudo modprobe tun
    sudo systemctl disable --now localtonet.service
    sudo systemctl enable --now localtonet-vpn.service
    sudo journalctl -u localtonet-vpn.service

    للترقية، ثبّت الحزمة الجديدة وشغّل sudo systemctl restart localtonet. تبقى إعداداتك محفوظة.

    إن كنت تستخدم VPN، فأعد تشغيل localtonet-vpn.service بدلًا من ذلك.

الدعم