ثبّت Localtonet من حزمة DEB أو RPM
في هذه الصفحة 9 أقسام
تثبّت حزم 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، يثبّتها مدير الحزم لديك. تثبيت الحزمة لا يفعّل أي خدمة ولا يشغّلها: تعيّن التوكن أولًا ثم تفعّل الخدمة التي تحتاجها.
الخطوات #
-
نزّل الحزمة وثبّتها #
اختر الحزمة المناسبة لتوزيعتك ومعالجك من القائمة في نهاية هذه الصفحة، ثم ثبّت الملف الذي نزّلته بـ
apt(DEB) أوdnf(RPM). يعرض تعليمات الإعداد تحت كل حزمة الأوامر الدقيقة لذلك الملف. -
عيّن AuthToken الخاص بك #
حرّر
/etc/localtonet/auth-tokenبصلاحيات root بمحرر نصوص واستبدلDUMMY_AUTH_TOKENبتوكنك في سطر واحد. ثم تأكد من أن root وحده يستطيع قراءة الملف:الطرفيةsudo chmod 600 /etc/localtonet/auth-token -
افحص الإعداد #
الطرفيةsudo localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-configيقرأ الفحص ملف التوكن دون اتصال. ويجيب
Localtonet headless configuration OK.عندما يحتوي الملف على توكن من 33 حرفًا بلا مسافات. ولا يسأل خوادم Localtonet عما إذا كان التوكن صالحًا لحسابك. -
فعّل خدمة #
للأنفاق، فعّل خدمة الأنفاق واقرأ سجلها:
الطرفيةsudo systemctl enable --now localtonet.service sudo journalctl -u localtonet.serviceإذا كان هذا الجهاز ينضم أيضًا إلى شبكة VPN، ففعّل خدمة VPN بدلًا منها. راجع خدمة الأنفاق أم خدمة VPN.
-
شغّل نفقًا #
يظهر التوكن الآن متصل في توكناتي. أنشئ نفقًا له وشغّله في لوحة التحكم، راجع البدء السريع.
خدمة الأنفاق أم خدمة VPN #
تشغّل الخدمتان العميل نفسه وتخدمان أنفاقك كلتاهما. والفرق في الصلاحيات التي تعملان بها. فعّل إحداهما فقط: الخدمتان تتعارضان، وتشغيل إحداهما يوقف الأخرى.
localtonet.service | localtonet-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 localtonetsudo systemctl restart localtonet-vpn.serviceفي توكناتي، يعرض العمود العميل الإصدار الذي أبلغ عنه الجهاز آخر مرة وشارة يحتاج إلى تحديث عند توفر إصدار أحدث.
الإزالة #
sudo apt remove localtonetsudo 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.deb2. اضبط 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-config3. شغّل الخدمة. بعد نجاح فحص الإعدادات:
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.deb2. اضبط 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-config3. شغّل الخدمة. بعد نجاح فحص الإعدادات:
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.rpm2. اضبط 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-config3. شغّل الخدمة. بعد نجاح فحص الإعدادات:
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.rpm2. اضبط 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-config3. شغّل الخدمة. بعد نجاح فحص الإعدادات:
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بدلًا من ذلك.