استكشاف الأخطاء وإصلاحها
تغطي هذه الصفحة حلولًا للمشاكل الشائعة مرتبة حسب الفئة.
مشاكل الاتصال
العميل لا يمكنه العثور على الخادم
الأعراض: يظهر للعميل "البحث عن الخادم" أو "لم يتم العثور على خادم".
الحلول:
- تحقق من أن HandyCafe Server يعمل على جهاز الكمبيوتر الإداري.
- تأكد من أن كلا الجهازين على نفس الشبكة الفرعية (مثلًا، كلاهما على 192.168.1.x).
- تحقق من أن mDNS غير محظور بواسطة مفتاح الشبكة أو الموجه.
- جرب الاتصال اليدوي: أدخل عنوان IP للخادم مباشرة في إعدادات العميل.
- تحقق من عدم استخدام أي برنامج آخر لمنفذ TCP الخاص بالخادم (الافتراضي: 5001).
العميل يتصل ثم ينقطع فورًا
الأعراض: يظهر للعميل لفترة وجيزة "متصل" ثم يعود إلى "البحث".
الحلول:
- تحقق من أن مفتاح الاتصال متطابق على كل من الخادم والعميل. يتم تعيين المفتاح في الإعدادات > الشبكة على الخادم.
- تحقق من استقرار الشبكة (فقدان الحزم، مشاكل الكابلات).
- تأكد من أن الخادم لم يصل إلى الحد الأقصى لأجهزة الكمبيوتر المرخصة.
- راجع سجلات الخادم للرسائل الفاشلة في المصادقة.
العميل يظهر "غير متصل" على الخادم لكن الكمبيوتر يعمل
الأعراض: جهاز الكمبيوتر العميل قيد التشغيل وتطبيق العميل يعمل لكن الخادم يظهره كغير متصل.
الحلول:
- على جهاز الكمبيوتر العميل، تحقق من أن HandyCafe Client يعمل بالفعل (تحقق من علبة النظام).
- تحقق من اتصال الشبكة على جهاز الكمبيوتر العميل (هل يمكنه إرسال ping إلى الخادم؟).
- تحقق من قواعد الجدار الناري: يجب فتح منافذ TCP 5001-5003 على كل من الخادم والعميل.
- أعد تشغيل HandyCafe Client على الكمبيوتر المتأثر.
- إذا كنت تستخدم VLANs، تأكد من أن VLANs الخادم والعميل يمكنها التواصل.
لا يمكن الاتصال بعد تغيير إعدادات الشبكة
الأعراض: بعد تغيير المنافذ أو مفتاح الاتصال، لا يمكن للعملاء الاتصال.
الحلول:
- تأكد من تحديث العملاء بأرقام المنافذ الجديدة ومفتاح الاتصال.
- أعد تشغيل HandyCafe Server بعد تغيير إعدادات الشبكة.
- قم بتحديث قواعد الجدار الناري للسماح بالمنافذ الجديدة.
- يجب إعادة تكوين جميع العملاء بالقيم الجديدة.
مشاكل الجلسات
لا يمكن بدء جلسة على العميل
الأعراض: زر البدء معطل أو فشل إجراء البدء مع خطأ.
الحلول:
- تحقق من حالة الترخيص. إذا كان في وضع القراءة فقط، لا يمكن بدء جلسات جديدة.
- تأكد من أن حالة العميل هي "خامل". يمكن بدء الجلسات فقط على العملاء الخاملين.
- تحقق من أذونات الكاشير. يجب أن يكون للدور إذن AUTH_CLIENT_LOGIN.
- تأكد من تكوين التسعير (يجب أن يحتوي الإعدادات > التسعير على سعر ساعي صالح).
مؤقت الجلسة يظهر وقتًا غير صحيح
الأعراض: الوقت المعروض لا يتطابق مع الوقت الفعلي المنقضي.
الحلول:
- تحقق من ساعات النظام على كل من أجهزة الكمبيوتر الخادم والعميل. يجب أن تكون متزامنة (استخدم NTP).
- إذا كانت الجلسة متوقفة مؤقتًا، فإن مدة التوقف المؤقت لا تُحسب.
- بالنسبة للجلسات المدفوعة مسبقًا، يظهر المؤقت الوقت المتبقي، وليس الوقت المنقضي.
تكلفة الجلسة تبدو خاطئة
الأعراض: المبلغ المحمل لا يتطابق مع التوقعات.
الحلول:
- تحقق من جدول التسعير. إذا كان ممكّنًا، قد تكون الجلسة قد مرت عبر عدة فترات تسعير بمضاعفات مختلفة.
- راجع إعدادات التسعير: السعر الأساسي للساعة، ضريبة القيمة المضافة، رسوم البدء، التقريب.
- تحقق من تفاصيل التسعير للجلسة في تفاصيل المعاملة للحصول على تفصيل.
- تحقق من عمولة وطريقة الدفع والرسوم الثابتة.
- بالنسبة للجلسات المدفوعة مسبقًا، تحقق مما إذا كان وضع "القفل عند الشراء" أو "الجدول الزمني المباشر" نشطًا.
لا يمكن استئناف الجلسة المتوقفة
الأعراض: فشل إجراء الاستئناف أو غير متاح.
الحلول:
- تحقق من أن جهاز الكمبيوتر العميل لا يزال متصلًا بالخادم.
- تحقق من أن حالة العميل تظهر "متوقف" (برتقالي).
- إذا انقطع اتصال العميل أثناء التوقف، قد يحتاج إلى إعادة الاتصال أولًا.
مشاكل الدفع
طريقة الدفع مفقودة من القائمة المنسدلة
الأعراض: لا تظهر طريقة الدفع المتوقعة عند إغلاق جلسة أو طلب.
الحلول:
- تحقق من وجود طريقة الدفع في الإدارة > طرق الدفع.
- تحقق من أن طريقة الدفع نشطة (غير محذوفة أو معطلة).
- تحقق من أذونات الكاشير. يجب منح PAYMENT_MANAGE لرؤية جميع الطرق.
حساب العمولة يبدو غير صحيح
الأعراض: العمولة المخصومة لا تتطابق مع النسبة المتوقعة.
الحلول:
- تحقق من نسبة العمولة لطريقة الدفع (كنسبة مئوية) والرسوم الثابتة.
- صيغة العمولة: العمولة = (المبلغ المحمل * نسبة العمولة / 100) + الرسوم الثابتة.
- تحقق مما إذا كان الكاشير قد طبق تجاوزًا يدويًا للمبلغ المحمل.
مشاكل عرض العميل
شاشة الخمول للعميل فارغة
الأعراض: تظهر شاشة الخمول لا شيء بدلاً من عرض الشرائح المكون.
الحلول:
- تحقق من تمكين شاشة الخمول في الإعدادات > العملاء > شاشة الخمول.
- تحقق من إضافة عنصر وسائط واحد على الأقل (صورة أو فيديو).
- تحقق من أن ملفات الوسائط صالحة وغير تالفة.
- قم بتفعيل المزامنة لدفع أحدث الإعدادات إلى العميل.
قائمة العميل لا تظهر التطبيقات
الأعراض: مشغل التطبيقات فارغ أو يفتقد الفئات.
الحلول:
- تحقق من تكوين التطبيقات والفئات في الإعدادات > العملاء > المحتوى.
- تحقق من أن الفئات والتطبيقات قد تم تفعيل رؤيتها.
- تحقق من أن العميل قد استلم أحدث بيانات القائمة (التغييرات تُدفع تلقائيًا عبر TCP).
- أعد تشغيل العميل إذا لم يتم تطبيق المزامنة في الوقت الفعلي.
لم يتم تطبيق مظهر العميل
الأعراض: يظهر العميل المظهر الافتراضي بدلاً من المظهر المكون.
الحلول:
- تحقق من حفظ إعدادات المظهر في الإعدادات > العملاء > المظهر.
- قم بتفعيل دفع الإعدادات للعملاء.
- أعد تشغيل تطبيق العميل.
مشاكل سطح المكتب البعيد
سطح المكتب البعيد بطيء أو متقطع
الأعراض: تأخر في عرض الفيديو، تقطع، أو معدل إطارات منخفض.
الحلول:
- خفض معدل البت (جرب 1000-2000 كيلوبت في الثانية للاستخدام القياسي للشبكة المحلية).
- قلل إعداد FPS.
- استخدم إيثرنت سلكي بدلاً من WiFi.
- تحقق من ازدحام الشبكة أو الاستخدام العالي للنطاق الترددي من التطبيقات الأخرى.
- تأكد من أن منفذ UDP 5004 غير محظور أو محدود.
سطح المكتب البعيد يظهر شاشة سوداء
الأعراض: نافذة سطح المكتب البعيد تفتح ولكن تظهر فقط باللون الأسود.
الحلول:
- تحقق من أن العميل متصل وقابل للاستجابة (حاول التقاط لقطة شاشة أولاً).
- تحقق من أن منفذ UDP 5004 مفتوح في كلا الاتجاهين.
- قد يحتاج برنامج تشغيل الرسومات للعميل إلى تحديث.
- حاول طلب تحديث إطار رئيسي.
لا يمكن التحكم في الماوس أو لوحة المفاتيح عن بُعد
الأعراض: يمكنك رؤية الشاشة البعيدة ولكن النقرات وضربات المفاتيح ليس لها تأثير.
الحلول:
- تحقق من أن منفذ الإدارة عن بُعد (TCP 5003) مفتوح.
- تحقق من أن تطبيق العميل لديه الأذونات النظامية المناسبة.
- قد تمنع بعض الألعاب بملء الشاشة الإدخال عن بُعد.
مشاكل الترخيص
الترخيص يظهر "offline_grace"
الأعراض: حالة الترخيص تظهر offline_grace مع عد تنازلي.
الحلول:
- استعادة الاتصال بالإنترنت على جهاز الكمبيوتر الخادم.
- تحقق من حل DNS. يجب أن يصل الخادم إلى خادم الترخيص.
- تحقق من عدم حظر الوكيل أو الجدار الناري للاتصالات الصادرة عبر HTTPS.
- لديك 72 ساعة لاستعادة الاتصال قبل أن يتم قفل الخادم.
الترخيص يظهر "over_limit"
الأعراض: عدد العملاء المتصلين أكثر مما يسمح به الترخيص.
الحلول:
- افصل العملاء الخاملين الذين لا يتم استخدامهم.
- تحقق من عدد العملاء الحالي مقابل حد الترخيص الخاص بك.
- قم بترقية ترخيصك لزيادة سعة أجهزة الكمبيوتر.
- ملاحظة: تُحسب وحدات التحكم ضمن الحد الإجمالي لأجهزة الكمبيوتر.
الترخيص يظهر "expired" أو "revoked"
الأعراض: يدخل الخادم في وضع مقيد.
الحلول:
- تحقق من تاريخ انتهاء صلاحية الترخيص الخاص بك.
- جدد ترخيصك عبر موقع HandyCafe.
- بالنسبة للتراخيص الملغاة، اتصل بدعم HandyCafe.
مشاكل عامة
لا يتم حفظ تغييرات الإعدادات
الأعراض: تعود التغييرات بعد الانتقال بعيدًا عن الإعدادات.
الحلول:
- تأكد من النقر على زر حفظ بعد إجراء التغييرات.
- تحقق من وجود أخطاء في التحقق (الحقول المظللة برسائل الخطأ).
- تحقق من أن لديك أذونات المسؤول.
سجلات التدقيق تفتقد إلى الإدخالات
الأعراض: لا تظهر الإجراءات المتوقعة في صفحة السجلات.
الحلول:
- تحقق من عوامل تصفية السجل. تأكد من تحديد الفئة ونطاق التاريخ الصحيحين.
- تحقق من منح إذن LOG_DISPLAY_FULL (وإلا ستظهر سجلات اليوم فقط).
- ابحث باستخدام حقل البحث النصي عن الإجراء المحدد.