متطلبات النظام
قبل تثبيت HandyCafe في مقهى الإنترنت أو مركز الألعاب أو ساحة الرياضات الإلكترونية تحقق من أن أجهزتك وشبكتك تستوفي المتطلبات التالية.
متطلبات جهاز الخادم
الخادم هو محطة الإدارة. هذا الجهاز الذي تُشغّل عليه خادم HandyCafe لمراقبة المقهى بأكمله والتحكم فيه.
| المكوّن | الحد الأدنى | الموصى به |
|---|---|---|
| نظام التشغيل | Windows 10+ (64-bit) أو macOS 12 Monterey+ أو Linux (64-bit) | Windows 10/11 (64-bit) أو macOS 12+ أو Linux (64-bit) |
| المعالج | ثنائي النواة 2.0 GHz | رباعي النواة 2.5 GHz+ |
| الذاكرة | 4 GB | 8 GB+ |
| مساحة القرص | 500 MB (التطبيق) | 2 GB+ (مع التسجيلات ولقطات الشاشة) |
| العرض | 1280 x 720 | 1920 x 1080+ |
| الشبكة | 100 Mbps Ethernet | Gigabit Ethernet |
ملاحظة: إذا استخدمت سطح المكتب عن بُعد مع تسجيل الجلسات خصص مساحة قرص إضافية لتسجيلات MP4 (حوالي 50-200 MB لكل ساعة تسجيل حسب الجودة).
ملاحظة Linux: HandyCafe مبني بـ Tauri v2 الذي يستخدم WebKit2GTK على Linux. يجب تثبيت حزمة
libwebkit2gtk-4.1قبل تشغيل التطبيق. التوزيعات المدعومة تشمل Ubuntu 22.04+ وFedora 38+ والتوزيعات الأخرى التي توفر إصدارًا مكافئًا من WebKit2GTK.
متطلبات جهاز العميل
كل جهاز مُوجّه للعملاء يُشغّل عميل HandyCafe الذي يتصل بالخادم عبر الشبكة المحلية.
| المكوّن | الحد الأدنى | الموصى به |
|---|---|---|
| نظام التشغيل | Windows 10+ (64-bit) أو macOS 12 Monterey+ أو Linux (64-bit) | Windows 10/11 (64-bit) أو macOS 12+ أو Linux (64-bit) |
| المعالج | ثنائي النواة 1.5 GHz | رباعي النواة 2.0 GHz+ |
| الذاكرة | 2 GB | 4 GB+ |
| مساحة القرص | 200 MB | 500 MB+ |
| الشبكة | 100 Mbps Ethernet | Gigabit Ethernet |
ملاحظة: هذه متطلبات برنامج عميل HandyCafe فقط. ستحتاج أجهزتك لموارد إضافية للألعاب والتطبيقات التي يستخدمها عملاؤك.
متطلبات الشبكة
يجب أن تكون جميع الأجهزة (الخادم والعملاء) على نفس الشبكة المحلية (LAN).
المنافذ المطلوبة
| المنفذ | البروتوكول | الاتجاه | الغرض |
|---|---|---|---|
| 5001 | TCP | الخادم: وارد، العميل: صادر | اتصال الأوامر والاستجابات |
| 5002 | TCP | ثنائي الاتجاه | نقل الملفات |
| 5003 | TCP | الخادم: وارد، العميل: صادر | قناة التحكم بالإدارة عن بُعد |
| 5004 | UDP | ثنائي الاتجاه | بث الشاشة (سطح المكتب عن بُعد) |
مهم: هذه المنافذ الافتراضية. يمكنك تغييرها في إعدادات الشبكة. إذا غيّرت المنافذ على الخادم حدّث تكوين العميل ليتطابق.
تكوين جدار الحماية
- جدار حماية Windows: يحاول HandyCafe إضافة قواعد جدار الحماية تلقائيًا أثناء التثبيت. إذا فشل التكوين التلقائي أضف قواعد واردة يدويًا للمنافذ المذكورة أعلاه.
- جدار حماية macOS: افتح إعدادات النظام > الشبكة > جدار الحماية واسمح بالاتصالات الواردة لـ HandyCafe.
- Linux (iptables / ufw): إذا كنت تستخدم
ufwشغّلsudo ufw allow 5001:5004/tcpوsudo ufw allow 5004/udp. - جدران حماية خارجية: أضف استثناءات لملف خادم HandyCafe على جهاز الخادم وملف عميل HandyCafe على أجهزة العملاء.
- جهاز التوجيه/المحوّل: لا حاجة لتكوين خاص للتشغيل على الشبكة المحلية فقط. إذا كان لديك VLANs تأكد من أن الخادم وجميع العملاء على نفس VLAN أو أن التوجيه يسمح بالمنافذ المطلوبة.
اكتشاف العملاء
يستخدم HandyCafe mDNS (نظام أسماء النطاقات متعدد البث) لاكتشاف العملاء تلقائيًا على الشبكة المحلية. يتطلب ذلك:
- جميع الأجهزة على نفس الشبكة الفرعية
- حركة البث المتعدد غير محظورة من المحوّلات أو أجهزة التوجيه
- إذا لم يعمل mDNS (مثلًا عبر شبكات فرعية) يمكن للعملاء الاتصال بإدخال عنوان IP الخادم يدويًا
اعتبارات عرض النطاق
| الميزة | عرض النطاق التقريبي |
|---|---|
| التشغيل العادي (لكل عميل) | < 1 Kbps |
| بث سطح المكتب عن بُعد | 350 - 25,000 Kbps (قابل للتكوين) |
| نقل مزامنة الملفات | محدود بسرعة الشبكة |
| التقاط لقطة شاشة | ~100 KB لكل لقطة |
لمقهى نموذجي يضم 20-50 جهازًا تكفي شبكة LAN بسرعة 100 Mbps. يُوصى بـ Gigabit Ethernet إذا كنت تستخدم سطح المكتب عن بُعد لعدة أجهزة بشكل متزامن بشكل متكرر.
متطلبات وحدات التحكم
إذا كنت تُدير وحدات تحكم ألعاب (PlayStation وXbox وغيرها) يجب أن تكون على نفس الشبكة مع الخادم. تُعرّف كل وحدة تحكم بعنوان MAC وتُسجّل يدويًا في إعدادات وحدات التحكم.