HandyCafe Docs
owner it-admin

نیازمندی‌های سیستم

قبل از نصب HandyCafe در کافی‌نت، گیمینگ سنتر یا سالن ایسپورتس خود، مطمئن شوید سخت‌افزار و شبکه شما نیازمندی‌های زیر را برآورده می‌کنند.

نیازمندی‌های رایانه سرور

سرور ایستگاه مدیریت شماست. این رایانه‌ای است که HandyCafe Server را برای نظارت و کنترل کل کافه روی آن اجرا می‌کنید.

مولفه حداقل پیشنهادی
سیستم‌عامل Windows 10+ (64 بیتی)، macOS 12 Monterey+ یا Linux (64 بیتی) Windows 10/11 (64 بیتی)، macOS 12+ یا Linux (64 بیتی)
پردازنده دو هسته‌ای 2.0 گیگاهرتز چهار هسته‌ای 2.5 گیگاهرتز+
حافظه رم 4 گیگابایت 8 گیگابایت+
فضای دیسک 500 مگابایت (برنامه) 2 گیگابایت+ (با ضبط و تصاویر صفحه)
نمایشگر 1280 x 720 1920 x 1080+
شبکه Ethernet 100 مگابیت Gigabit Ethernet

توجه: اگر از دسکتاپ از راه دور با ضبط نشست استفاده می‌کنید، فضای دیسک اضافی برای ضبط‌های MP4 اختصاص دهید (تقریبا 50 تا 200 مگابایت به ازای هر ساعت ضبط بسته به کیفیت).

توجه برای Linux: HandyCafe با Tauri v2 ساخته شده که در Linux از WebKit2GTK استفاده می‌کند. باید بسته libwebkit2gtk-4.1 را قبل از اجرای برنامه نصب کنید. توزیع‌های پشتیبانی‌شده شامل Ubuntu 22.04+، Fedora 38+ و سایر توزیع‌هایی هستند که نسخه معادل WebKit2GTK را ارائه می‌دهند.

نیازمندی‌های رایانه کلاینت

هر رایانه مشتری HandyCafe Client را اجرا می‌کند که از طریق شبکه محلی به سرور متصل می‌شود.

مولفه حداقل پیشنهادی
سیستم‌عامل Windows 10+ (64 بیتی)، macOS 12 Monterey+ یا Linux (64 بیتی) Windows 10/11 (64 بیتی)، macOS 12+ یا Linux (64 بیتی)
پردازنده دو هسته‌ای 1.5 گیگاهرتز چهار هسته‌ای 2.0 گیگاهرتز+
حافظه رم 2 گیگابایت 4 گیگابایت+
فضای دیسک 200 مگابایت 500 مگابایت+
شبکه Ethernet 100 مگابیت Gigabit Ethernet

توجه: اینها نیازمندی‌های نرم‌افزار HandyCafe Client هستند. رایانه‌های شما برای بازی‌ها و برنامه‌هایی که مشتریان استفاده می‌کنند به منابع اضافی نیاز دارند.

نیازمندی‌های شبکه

تمام رایانه‌ها (سرور و کلاینت‌ها) باید در یک شبکه محلی (LAN) باشند.

پورت‌های مورد نیاز

پورت پروتکل جهت کاربرد
5001 TCP سرور: ورودی، کلاینت: خروجی ارتباط فرمان و پاسخ
5002 TCP دوطرفه انتقال فایل
5003 TCP سرور: ورودی، کلاینت: خروجی کانال کنترل مدیریت از راه دور
5004 UDP دوطرفه جریان صفحه (دسکتاپ از راه دور)

مهم: اینها پورت‌های پیش‌فرض هستند. می‌توانید آنها را در تنظیمات شبکه تغییر دهید. اگر پورت‌ها را روی سرور تغییر دهید، پیکربندی کلاینت را نیز به‌روزرسانی کنید.

پیکربندی فایروال

  • فایروال ویندوز: HandyCafe سعی می‌کند هنگام نصب قوانین فایروال را به‌صورت خودکار اضافه کند. اگر پیکربندی خودکار انجام نشد، قوانین ورودی را برای پورت‌های بالا به‌صورت دستی اضافه کنید.
  • فایروال macOS: به System Settings > Network > Firewall بروید و اتصالات ورودی HandyCafe را مجاز کنید. یا پورت‌های بالا را به فهرست مجاز فایروال اضافه کنید.
  • Linux (iptables / ufw): اگر از ufw استفاده می‌کنید، دستور sudo ufw allow 5001:5004/tcp و sudo ufw allow 5004/udp را اجرا کنید. برای iptables خام، قوانین INPUT ACCEPT معادل برای پورت‌های TCP 5001-5003 و UDP 5004 اضافه کنید.
  • فایروال‌های شخص ثالث: استثنا برای باینری سرور HandyCafe روی رایانه سرور و باینری کلاینت HandyCafe روی رایانه‌های کلاینت اضافه کنید.
  • روتر/سوییچ: برای عملکرد فقط شبکه محلی پیکربندی خاصی لازم نیست. اگر VLAN دارید، مطمئن شوید سرور و تمام کلاینت‌ها در یک VLAN هستند یا مسیریابی پورت‌های لازم را مجاز کرده است.

کشف کلاینت

HandyCafe از mDNS (DNS چندپخشی) برای کشف خودکار کلاینت‌ها در شبکه محلی استفاده می‌کند. این نیازمند:

  • قرار داشتن تمام رایانه‌ها در یک زیرشبکه
  • مسدود نبودن ترافیک چندپخشی توسط سوییچ یا روتر
  • اگر mDNS کار نکرد (مثلا بین زیرشبکه‌ها)، کلاینت‌ها می‌توانند با وارد کردن آدرس IP سرور به‌صورت دستی متصل شوند

ملاحظات پهنای باند

قابلیت پهنای باند تقریبی
عملکرد عادی (به ازای هر کلاینت) کمتر از ۱ کیلوبیت بر ثانیه
جریان دسکتاپ از راه دور ۳۵۰ تا ۲۵,۰۰۰ کیلوبیت بر ثانیه (قابل تنظیم)
انتقال همگام‌سازی فایل محدود به سرعت شبکه
گرفتن تصویر صفحه حدود ۱۰۰ کیلوبایت به ازای هر تصویر

برای کافه‌ای با ۲۰ تا ۵۰ رایانه، یک شبکه محلی ۱۰۰ مگابیت استاندارد کافی است. اگر به‌صورت مکرر از دسکتاپ از راه دور برای چندین رایانه هم‌زمان استفاده می‌کنید، Gigabit Ethernet پیشنهاد می‌شود.

نیازمندی‌های کنسول

اگر کنسول‌های بازی (PlayStation، Xbox و غیره) را مدیریت می‌کنید، کنسول‌ها باید در همان شبکه سرور باشند. هر کنسول با آدرس MAC خود شناسایی شده و به‌صورت دستی در تنظیمات کنسول ثبت می‌شود.