HandyCafe Docs
it-admin

شروع کار: مدیر فنی

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

زمان تقریبی: ۵ دقیقه (به‌علاوه زمان استقرار کلاینت‌ها)

مرحله ۱: نصب سرور و کلاینت‌ها

نصب سرور:

  1. مطمئن شوید رایانه سرور نیازمندی‌های سیستم را برآورده می‌کند.
  2. HandyCafe Server را روی رایانه مدیریت خود دانلود و نصب کنید.
  3. سرور را اجرا کنید و جادوگر راه‌اندازی اولیه را برای ایجاد حساب مدیر تکمیل کنید.
  4. آدرس IP محلی رایانه سرور را یادداشت کنید. کلاینت‌ها برای اتصال به آن نیاز دارند.

نصب کلاینت (برای هر رایانه تکرار کنید):

  1. HandyCafe Client را روی هر رایانه مشتری دانلود کنید.
  2. نصب و اجرا کنید.
  3. کلاینت با استفاده از کشف mDNS به دنبال سرور در شبکه محلی می‌گردد.
  4. اگر سرور به‌صورت خودکار پیدا نشد، آدرس IP سرور را به‌صورت دستی در تنظیمات کلاینت وارد کنید.
  5. پس از اتصال، کلاینت در پنل مدیر سرور ظاهر می‌شود.

نکته: از قابلیت نام‌گذاری خودکار سرور (تنظیمات > کلاینت‌ها) استفاده کنید تا کلاینت‌ها به‌صورت خودکار با پیشوندی مانند "PC #1"، "PC #2" و غیره نام‌گذاری شوند. بعدا می‌توانید نام‌های نمایشی را سفارشی کنید.

برای مراحل دقیق، نصب سرور و نصب کلاینت را مشاهده کنید.

مرحله ۲: پیکربندی تنظیمات شبکه

در سرور به تنظیمات > شبکه بروید.

HandyCafe از چهار پورت برای ارتباط استفاده می‌کند:

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

پیکربندی:

  1. پورت‌ها را تنظیم کنید (پیش‌فرض‌ها برای بیشتر تنظیمات مناسب هستند).
  2. کلید اتصال را تنظیم کنید. این یک رمز مشترک برای احراز هویت HMAC-SHA256 است. تمام کلاینت‌ها باید از همان کلید استفاده کنند.
  3. روی ذخیره کلیک کنید.

قوانین فایروال:

مطمئن شوید این پورت‌ها روی سرور و رایانه‌های کلاینت باز هستند:

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

مهم: تمام رایانه‌ها باید در یک شبکه محلی (زیرشبکه) باشند. HandyCafe از mDNS برای کشف کلاینت‌ها استفاده می‌کند که نیازمند اتصال شبکه محلی است.

برای تمام گزینه‌های شبکه، تنظیمات شبکه را مشاهده کنید.

مرحله ۳: راه‌اندازی منوی کلاینت

منوی کلاینت لانچر برنامه‌ای است که مشتریان روی دسکتاپ خود می‌بینند. به تنظیمات > کلاینت‌ها > تب محتوا بروید.

  1. دسته‌بندی‌ها ایجاد کنید. برنامه‌ها را بر اساس نوع گروه‌بندی کنید (مثلا بازی‌ها، مرورگرها، شبکه‌های اجتماعی، ابزارها).
  2. برنامه‌ها را اضافه کنید به هر دسته‌بندی:
    • نام برنامه و توضیحات را تنظیم کنید.
    • نوع برنامه را انتخاب کنید: بازی، مرورگر، لینک، فایل یا برنامه.
    • مسیر اجرایی یا URI اجرا را تنظیم کنید.
    • یک آیکون و به‌صورت اختیاری یک تصویر پوستر برای کارت برنامه آپلود کنید.
  3. ترتیب دسته‌بندی‌ها و برنامه‌ها را با کشیدن تغییر دهید.
  4. نمایش آیتم‌ها را با کلید فعال/غیرفعال تنظیم کنید.
  5. روی ذخیره کلیک کنید.

تغییرات به‌صورت خودکار و بلادرنگ از طریق TCP به تمام کلاینت‌های متصل ارسال می‌شوند.

نکته: از ادغام IGDB برای جستجوی خودکار فراداده و آیکون بازی‌ها استفاده کنید.

برای مستندات کامل سازنده منو، منوی کلاینت را مشاهده کنید.

مرحله ۴: پیکربندی صفحه بیکار و ظاهر

صفحه بیکار (تنظیمات > کلاینت‌ها > تب صفحه بیکار):

صفحه بیکار چیزی است که مشتریان هنگام نبود نشست فعال (صفحه قفل) مشاهده می‌کنند.

  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. روی ذخیره کلیک کنید.

برای تمام گزینه‌ها، صفحه بیکار کلاینت و ظاهر کلاینت را مشاهده کنید.

مرحله ۵: تست دسکتاپ از راه دور و تصاویر صفحه

عملکرد مدیریت از راه دور را تایید کنید:

تصاویر صفحه:

  1. در پنل مدیر، هر کارت کلاینت آنلاین را انتخاب کنید.
  2. روی تصویر صفحه روی کارت کلاینت کلیک کنید.
  3. تصویر صفحه کلاینت در نمایشگر ظاهر می‌شود.
  4. می‌توانید تصویر را دانلود یا به‌روزرسانی کنید.

دسکتاپ از راه دور:

  1. یک کارت کلاینت آنلاین را انتخاب کنید و روی دسکتاپ از راه دور کلیک کنید.
  2. پنجره دسکتاپ از راه دور با جریان زنده H.264 باز می‌شود.
  3. می‌توانید ماوس و صفحه‌کلید رایانه از راه دور را کنترل کنید.
  4. همگام‌سازی کلیپ‌بورد بین سرور و کلاینت کار می‌کند.

توجه: دسکتاپ از راه دور از جریان UDP استفاده می‌کند. اگر ویدیو با تاخیر نمایش داده می‌شود، پهنای باند شبکه را بررسی کنید و مطمئن شوید پورت UDP 5004 مسدود نیست. همچنین می‌توانید نرخ بیت را در تنظیمات جریان تنظیم کنید (۳۵۰ تا ۲۵,۰۰۰ کیلوبیت بر ثانیه).

برای تمام قابلیت‌های از راه دور، دسکتاپ از راه دور و تصاویر صفحه را مشاهده کنید.


نمای کلی معماری شبکه

رایانه سرور (مدیریت)
    |
    |--- TCP (5001) --- فرمان/پاسخ (bincode + HMAC-SHA256)
    |--- TCP (5002) --- انتقال فایل
    |--- TCP (5003) --- کنترل مدیریت از راه دور
    |--- UDP (5004) --- جریان صفحه (H.264)
    |--- mDNS ------- کشف کلاینت (خودکار)
    |
    +-- رایانه کلاینت ۱
    +-- رایانه کلاینت ۲
    +-- رایانه کلاینت ۳
    +-- ...

مراحل بعدی