الأسئلة الشائعة FAQ

يجمّع هذا المقال أكثر المشكلات تكرارًا أثناء استخدام اللوحة وطرق تشخيصها.

التثبيت وتسجيل الدخول

س: ما الشروط اللازمة لتثبيت اللوحة؟

خادم Linux يملك IP عام (ويُفضَّل توزيعة شائعة مثل Debian / Ubuntu / CentOS)، وذاكرة 512MB فأكثر تكفي لتشغيل سلس. والخوادم المُدارة لا تحتاج إلى تثبيت أي شيء، ويكفي أن تكون قابلة للاتصال عبر SSH.

س: ما الحساب وكلمة المرور الافتراضيان؟

الحساب الافتراضي admin، وكلمة المرور 123456. وبادِر بتغييرها فور أول تسجيل دخول (أيقونة المستخدم أعلى يمين اللوحة ← إعدادات المستخدم).

س: نسيت كلمة مرور الدخول، ماذا أفعل؟

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

# ادخل إلى دليل تثبيت اللوحة، واستخدم السكربت المدمج لإعادة ضبط كلمة المرور
cd /opt/ssh-everywhere
python3 -c "from app import reset_password; reset_password('new-password')"

> قد يتغيّر اسم السكربت تحديدًا من إصدار إلى آخر، ويمكنك أيضًا تحرير جدول users في قاعدة البيانات data/ssheverywhere.db مباشرة.

س: كيف أغيّر منفذ اللوحة (5501)؟

عدّل Environment=PORT=5501 في خدمة systemd، ثم أعد التحميل:

systemctl edit ssh-everywhere.service
# إضافة أو تعديل: Environment=PORT=your-port
systemctl daemon-reload && systemctl restart ssh-everywhere.service

وبعد التعديل تذكّر السماح بالمنفذ الجديد في الجدار الناري السحابي/مجموعة الأمان.

س: لا أستطيع الوصول إلى اللوحة (المنفذ 5501)؟

شخّص بالترتيب:

1. تأكّد أن خدمة اللوحة تعمل: systemctl status ssh-everywhere.service

2. افحص هل سمح الجدار الناري السحابي/مجموعة الأمان لخادم اللوحة بالمنفذ 5501 (وهذا هو السبب الأكثر شيوعًا)

3. تأكّد أن عنوان الوصول هو http://server-public-ip:5501 (لا https، إلا إذا كنت قد أعددت وكيلًا عكسيًا)

ما يخص الخوادم

س: الخادم يظهر «غير متصل»، ماذا أفعل؟

«غير متصل» تعني فقط أن اللوحة عاجزة عن الاتصال به عبر SSH، ولا تعني أن الخادم ساقط. شخّص بالترتيب:

1. تأكّد أن الخادم نفسه متصل: اذهب إلى لوحة مزوّد الخادم واطّلع على حالة الطاقة

2. اختبر إمكانية الوصول إلى منفذ SSH: نفّذ من خادم اللوحة nc -zv <target-IP> <port> لترى هل المنفذ يعمل

3. افحص الجدار الناري/مجموعة الأمان: هل سمح الجدار الناري السحابي/مجموعة الأمان للخادم الهدف بمنفذ SSH

4. راجع ربط المنافذ في خوادم NAT: تأكّد من بقاء ربط منفذ NAT، وصحة IP الشبكة الداخلية الهدف

5. افحص قائمة IP المسموح بها للمصدر: بعض المزوّدين يقيّدون منفذ SSH بعنوان IP المصدر، فتحتاج إلى إضافة IP خادم اللوحة إلى القائمة البيضاء

6. راجع الحساب وكلمة المرور: هل اسم المستخدم وكلمة المرور/المفتاح الخاص صحيحة

س: لا يتصل عند إضافة خادم؟

تأكّد من صحة منفذ SSH واسم المستخدم وكلمة المرور
تأكّد أن sshd يعمل على الخادم الهدف
تأكّد أن الجدار الناري سمح بمنفذ SSH
السحابات الكبرى (Tencent Cloud / Alibaba Cloud) تعطّل root افتراضيًا، فسجّل الدخول بمستخدم عادي (مثل ubuntu)

س: خادم NAT (بمنفذ غير 22) لا يتصل؟

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

تعطّل ربط المنفذ (راجعه/أعد إنشاءه من لوحة المزوّد)
المزوّد يقيّد عناوين IP المصدر بقائمة بيضاء (أضف IP خادم اللوحة إليها)
خطأ في IP/منفذ الشبكة الداخلية الهدف المربوط

ما يخص نفق المنافذ / إعادة التوجيه

س: نفق المنافذ يظهر «غير متصل»؟

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

س: إعادة توجيه منفذ غير 22 لا تعمل؟

إعادة توجيه منفذ غير SSH (مثل 9117) يتطلب أن يكون على خادم النفق Agent إصدار جديد (الإصدار القديم يدعم 22 فقط). أعد تثبيت الـ Agent فقط.

س: أنشأت إعادة توجيه منفذ لكنها لا تعمل؟

إعادة توجيه المنافذ التقليدية تحتاج إلى التنفيذ على الخادم نفسه الذي يملك IP عامًا مستقلًا. افحص:

1. هل سمح الخادم الهدف/الجدار الناري الوسيط بمنفذ الهدف

2. هل IP الهدف المكتوب هو عنوان حقيقي قابل للوصول

3. هل اعترضت مجموعة الأمان السحابية منفذ الاستماع

س: ما الفرق بين نفق المنافذ وإعادة توجيه المنافذ؟

نفق المنافذ: للأجهزة التي لا تملك IP عامًا، ويسير عبر النفق العكسي، فيُفتح منفذ عام على خادم اللوحة.
إعادة توجيه المنافذ: للخوادم التي تملك IP عامًا، ويسير عبر DNAT في جدار النظام، ويُنفَّذ على الخادم الهدف نفسه.

التفاصيل في نفق المنافذ وإعادة توجيه المنافذ.

ما يخص Docker / تثبيت التطبيقات

س: فشل تثبيت دليل التطبيقات/Docker، ماذا أفعل؟

تعرض اللوحة رسالة الخطأ كما هي (ولا تدّعي نجاحًا غير حاصل). والأسباب الشائعة:

1. توزيعة قديمة جدًا: إصدارات منتهية الدعم مثل Fedora 32 توقّفت مصادر برامجها، وينتهي التثبيت بمهلة أو بالفشل. ويُنصح بالترقية.

2. الشبكة غير قابلة للوصول: قد يتعذّر الوصول إلى مصادر Docker الرسمية (get.docker.com / download.docker.com) في بعض بيئات الشبكة (مثل خوادم NAT في الصين القارية). وعندها اضبط مصدر مرايا Docker محليًا، أو استخدم وظيفة «مصادر المرايا» للتبديل إلى مصدر Alibaba Cloud.

3. فروق أسماء الحزم: بعض التطبيقات (مثل ufw ومصدر deb.nodesource الخاص بـ Node.js) تعتمد توزيعة معيّنة وقد لا تُثبَّت على غير Debian/Ubuntu، وستوضّح رسالة الخطأ ذلك بشكل صريح.

س: سحب صور Docker بطيء/ينتهي بمهلة على خوادم داخل الصين؟

هذه مشكلة شبكة لا مشكلة في اللوحة. يُنصح بضبط مسرّع مرايا Docker (مسرّعات عامة مثل docker.1ms.run / docker.m.daocloud.io)، أو تنفيذ ما يلي على الخادم أولًا:

# للمرجع: ضبط مسرّع Alibaba Cloud الشخصي (استبدل العنوان بعنوان مسرّعك)
sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<'EOF'
{ "registry-mirrors": ["https://your-accelerator-address"] }
EOF
sudo systemctl restart docker

حيل تشخيص عامة

1. اختبر المنفذ أولًا، ثم افحص الحساب وكلمة المرور: nc -zv <IP> <port>

2. قارن مع خوادم أخرى: إذا اتصل غيرها من الخوادم المماثلة ولم يتصل هذا الخادم وحده، فالخلل خاص به (جدار ناري/ربط/قائمة بيضاء)

3. اطّلع على السجلات: سجل اللوحة في service.log، وسجلات النفق/الـ Agent تساعد في تحديد مشكلات الاتصال

الوثائق