معالجة «The WebSocket handshake failed» في الطرفية
تفشل طرفية cPanel حين تُفتَح عبر نطاق فرعي وكيل. استخدم أحد العناوين التي تتصل مباشرة.
تعرض Terminal في cPanel:
Error: The WebSocket handshake failedينطبق على الاستضافة المشتركة والموزِّعة والمميّزة.
لماذا يحدث
تحتاج الطرفية اتصال WebSocket، وهو اتصال HTTP مرقّى طويل الأمد لا طلبًا عاديًا.
والوصول إلى cPanel عبر نطاق فرعي وكيل مثل https://cpanel.example.com يوجّه ذلك
الاتصال عبر خادم الويب، وهو لا يمرّر الترقية. فتُحمَّل الصفحة؛ ولا تستطيع
الطرفية الاتصال.
استخدم عنوانًا مباشرًا بدلًا منه
أي من هذه يتصل بـ cPanel مباشرة:
| العنوان | ملاحظات |
|---|---|
https://example.com:2083 | المنفذ 2083 هو cPanel مباشرة. الأوثق |
https://server-hostname:2083 | يعمل حتى إن كان النطاق لا يشير إلى هنا |
https://example.com/cpanel | يعمل عادةً |
سجّل الدخول من جديد على أحدها وافتح Terminal.
إن كنت خلف Cloudflare، فاستخدم اسم مضيف الخادم على المنفذ 2083. فـ Cloudflare لا توكّل المنفذ 2083، فيذهب الاتصال مباشرة إلى الخادم — ووكيل Cloudflare نفسه شيء ثانٍ قد يتداخل مع WebSockets.
إن ظل يفشل
- شبكة شركة تحجب المنفذ 2083. جرّب اتصالًا آخر.
- إضافة متصفح تتداخل. اختبر في نافذة خاصة مع تعطيل الإضافات.
- وصول الصدفة غير مفعَّل على الحساب. فالطرفية تتطلّبه — راجع الاتصال عبر SSH.
أو استخدم SSH ببساطة
الطرفية مريحة لكنها محدودة — فلا تكامل مع الحافظة، وتنتهي الجلسة بانتهاء الصفحة. ولأي شيء كبير، اتصل عبر SSH من جهازك بدلًا منها: الاتصال عبر SSH.