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

طرفية الأجهزة

مجاني Desktop v8.6+ Windows وLinux وmacOS

مساعدة بشأن هذه الصفحة
في هذه الصفحة 13 قسمًا
  1. كيف يعمل
  2. قبل أن تبدأ
  3. إضافة جهاز
  4. افتح «إضافة جهاز»
  5. اختر التوكن
  6. شغّل الأمر على الحاسوب
  7. أدخل الرمز ووافق
  8. بدون وجود أحد عند الحاسوب
  9. خيارات الأمر
  10. قائمة الأجهزة
  11. فتح طرفية في المتصفح
  12. حدد «الطرفية»
  13. أدخل رمز المصادقة
  14. الاتصال عبر ssh
  15. مفاتيح SSH
  16. باستخدام عميل Localtonet
  17. مفاتيح الوصول للسكربتات ووكلاء الذكاء الاصطناعي
  18. Elio
  19. سجل الاتصالات
  20. إعادة تسمية الجهاز أو إزالته أو تعطيله
  21. ملاحظات أمنية
  22. استكشاف الأخطاء وإصلاحها
  23. صفحات ذات صلة

تعرض صفحة «أجهزتي» حواسيبك مع استهلاك المعالج (CPU) والذاكرة والقرص، وتفتح لك سطر أوامر حقيقيًا على أي منها من المتصفح. تفعّل الميزة بأمر واحد على الجهاز، ولا حاجة إلى أن يستمع أي شيء على الحاسوب عبر منفذ عام.

كيف يعمل #

تشغّل الأمر localtonet --terminal enable على الجهاز، ثم توافق في لوحة التحكم على الرمز القصير الذي يطبعه. بعد ذلك يفتح الزر الطرفية سطر أوامر على ذلك الجهاز في تبويب بالمتصفح. ويمكن الوصول إلى السطر نفسه من أي طرفية بأمر ssh تعرضه لوحة التحكم.

  • يجري الجهاز اتصالات صادرة فقط. لا يلزم فتح أي منفذ وارد ولا تثبيت خادم SSH.
  • يتطلب فتح سطر أوامر من المتصفح رمزًا جديدًا من تطبيق المصادقة في كل مرة.
  • الأمر المحلي وحده يستطيع تشغيل الطرفية. ولا يمكن تفعيلها من لوحة التحكم.

قبل أن تبدأ #

  • Localtonet على الجهاز. الحد الأدنى لإصدار تطبيق Localtonet المطلوب لاستخدام هذه الميزة: Desktop v8.6. احصل عليه من صفحة التنزيلات.
  • AuthToken لذلك الجهاز. امنح كل حاسوب توكنًا خاصًا به: تشغيل توكن واحد على حاسوب ثانٍ يقطع اتصال الأول. تعمل الطرفية مع توكنات حسابك الشخصي، لا مع توكنات الفريق. راجع AuthTokens.
  • المصادقة الثنائية. يتطلب فتح سطر الأوامر تطبيق مصادقة على حسابك. وإن لم يكن مُعدًّا بعد، تعرض صفحة أجهزتي الزر تفعيل المصادقة الثنائية. راجع الحساب والأمان.

تجد «أجهزتي» في قائمة لوحة التحكم الشخصية. ولا تظهر عندما يكون فريق محددًا.

إضافة جهاز #

  1. افتح «إضافة جهاز» #

    افتح أجهزتي وحدد إضافة جهاز.

  2. اختر التوكن #

    اختر توكنًا موجودًا، أو حدد إنشاء توكن جديد لإنشاء توكن ووضعه في الأمر. إذا كان Localtonet يعمل بالفعل على هذا الحاسوب، فاختر توكنه. تشير القائمة إلى التوكنات المتصلة أو المستخدمة بالفعل على جهاز آخر. ويظهر تحذير للتوكن المتصل حاليًا: استخدمه فقط إذا كان Localtonet يعمل على هذا الحاسوب نفسه.

  3. شغّل الأمر على الحاسوب #

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

    على الحاسوب
    localtonet --terminal enable --authtoken <YOUR_TOKEN>

    يطبع الأمر رمز موافقة وينتظر:

    المخرجات
    Approval code: ABCD-EFGH
    Open https://localtonet.com/devices, choose Add device and enter this code.
    Waiting for approval...

    عند تشغيله بصلاحيات المسؤول أو root، يسأل أولًا Run shells as user: ويقترح حسابك. وبدون هذه الصلاحيات، تعمل الجلسات بالحساب الذي شغّل الأمر.

  4. أدخل الرمز ووافق #

    عد إلى النافذة واكتب رمز الموافقة تحت 2. أدخل الرمز الذي يظهره. تُضاف الأحرف الكبيرة والشرطة تلقائيًا، ويمكنك لصق السطر كاملًا كما طبعه الأمر. أدخل الرمز المكوّن من 6 أرقام من تطبيق المصادقة وحدد الموافقة على الجهاز.

    يطبع الأمر على الحاسوب بعد ذلك Terminal enabled. Shells will run as … ويظهر الجهاز في القائمة. ويظهر كمتصل ما دام Localtonet يعمل عليه.

رمز الموافقة صالح لمدة 15 دقيقة. يتكون من 8 أحرف ولا يحتوي أبدًا على I أو L أو O أو U أو 0 أو 1. إذا انتهت صلاحيته، يخبرك الأمر بذلك: شغّله مرة أخرى.

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

بدون وجود أحد عند الحاسوب #

للجهاز الذي لا يستطيع أحد قراءة رمز عليه، مثل خادم تُعدّه بسكربت، استخدم مفتاحًا لمرة واحدة بدل رمز الموافقة.

  1. في نافذة إضافة جهاز، اختر التوكن وأدخل رمز المصادقة.
  2. افتح لا يستطيع أحد قراءة رمز على ذلك الحاسوب؟ وحدد إنشاء مفتاح لمرة واحدة. المفتاح صالح لمدة ساعة واحدة ويعمل مرة واحدة فقط.
  3. انسخ الأمر واستبدل ACCOUNT بحساب المستخدم الذي ستعمل به الجلسات على ذلك الحاسوب.
على الحاسوب
localtonet --terminal enable --authtoken <YOUR_TOKEN> --terminal-user <ACCOUNT> --pairing-key <PAIRING_KEY>

مع مفتاح صالح تتم الموافقة على الجهاز فورًا ولا يظهر أي رمز.

خيارات الأمر #

الخيارما يفعله
--terminal enableيشغّل الطرفية البعيدة لهذا الحاسوب ويبدأ الاقتران.
--terminal disableيوقفها على هذا الحاسوب ويزيل الجهاز من حسابك.
--terminal statusيطبع ما إذا كانت الطرفية مفعّلة وبأي حساب تعمل الجلسات.
--terminal-user <ACCOUNT>الحساب الذي تعمل به الجلسات عند التفعيل بصلاحيات root أو المسؤول. وهو مطلوب في تلك الحالة عندما يعمل الأمر بدون وحدة تحكم، مثل التشغيل من سكربت.
--pairing-key <PAIRING_KEY>المفتاح لمرة واحدة من لوحة التحكم، فلا حاجة إلى رمز موافقة.

قائمة الأجهزة #

تتحدث القائمة تلقائيًا ما دامت الصفحة مفتوحة.

العمودما يعرضه
الجهازاسم الحاسوب ونظام التشغيل والمعمارية والحساب الذي تعمل به الجلسات.
الحالةمتصل يعني أن Localtonet يعمل على الحاسوب وهو متصل.
CPUحمل المعالج الحالي. يظهر عندما يكون الجهاز متصلًا.
الذاكرةالذاكرة المستخدمة من الإجمالي. تظهر عندما يكون الجهاز متصلًا.
القرصمساحة القرص المستخدمة من الإجمالي. تظهر عندما يكون الجهاز متصلًا.
الإجراءاتالطرفية والمفاتيح وسجل الاتصالات وإعادة التسمية والإزالة.

فتح طرفية في المتصفح #

  1. حدد «الطرفية» #

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

  2. أدخل رمز المصادقة #

    أدخل الرمز المكوّن من 6 أرقام من تطبيق المصادقة وحدد فتح الطرفية. يُفتح سطر الأوامر في تبويب جديد بالمتصفح.

الاتصال عبر ssh #

تعرض نافذة الطرفية أيضًا أمرًا تحت أو من أي طرفية، دون تثبيت أي شيء. ويعمل من أي حاسوب فيه عميل ssh. للأمر الصيغة التالية، حيث <DEVICE> هو اسم جهازك و<NODE> هو خادم Localtonet المتصل به:

أي طرفية
ssh -p 24 <DEVICE>@<NODE>

انسخ الأمر من النافذة: فهي تعرض الأمر الدقيق لجهازك.

  • تعرض النافذة بصمة الخادم. يعرض ssh بصمة عند أول اتصال. إذا تطابقت، فقد وصلت إلى Localtonet.
  • إذا لم تكن قد أضفت مفتاح SSH، يعرض ssh رابطًا للموافقة في المتصفح. تذكر صفحة الموافقة على الاتصال اسم الجهاز وعنوان IP الذي جاء منه الطلب. أدخل رمز المصادقة وحدد السماح بالاتصال، ثم عد إلى طرفيتك. ينتهي الطلب بعد 5 دقائق.

لا توافق على اتصال إلا إذا شغّلت أمر ssh بنفسك للتو. من قدّم الطلب يحصل على سطر أوامر على ذلك الحاسوب.

مفاتيح SSH #

أضف مفتاح SSH العام لحاسوبك حتى تتصل الأوامر ssh وscp وsftp دون طلب موافقة في المتصفح.

  1. في أجهزتي، حدد مفاتيح SSH.
  2. أدخل الاسم والصق سطرًا واحدًا من ملف مفتاحك العام، مثل ~/.ssh/id_ed25519.pub، في المفتاح العام. لا تلصق مفتاحك الخاص أبدًا.
  3. أدخل رمز المصادقة وحدد إضافة مفتاح.

أنواع المفاتيح المقبولة هي ssh-ed25519 وecdsa-sha2-nistp256 وecdsa-sha2-nistp384 وecdsa-sha2-nistp521 وssh-rsa. ويسري المفتاح على جميع أجهزة حسابك. حدد إزالة بجوار المفتاح لإيقاف عمله. وتعرض النافذة أيضًا مثالًا لـ scp لأحد أجهزتك:

أي طرفية
scp -P 24 file.txt <DEVICE>@<NODE>:/tmp/

باستخدام عميل Localtonet #

إذا كان Localtonet مثبتًا على الحاسوب الذي تتصل منه، فإن localtonet ssh يتصل أيضًا، وتبقى الجلسة مشفّرة حتى الجهاز.

أي طرفية
localtonet ssh <DEVICE>
localtonet ssh <DEVICE> -- uptime

بدون مفتاح يطبع Approve this connection in your browser مع رابط، ويتابع بعد موافقتك. وكل ما يلي -- يُنفَّذ كأمر واحد على الجهاز بدل فتح جلسة.

مفاتيح الوصول للسكربتات ووكلاء الذكاء الاصطناعي #

يتيح مفتاح الوصول لسكربت أو وكيل ذكاء اصطناعي الوصول إلى حاسوب واحد بدون متصفح. ومن يحمله يستطيع تشغيل أوامر هناك، فأبقِه سريًا.

  1. حدد المفاتيح في صف الجهاز.
  2. أدخل الاسم، وعيّن مدة الصلاحية (بالأيام) وأدخل رمز المصادقة. يتوقف المفتاح عن العمل بعد هذا العدد من الأيام، بحد أقصى 3650.
  3. حدد إنشاء مفتاح وانسخ المفتاح الآن. لن يظهر مرة أخرى.

طرق استخدام المفتاح:

  • ssh. شغّل أمر ssh الذي تعرضه النافذة. وعندما يطلب ssh المفتاح، الصقه.
  • عميل Localtonet. مرّر المفتاح بالخيار --key، كما في المثال أدناه.
  • MCP. يمكن لوكلاء الذكاء الاصطناعي المتصلين بـخادم MCP في Localtonet تمرير المفتاح إلى الأداة RunDeviceCommand.
سكربت
localtonet ssh <DEVICE> --key <ACCESS_KEY> -- uptime

تسرد النافذة مفاتيح الجهاز مع تاريخ انتهاء كل منها. حدد إزالة لإبطال أحدها.

Elio #

يتعلق الزر Elio في صفحة أجهزتي بتطبيق Elio، عميل SSH المجاني والمفتوح المصدر من Localtonet. تنزّله من elio.sh، وتسجّل الدخول من Elio، ثم توافق على الطلب في لوحة التحكم برمز المصادقة الثنائية. عندها يرى Elio أسماء أجهزتك وحالتها. أما فتح سطر أوامر على أحدها فيتطلب مفتاح وصول ذلك الجهاز أو موافقة. وتسرد النافذة نسخ Elio المسجَّل دخولها؛ وإزالة إحداها تسجّل خروجها.

سجل الاتصالات #

حدد زر الساعة في صف الجهاز لرؤية أحدث اتصالاته. يعرض كل سطر وقت حدوثه وكيف تم ومن أي عنوان IP. وطريقة الاتصال إحدى التالي: طرفية المتصفح، أو ssh بمفتاح SSH الخاص بك، أو ssh بمفتاح وصول، أو ssh تمت الموافقة عليه في المتصفح، أو localtonet ssh بمفتاح وصول أو بموافقة في المتصفح، أو وكيل ذكاء اصطناعي عبر MCP بمفتاح وصول. تحتفظ القائمة بآخر 50 اتصالًا.

يحتفظ Localtonet بهذا السجل فقط. ولا تُخزَّن الأوامر التي تكتبها ولا مخرجاتها. استخدم القائمة لاكتشاف اتصال لم تجرِه: وإذا وجدت واحدًا، فأزل مفاتيح الوصول ومفاتيح SSH التي لم تعد بحاجة إليها.

إعادة تسمية الجهاز أو إزالته أو تعطيله #

الإجراءمكانهالنتيجة
إعادة التسميةزر القلم في الصف.يغيّر الاسم المعروض في القائمة والمستخدم في أمر ssh. استخدم أحرفًا وأرقامًا ونقاطًا وشرطات أو شرطات سفلية.
الإزالةزر سلة المهملات في الصف.يزيل الحاسوب من حسابك. تتوقف مفاتيحه عن العمل ويجب الموافقة عليه من جديد ليعود.
التعطيلعلى الحاسوب نفسه.يوقف الطرفية محليًا ويزيل الجهاز من حسابك.
على الحاسوب
localtonet --terminal disable --authtoken <YOUR_TOKEN>
localtonet --terminal status --authtoken <YOUR_TOKEN>

يعمل التعطيل دائمًا على الحاسوب، حتى عندما يتعذر الوصول إلى لوحة التحكم. وفي هذه الحالة يطلب منك الأمر إزالة الجهاز من لوحة التحكم أيضًا.

ملاحظات أمنية #

  • سطر الأوامر على جهاز يمنح وصولًا كاملًا إلى كل ما يستطيع حسابه فعله. اختر بعناية الحساب الذي تعمل به الجلسات؛ فالحساب غير المميز يحد مما تستطيع الجلسة تغييره.
  • كل ما قد يؤدي إلى سطر أوامر يطلب رمز مصادقة جديدًا: الموافقة على جهاز، وفتح طرفية، وإنشاء مفتاح وصول، وإضافة مفتاح SSH، والموافقة على اتصال ssh.
  • يتصل مفتاح الوصول أو مفتاح SSH المضاف دون ذلك الرمز. امنح المفاتيح مدة صلاحية قصيرة، وخزّنها كما تخزّن كلمات المرور، وأزل ما لم تعد تستخدمه.
  • بعد محاولات كثيرة في وقت قصير ترد لوحة التحكم بـ محاولات كثيرة جدًا. انتظر دقيقة ثم أعد المحاولة.
  • راجع سجل الاتصالات بين حين وآخر. الاتصال الذي لا تعرفه يعني أنه استُخدم مفتاح أو موافقة لم تتوقعها.
  • إزالة جهاز، أو تشغيل --terminal disable عليه، ينهي الوصول لجميع مفاتيحه.

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

رمز الموافقة هذا خاطئ أو منتهي الصلاحية

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

Remote terminal is available on personal tokens only

التوكن في الأمر يخص فريقًا. أنشئ توكنًا في حسابك الشخصي واستخدمه.

The pairing key is not valid or has expired

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

Choose the account for shells with --terminal-user

يعمل الأمر بصلاحيات root أو المسؤول بدون وحدة تحكم، فلا يستطيع السؤال. أضف --terminal-user <ACCOUNT>.

زر الطرفية معطّل، أو «هذا الجهاز غير متصل»

تُفتح الطرفية فقط عندما يكون الجهاز متصلًا. شغّل Localtonet على ذلك الحاسوب بالتوكن نفسه.

رمز المصادقة هذا غير صحيح

أدخل الرمز المكوّن من 6 أرقام الذي يعرضه تطبيق المصادقة لـ Localtonet. ليس كلمة المرور ولا الرمز المعروض على الحاسوب، ويتغير كل 30 ثانية.

انتهت صلاحية هذا الطلب. ابدأ من جديد من صفحة أجهزتي

الطلب لفتح طرفية أو للموافقة على اتصال ssh قصير العمر. حدد الطرفية مرة أخرى، أو شغّل أمر ssh مرة أخرى.

لا يبدو هذا مفتاح SSH عامًا

الصق السطر كاملًا من ملف .pub، بدءًا من نوع المفتاح.

The terminal is already enabled on this device

لا شيء لفعله. لإعادة اقتران الجهاز، شغّل --terminal disable أولًا ثم --terminal enable.

الدعم