البدء السريع: مسؤول تقنية المعلومات

يغطي هذا الدليل الإعداد التقني لـ HandyCafe. بنهايته سيكون لديك الخادم والعملاء مثبتين والشبكة مُعدّة وقوائم التطبيقات مبنية والإدارة عن بُعد مختبرة.

الوقت اللازم للإكمال: 5 دقائق (بالإضافة إلى وقت نشر العملاء)

الخطوة 1: تثبيت الخادم والعملاء

تثبيت الخادم:

1. تحقق من أن جهاز الخادم يستوفي متطلبات النظام.
2. حمّل وثبّت خادم HandyCafe على جهاز الإدارة.
3. شغّل الخادم وأكمل معالج الإعداد الأولي لإنشاء حساب المسؤول.
4. سجّل عنوان IP المحلي لجهاز الخادم. سيحتاجه العملاء للاتصال.

تثبيت العميل (كرر لكل جهاز):

1. حمّل HandyCafe Client على كل جهاز مخصص للزبائن.
2. ثبّت وشغّل العميل.
3. يبحث العميل عن الخادم على الشبكة المحلية باستخدام اكتشاف mDNS.
4. إذا لم يُعثر على الخادم تلقائيًا أدخل عنوان IP الخادم يدويًا في إعدادات العميل.
5. بمجرد الاتصال يظهر العميل في لوحة الإدارة بالخادم.

نصيحة: استخدم ميزة التسمية التلقائية للخادم (الإعدادات > العملاء) لتسمية العملاء تلقائيًا ببادئة مثل "PC #1" و"PC #2" وهكذا. يمكنك تخصيص أسماء العرض لاحقًا.

راجع تثبيت الخادم وتثبيت العميل للخطوات التفصيلية.

الخطوة 2: إعداد إعدادات الشبكة

انتقل إلى الإعدادات > الشبكة على الخادم.

يستخدم HandyCafe أربعة منافذ للاتصال:

الإعداد:

1. اضبط المنافذ (الافتراضيات تعمل لمعظم الإعدادات).
2. اضبط مفتاح الاتصال. هذا سر مشترك يُستخدم لمصادقة HMAC-SHA256. يجب أن يستخدم جميع العملاء نفس المفتاح.
3. انقر على حفظ.

قواعد جدار الحماية:

تأكد من فتح هذه المنافذ على كلٍّ من الخادم وأجهزة العملاء:

• TCP: 5001 و5002 و5003 (واردة على الخادم وصادرة على العملاء)
• UDP: 5004 (ثنائي الاتجاه لبث الشاشة)

مهم: يجب أن تكون جميع الأجهزة على نفس الشبكة المحلية (الشبكة الفرعية). يستخدم HandyCafe اكتشاف mDNS للعملاء الذي يتطلب اتصال الشبكة المحلية.

راجع إعدادات الشبكة لجميع خيارات الشبكة.

الخطوة 3: إعداد قائمة العميل

قائمة العميل هي مُشغّل التطبيقات الذي يراه الزبائن على سطح مكتبهم. انتقل إلى الإعدادات > العملاء > تبويب المحتوى.

1. أنشئ فئات. جمّع التطبيقات حسب النوع (مثلًا ألعاب ومتصفحات وشبكات اجتماعية وأدوات).
2. أضف تطبيقات لكل فئة:
   • حدد اسم التطبيق والوصف.
   • اختر نوع التطبيق: لعبة أو متصفح أو رابط أو ملف أو تطبيق.
   • حدد مسار الملف التنفيذي أو عنوان التشغيل.
   • ارفع أيقونة واختياريًا صورة ملصق لبطاقة التطبيق.
3. أعد ترتيب الفئات والتطبيقات باستخدام مقابض السحب.
4. بدّل الظهور لإظهار أو إخفاء العناصر.
5. انقر على حفظ.

تُدفع التغييرات إلى جميع العملاء المتصلين تلقائيًا وفوريًا عبر TCP.

نصيحة: استخدم تكامل IGDB للبحث عن بيانات الألعاب الوصفية والأيقونات تلقائيًا.

راجع قائمة العميل للوثائق الكاملة لبناء القائمة.

الخطوة 4: إعداد شاشة الخمول والمظهر

شاشة الخمول (الإعدادات > العملاء > تبويب شاشة الخمول):

شاشة الخمول هي ما يراه الزبائن عندما لا تكون هناك جلسة نشطة (شاشة القفل).

1. فعّل عرض شرائح شاشة الخمول.
2. أضف صورًا أو فيديوهات (PNG وJPG وWebP وGIF وMP4 وWebM).
3. اضبط المدة لكل عنصر وتأثير الانتقال (تلاشي أو انزلاق أو تكبير).
4. اختياريًا فعّل تراكب الساعة وعرض اسم المقهى بألوان مخصصة.
5. انقر على حفظ.

المظهر (الإعدادات > العملاء > تبويب المظهر):

اضبط مظهر سطح المكتب المتصل الذي يستخدمه الزبائن خلال الجلسات.

1. اختر سمة: Neon Arena أو Crimson Pulse أو Emerald Depth.
2. اختر قالب تخطيط: Split Classic أو Hero Wide Top أو Catalog Wide Bottom أو Compact Focus.
3. اضبط الخلفية: لون ثابت أو تدرج أو صورة أو فيديو مع إعدادات التراكب والضبابية.
4. عدّل كثافة البطاقات (كبير أو متوسط أو مدمج) وتأثيرات التمرير.
5. انقر على حفظ.

راجع شاشة الخمول للعميل ومظهر العميل لجميع الخيارات.

الخطوة 5: اختبار سطح المكتب البعيد ولقطات الشاشة

تحقق من عمل الإدارة عن بُعد:

لقطات الشاشة:

1. في لوحة الإدارة حدد أي بطاقة عميل متصل.
2. انقر على لقطة شاشة في بطاقة العميل.
3. تظهر لقطة شاشة العميل في العارض.
4. يمكنك تحميل أو تحديث لقطة الشاشة.

سطح المكتب البعيد:

1. حدد بطاقة عميل متصل وانقر على سطح المكتب البعيد.
2. تُفتح نافذة سطح مكتب بعيد ببث مباشر H.264.
3. يمكنك التحكم بالفأرة ولوحة المفاتيح على الجهاز البعيد.
4. تعمل مزامنة الحافظة بين الخادم والعميل.

ملاحظة: يستخدم سطح المكتب البعيد بث UDP. إذا كان الفيديو بطيئًا تحقق من عرض النطاق الترددي وتأكد من عدم حجب منفذ UDP 5004. يمكنك أيضًا تعديل معدل البت في إعدادات البث (350-25,000 كيلوبت/ثانية).

راجع سطح المكتب البعيد ولقطات الشاشة لجميع ميزات التحكم عن بُعد.

نظرة عامة على بنية الشبكة

جهاز الخادم (الإدارة)
    |
    |--- TCP (5001) --- الأوامر/الاستجابات (bincode + HMAC-SHA256)
    |--- TCP (5002) --- نقل الملفات
    |--- TCP (5003) --- التحكم بالإدارة عن بُعد
    |--- UDP (5004) --- بث الشاشة (H.264)
    |--- mDNS ------- اكتشاف العملاء (تلقائي)
    |
    +-- جهاز عميل 1
    +-- جهاز عميل 2
    +-- جهاز عميل 3
    +-- ...

ما الخطوة التالية

• مزامنة الملفات: نشر الملفات والإعدادات على أجهزة العملاء
• مراقبة الشبكة: مراقبة عرض النطاق وحالة الاتصال
• تراخيص البرامج: تتبع تراخيص البرامج المتزامنة عبر الأجهزة
• تسجيل دخول OAuth: إعداد تسجيل الدخول الاجتماعي للزبائن