استكشاف الأخطاء

تغطّي هذه الصفحة مشكلات Mobile SSH الشائعة والفحوص الأولى التي ينبغي إجراؤها قبل تغيير إعدادات SSH على جانب الخادم.

تعذّر الاتصال

تحقّق من:

• أن الجهاز لديه وصول شبكي.
• أن اسم مضيف الخادم أو عنوان IP صحيح.
• أن منفذ SSH صحيح، وعادةً 22.
• ألا يحجب الجدار الناري أو VPN أو شبكة المشغّل أو شبكة Wi-Fi المنفذ.
• أن خادم SSH يعمل ويقبل الاتصالات من الشبكة التي تستخدمها.

إذا كان المضيف نفسه يعمل من جهاز آخر، فقارِن بدقة المضيف والمنفذ واسم المستخدم والمفتاح ومسار الشبكة.

فشل المصادقة

تحقّق من:

• تهجئة اسم المستخدم.
• كلمة المرور أو عبارة مرور المفتاح.
• ما إذا كان الخادم يسمح بتسجيل الدخول بكلمة المرور أو بالمفتاح أو كليهما.
• ما إذا كان المفتاح الخاص يطابق مفتاحًا عامًا في authorized_keys لمستخدم الخادم.
• ما إذا كان ملف المفتاح قد استُورِد كاملًا، بما في ذلك سطرا الترويسة والتذييل.

بالنسبة للمفاتيح الخاصة المشفّرة، أدخِل عبارة المرور في حقل كلمة المرور/عبارة المرور.

فشل استيراد المفتاح الخاص

يستخدم استيراد المفتاح الخاص منتقي ملفات النظام. إذا فشل الاستيراد:

• تأكّد من أن الملف المحدّد مفتاح خاص، وليس ملف .pub عامًا.
• افتح الملف في محرّر نصوص موثوق وتحقّق من احتوائه على كتلة المفتاح الكاملة.
• جرّب لصق المفتاح يدويًا في حقل المفتاح الخاص.
• تأكّد من أن نوع المفتاح مدعوم: Ed25519 أو ECDSA ‏(P-256/384/521) أو RSA على Android؛ وEd25519 أو ECDSA على iOS. أمّا DSA (ssh-dss) فلا يعمل على أيٍّ منهما، وiOS لا يدعم RSA — أنشئ مفتاح Ed25519 بدلًا منه.

إدخال لوحة المفاتيح متأخّر أو متغيّر

يرسل Mobile SSH ضغطات المفاتيح مباشرةً إلى الصدفة مع إيقاف التصحيح التلقائي والاقتراحات التنبّؤية، لذا لا ينبغي أن تعيد لوحة المفاتيح كتابة النص قبل وصوله إلى الطرف البعيد. إذا كانت لوحة مفاتيحك لا تزال تغيّر الإدخال، فتأكّد من عدم وجود أداة استبدال أو حافظة على مستوى النظام تعترضه، واستخدم صف المفاتيح الإضافية لمفاتيح الطرفية مثل ESC وTAB وCTRL والأسهم وHOME وEND وPGUP وPGDN.

تمرير tmux ليس كما تتوقّع

يغيّر Mobile SSH سلوك التمرير حسب حالة الطرفية. في tmux أو برامج الشاشة البديلة الأخرى، قد ترسل إيماءات التمرير أوامر وضع نسخ tmux بدلًا من تمرير السجل المحلي. إذا كان وضع فأرة tmux مفعّلًا، يرسل التطبيق تسلسلات هروب عجلة الفأرة.

إذا بدا التمرير خاطئًا:

• جرّب تفعيل أو تعطيل وضع فأرة tmux على الخادم البعيد.
• استخدم PGUP وPGDN من صف المفاتيح الإضافية.
• اضغط مرتين على الجزء لملء الشاشة قبل تمرير خرج كثيف.
• افصل وأعِد الإرفاق بـ tmux إذا بدا حجم الطرفية البعيدة قديمًا.

انقطاع الجلسة بعد قفل الشاشة

على Android، يستخدم Mobile SSH رسائل الإبقاء على الاتصال، وخدمة في المقدّمة، وقفل التنبيه، وقفل Wi-Fi، ومحاولات إعادة الاتصال لتقليل الانقطاعات. ومع ذلك قد توقِف سياسات بطارية Android العمل في الخلفية.

تحقّق من:

• عطّل تحسين البطارية لـ Mobile SSH إذا كان جهازك يوقِف تطبيقات الخلفية بقوة.
• حافظ على استقرار Wi-Fi أو بيانات الجوّال أثناء الجلسات الطويلة.
• أعِد فتح Mobile SSH واضغط Active Sessions بعد إلغاء القفل.
• تحقّق من تفعيل إبقاء الجلسات تعمل في الخلفية في الإعدادات إن أردت أن تصمد الأصداف بعد إزاحة التطبيق من قائمة التطبيقات الأخيرة.
• إذا قطع الخادم جلسة SSH، فأعِد الاتصال من الشاشة الرئيسية — يسرد Continue ما لا يزال حيًّا، ويسرد Tmux sessions ما ينتظرك على الخادم.

على iOS، يعلّق النظام التطبيقات في الخلفية، لذا لا يمكن إبقاء اتصال SSH خام مفتوحًا إلى أجل غير مسمى بعد التبديل عن التطبيق أو قفل الشاشة. تغطي مهلة سماح قصيرة عمليات التبديل السريعة بين التطبيقات؛ ولأي مدة أطول، فعّل Auto-attach tmux session في ملف الخادم (أو استخدم ناقل Eternal Terminal) بحيث تعيدك إعادة الاتصال إلى الصدفة نفسها حيث توقفت.

نقل الملفات لا يتصفّح ملفات الهاتف

لا يطلب Mobile SSH أيّ إذن تخزين على Android. بل يعرض الجزء المحلي مجلدًا واحدًا تمنحه عبر منتقي المجلدات في النظام — وإن كان فارغًا، فاستخدم Pick folder لاختيار واحد. ويستمرّ هذا المنح، فهي خطوة تُنفَّذ مرة واحدة.

إذا حُمِّلت الملفات البعيدة دون المحلية، فاتصال SSH سليم وإنما لم تمنح مجلدًا بعد.

على iOS يعرض الجزء المحلي منطقة مستندات التطبيق، وتضيف الملفات عبر منتقيَي المستندات والصور في النظام. والتنزيلات هناك مرئية أيضًا في تطبيق «الملفات» ضمن On My iPhone.

فشل الرفع أو التنزيل

تحقّق من:

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

فشل إعادة توجيه المنفذ

تحقّق من:

• أن المنفذ المحلي بين 1 و65535.
• أن المنفذ المحلي غير مستخدم بالفعل.
• أن سلسلة النفق هي PORT أو LOCAL:REMOTEHOST:REMOTE.
• أن المضيف البعيد والمنفذ البعيد قابلان للوصول من خادم SSH.
• أن خادم SSH يسمح بإعادة توجيه TCP.

سجلات التصحيح

تسجّل المنصّتان أشياء مختلفة، فاختر ما يناسب مشكلتك.

Android — الطرفية والعرض. فعّل Settings ← Debugging ← Show Debug and Logs buttons، ثم استخدم زر Debug الذي يظهر على الشاشة الرئيسية. يسجّل أحداث الطرفية، وأحجام بيانات SSH، وإدخال اللمس، وسلوك تغيير الحجم، ودورة حياة الأنفاق. وبدء التسجيل يحذّرك أولًا بأنه يلتقط كل مفتاح تكتبه، بما في ذلك كلمات المرور. وإيقافه يكتب أرشيفًا في مجلد التنزيلات لديك.

iOS — الاتصالات وإعادة الاتصال. فعّل Settings ← Diagnostics ← Record debug log. يسجّل كل عنوان جرى الاتصال به وسبب فشله، ومحاولات إعادة الاتصال وفترات تراجعها، والاتصالات المنقطعة، و«peer stopped answering keepalives»، وتغيّرات الشبكة، وأوامر tmux مع أخطائها. وتعرض الإعدادات عدّاد أسطر حيًّا لتتأكّد من أنه يسجّل، ويشارك Export Debug Log السجل كملف نصي. وهو محفوظ في الذاكرة ويغطّي جلسة التطبيق الحالية فقط.

راجِع أيّ سجل أو أرشيف تصحيح قبل مشاركته. فهي مخصّصة لاستكشاف الأخطاء وقد تكشف أسماء الخوادم، والعناوين، والتوقيتات، أو تفاصيل بيئة أخرى — وعلى Android، كل ما كتبته.