HandyCafe Docs
owner cashier it-admin

عیب‌یابی

این صفحه راه‌حل‌هایی برای مشکلات رایج را بر اساس دسته‌بندی ارائه می‌دهد.


مشکلات اتصال

کلاینت نمی‌تواند سرور را پیدا کند

علائم: کلاینت پیام "در حال جستجوی سرور" یا "سروری یافت نشد" را نشان می‌دهد.

راه‌حل‌ها:

  1. اطمینان حاصل کنید که HandyCafe Server روی رایانه مدیریت در حال اجرا است.
  2. تأیید کنید که هر دو رایانه در یک زیرشبکه هستند (مثلاً هر دو در 192.168.1.x).
  3. بررسی کنید که mDNS توسط سوئیچ یا روتر شبکه شما مسدود نشده باشد.
  4. اتصال دستی را امتحان کنید: آدرس IP سرور را مستقیماً در تنظیمات کلاینت وارد کنید.
  5. اطمینان حاصل کنید که هیچ نرم‌افزار دیگری از پورت TCP سرور استفاده نمی‌کند (پیش‌فرض: 5001).

کلاینت متصل می‌شود و سپس بلافاصله قطع می‌شود

علائم: کلاینت به طور مختصر "متصل" را نشان می‌دهد و سپس به "در حال جستجو" برمی‌گردد.

راه‌حل‌ها:

  1. اطمینان حاصل کنید که کلید اتصال در هر دو سرور و کلاینت مطابقت دارد. کلید در تنظیمات > شبکه در سرور تنظیم می‌شود.
  2. بررسی کنید که آیا ناپایداری شبکه وجود دارد (از دست دادن بسته‌ها، مشکلات کابل).
  3. اطمینان حاصل کنید که سرور به حداکثر تعداد رایانه‌های مجاز خود نرسیده است.
  4. لاگ‌های سرور را برای پیام‌های خطای احراز هویت بررسی کنید.

کلاینت در سرور "آفلاین" نشان داده می‌شود اما رایانه روشن است

علائم: رایانه کلاینت روشن است و برنامه کلاینت در حال اجرا است اما سرور آن را به عنوان آفلاین نشان می‌دهد.

راه‌حل‌ها:

  1. در رایانه کلاینت، اطمینان حاصل کنید که HandyCafe Client واقعاً در حال اجرا است (سینی سیستم را بررسی کنید).
  2. اتصال شبکه را در رایانه کلاینت بررسی کنید (آیا می‌تواند سرور را پینگ کند؟).
  3. قوانین فایروال را بررسی کنید: پورت‌های TCP 5001-5003 باید در هر دو سرور و کلاینت باز باشند.
  4. HandyCafe Client را در رایانه مورد نظر راه‌اندازی مجدد کنید.
  5. اگر از VLAN استفاده می‌کنید، اطمینان حاصل کنید که VLAN‌های سرور و کلاینت می‌توانند با هم ارتباط برقرار کنند.

نمی‌توان پس از تغییر تنظیمات شبکه متصل شد

علائم: پس از تغییر پورت‌ها یا کلید اتصال، کلاینت‌ها نمی‌توانند متصل شوند.

راه‌حل‌ها:

  1. اطمینان حاصل کنید که کلاینت‌ها با شماره پورت‌های جدید و کلید اتصال به‌روزرسانی شده‌اند.
  2. پس از تغییر تنظیمات شبکه، HandyCafe Server را راه‌اندازی مجدد کنید.
  3. قوانین فایروال را به‌روزرسانی کنید تا پورت‌های جدید را مجاز کند.
  4. همه کلاینت‌ها باید با مقادیر جدید پیکربندی شوند.

مشکلات نشست

نمی‌توان یک نشست را روی کلاینت شروع کرد

علائم: دکمه شروع غیرفعال است یا اقدام شروع با خطا مواجه می‌شود.

راه‌حل‌ها:

  1. وضعیت لایسنس را بررسی کنید. اگر در حالت فقط خواندنی است، نشست‌های جدید نمی‌توانند شروع شوند.
  2. اطمینان حاصل کنید که وضعیت کلاینت "بیکار" است. نشست‌ها فقط روی کلاینت‌های بیکار می‌توانند شروع شوند.
  3. مجوزهای صندوقدار را بررسی کنید. نقش باید مجوز AUTH_CLIENT_LOGIN داشته باشد.
  4. اطمینان حاصل کنید که قیمت‌گذاری پیکربندی شده است (تنظیمات > قیمت‌گذاری باید نرخ ساعتی معتبر داشته باشد).

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

علائم: زمان نمایش داده شده با زمان واقعی سپری شده مطابقت ندارد.

راه‌حل‌ها:

  1. ساعت‌های سیستم را در هر دو رایانه سرور و کلاینت بررسی کنید. آن‌ها باید همگام‌سازی شده باشند (از NTP استفاده کنید).
  2. اگر نشست متوقف شده بود، مدت زمان توقف محاسبه نمی‌شود.
  3. برای نشست‌های پیش‌پرداخت، تایمر زمان باقی‌مانده را نشان می‌دهد، نه زمان سپری شده.

هزینه نشست نادرست به نظر می‌رسد

علائم: مبلغ شارژ شده با انتظارات مطابقت ندارد.

راه‌حل‌ها:

  1. برنامه قیمت‌گذاری را بررسی کنید. اگر فعال باشد، ممکن است نشست از طریق چندین بازه قیمت‌گذاری با ضرایب مختلف عبور کرده باشد.
  2. تنظیمات قیمت‌گذاری را بررسی کنید: نرخ ساعتی پایه، مالیات بر ارزش افزوده، هزینه شروع، گرد کردن.
  3. بخش‌های قیمت‌گذاری نشست را در جزئیات تراکنش برای یک تجزیه و تحلیل بررسی کنید.
  4. کمیسیون و هزینه‌های ثابت روش پرداخت را بررسی کنید.
  5. برای نشست‌های پیش‌پرداخت، بررسی کنید که آیا حالت "قفل در خرید" یا "برنامه زنده" فعال است.

نشست متوقف شده نمی‌تواند از سر گرفته شود

علائم: اقدام از سرگیری شکست می‌خورد یا در دسترس نیست.

راه‌حل‌ها:

  1. اطمینان حاصل کنید که رایانه کلاینت هنوز به سرور متصل است.
  2. بررسی کنید که وضعیت کلاینت "متوقف" (نارنجی) را نشان می‌دهد.
  3. اگر کلاینت در طول توقف قطع شده است، ممکن است نیاز به اتصال مجدد داشته باشد.

مسائل پرداخت

روش پرداخت از منوی کشویی مفقود است

علائم: روش پرداخت مورد انتظار هنگام بستن یک نشست یا سفارش ظاهر نمی‌شود.

راه‌حل‌ها:

  1. اطمینان حاصل کنید که روش پرداخت در مدیریت > روش‌های پرداخت وجود دارد.
  2. بررسی کنید که روش پرداخت فعال است (حذف یا غیرفعال نشده باشد).
  3. مجوزهای صندوقدار را بررسی کنید. PAYMENT_MANAGE باید برای دیدن همه روش‌ها اعطا شود.

محاسبه کمیسیون نادرست به نظر می‌رسد

علائم: کمیسیون کسر شده با نرخ مورد انتظار مطابقت ندارد.

راه‌حل‌ها:

  1. نرخ کمیسیون روش پرداخت (به عنوان درصد) و هزینه ثابت را بررسی کنید.
  2. فرمول کمیسیون: کمیسیون = (مبلغ شارژ شده * نرخ کمیسیون / 100) + هزینه ثابت.
  3. بررسی کنید که آیا صندوقدار یک تغییر دستی در مبلغ شارژ شده اعمال کرده است.

مشکلات نمایش کلاینت

صفحه بیکار کلاینت خالی است

علائم: صفحه بیکار به جای نمایش اسلایدشو پیکربندی شده، هیچ چیزی نشان نمی‌دهد.

راه‌حل‌ها:

  1. اطمینان حاصل کنید که صفحه بیکار در تنظیمات > کلاینت‌ها > صفحه بیکار فعال است.
  2. بررسی کنید که حداقل یک آیتم رسانه‌ای (تصویر یا ویدیو) اضافه شده باشد.
  3. اطمینان حاصل کنید که فایل‌های رسانه‌ای معتبر و خراب نشده‌اند.
  4. یک همگام‌سازی را برای ارسال آخرین تنظیمات به کلاینت اجرا کنید.

منوی کلاینت برنامه‌ها را نشان نمی‌دهد

علائم: لانچر برنامه خالی است یا دسته‌بندی‌ها مفقود هستند.

راه‌حل‌ها:

  1. اطمینان حاصل کنید که برنامه‌ها و دسته‌بندی‌ها در تنظیمات > کلاینت‌ها > محتوا پیکربندی شده‌اند.
  2. بررسی کنید که دسته‌بندی‌ها و برنامه‌ها قابلیت مشاهده را فعال کرده باشند.
  3. اطمینان حاصل کنید که کلاینت آخرین داده‌های منو را دریافت کرده است (تغییرات به‌طور خودکار از طریق TCP ارسال می‌شوند).
  4. اگر همگام‌سازی در زمان واقعی اعمال نشد، کلاینت را راه‌اندازی مجدد کنید.

تم ظاهر کلاینت اعمال نشده است

علائم: کلاینت ظاهر پیش‌فرض را به جای تم پیکربندی شده نشان می‌دهد.

راه‌حل‌ها:

  1. اطمینان حاصل کنید که تنظیمات تم در تنظیمات > کلاینت‌ها > ظاهر ذخیره شده است.
  2. یک ارسال تنظیمات به کلاینت‌ها را اجرا کنید.
  3. برنامه کلاینت را راه‌اندازی مجدد کنید.

مشکلات دسکتاپ از راه دور

دسکتاپ از راه دور کند یا تکه‌تکه است

علائم: فید ویدئویی تأخیر دارد، تکه‌تکه است یا نرخ فریم پایین دارد.

راه‌حل‌ها:

  1. نرخ بیت را کاهش دهید (برای استفاده استاندارد LAN، 1000-2000 kbps را امتحان کنید).
  2. تنظیمات FPS را کاهش دهید.
  3. از اترنت سیمی به جای WiFi استفاده کنید.
  4. بررسی کنید که آیا تراکم شبکه یا استفاده بالای پهنای باند از برنامه‌های دیگر وجود دارد.
  5. اطمینان حاصل کنید که پورت UDP 5004 مسدود یا محدود نشده است.

دسکتاپ از راه دور صفحه سیاه نشان می‌دهد

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

راه‌حل‌ها:

  1. اطمینان حاصل کنید که کلاینت آنلاین و پاسخگو است (ابتدا سعی کنید یک اسکرین‌شات بگیرید).
  2. بررسی کنید که پورت UDP 5004 به صورت دوطرفه باز باشد.
  3. ممکن است نیاز به به‌روزرسانی درایور گرافیک کلاینت باشد.
  4. سعی کنید یک تازه‌سازی فریم کلیدی درخواست کنید.

نمی‌توان ماوس یا صفحه‌کلید را از راه دور کنترل کرد

علائم: شما می‌توانید صفحه از راه دور را ببینید اما کلیک‌ها و ضربه‌های کلید تأثیری ندارند.

راه‌حل‌ها:

  1. اطمینان حاصل کنید که پورت مدیریت از راه دور (TCP 5003) باز است.
  2. بررسی کنید که برنامه کلاینت مجوزهای سیستمی مناسب را داشته باشد.
  3. برخی از بازی‌های تمام‌صفحه ممکن است ورودی از راه دور را مسدود کنند.

مشکلات لایسنس

لایسنس "offline_grace" را نشان می‌دهد

علائم: وضعیت لایسنس offline_grace با شمارش معکوس را نشان می‌دهد.

راه‌حل‌ها:

  1. اتصال اینترنت را روی رایانه سرور بازیابی کنید.
  2. بررسی کنید که DNS به درستی کار می‌کند. سرور باید به سرور لایسنس دسترسی داشته باشد.
  3. بررسی کنید که آیا پروکسی یا فایروال اتصال‌های خروجی HTTPS را مسدود کرده است.
  4. شما 72 ساعت فرصت دارید تا اتصال را بازیابی کنید قبل از اینکه سرور قفل شود.

لایسنس "over_limit" را نشان می‌دهد

علائم: تعداد کلاینت‌های متصل بیشتر از حد مجاز لایسنس است.

راه‌حل‌ها:

  1. کلاینت‌های بیکار که در حال استفاده نیستند را قطع کنید.
  2. تعداد کلاینت‌های فعلی را با حد مجاز لایسنس خود مقایسه کنید.
  3. لایسنس خود را برای ظرفیت بیشتر رایانه ارتقا دهید.
  4. توجه: کنسول‌ها در شمارش کل رایانه‌ها محاسبه می‌شوند.

لایسنس "expired" یا "revoked" را نشان می‌دهد

علائم: سرور وارد حالت محدود می‌شود.

راه‌حل‌ها:

  1. تاریخ انقضای لایسنس خود را بررسی کنید.
  2. لایسنس خود را از طریق وب‌سایت HandyCafe تمدید کنید.
  3. برای لایسنس‌های لغو شده، با پشتیبانی HandyCafe تماس بگیرید.

مشکلات عمومی

تغییرات تنظیمات ذخیره نمی‌شوند

علائم: تغییرات پس از ترک صفحه تنظیمات به حالت قبلی برمی‌گردند.

راه‌حل‌ها:

  1. اطمینان حاصل کنید که پس از اعمال تغییرات، دکمه ذخیره را کلیک کرده‌اید.
  2. بررسی کنید که آیا خطاهای اعتبارسنجی وجود دارد (فیلدهای برجسته با پیام‌های خطا).
  3. اطمینان حاصل کنید که مجوزهای مدیر را دارید.

لاگ‌های حسابرسی ورودی‌ها را نشان نمی‌دهند

علائم: اقدامات مورد انتظار در صفحه لاگ‌ها ظاهر نمی‌شوند.

راه‌حل‌ها:

  1. فیلترهای لاگ را بررسی کنید. اطمینان حاصل کنید که دسته‌بندی و بازه زمانی صحیح انتخاب شده‌اند.
  2. اطمینان حاصل کنید که مجوز LOG_DISPLAY_FULL اعطا شده است (در غیر این صورت فقط لاگ‌های امروز نمایش داده می‌شوند).
  3. از فیلد جستجوی متنی برای جستجوی اقدام خاص استفاده کنید.