HandyCafe Docs
owner cashier it-admin

Xử lý Sự cố

Hướng dẫn này cung cấp giải pháp cho các vấn đề thường gặp khi vận hành HandyCafe trong quán internet hoặc trung tâm game.

Vấn đề Kết nối

Máy khách không kết nối được máy chủ

Triệu chứng: PC khách hiển thị "Đang tìm máy chủ" hoặc "Không thể kết nối".

Giải pháp:

  1. Xác minh HandyCafe Server đang chạy trên PC quản lý.
  2. Kiểm tra cả hai PC cùng mạng nội bộ (subnet).
  3. Kiểm tra tường lửa cho phép cổng TCP 5001, 5002, 5003 và UDP 5004.
  4. Xác minh khóa kết nối khớp giữa máy chủ và máy khách.
  5. Thử nhập IP máy chủ thủ công trong cài đặt máy khách.
  6. Kiểm tra cáp mạng và thiết bị switch.

Máy khách kết nối rồi ngắt ngay

Giải pháp:

  1. Kiểm tra khóa kết nối khớp trên cả hai bên.
  2. Xác minh không có xung đột IP trên mạng.
  3. Kiểm tra tường lửa không chặn giao tiếp sau kết nối ban đầu.

mDNS không phát hiện máy chủ

Giải pháp:

  1. Đảm bảo multicast không bị chặn bởi router hoặc switch.
  2. Nhập IP máy chủ thủ công thay cho phát hiện tự động.
  3. Kiểm tra máy chủ và máy khách cùng VLAN.

Vấn đề Phiên

Giá phiên không chính xác

Giải pháp:

  1. Kiểm tra giá theo giờ cơ bản trong Cài đặt > Giá cả.
  2. Kiểm tra thuế suất VAT.
  3. Kiểm tra lịch tính giá cho hệ số nhân đang hoạt động tại thời điểm phiên.
  4. Xem lại đoạn tính giá trong chi tiết giao dịch.
  5. Kiểm tra giảm giá hội viên (BPS) nếu hội viên được gán.

Phiên không bắt đầu được

Giải pháp:

  1. Kiểm tra máy khách đang ở trạng thái Chờ (xanh dương nhạt).
  2. Xác minh giấy phép chưa đạt giới hạn PC.
  3. Kiểm tra quyền thu ngân có bao gồm CLIENT_LOGIN.
  4. Xác minh giấy phép không ở chế độ chỉ đọc.

Phiên trả trước không tự kết thúc

Giải pháp:

  1. Kiểm tra kết nối mạng giữa máy chủ và máy khách.
  2. Xác minh bộ đếm thời gian phiên đang chạy (không bị tạm dừng).

Vấn đề Đăng nhập

Tài khoản thu ngân bị khóa

Giải pháp:

  1. Đợi 15 phút để hết thời gian khóa tự động.
  2. Quản trị viên có thể quản lý tài khoản qua giao diện quản lý.

Đăng nhập OAuth bị kẹt "đang chờ"

Giải pháp:

  1. Kiểm tra yêu cầu đã được phê duyệt trên trang Yêu cầu.
  2. Xác minh thông tin xác thực nhà cung cấp OAuth đúng trong Cài đặt > OAuth.
  3. Kiểm tra máy chủ có internet để truy cập API nhà cung cấp.
  4. Mã thiết bị có thể đã hết hạn (15-30 phút). Yêu cầu khách thử lại.

Vấn đề Mạng

Màn hình từ xa lag

Giải pháp:

  1. Giảm bitrate phát (thử 1000-2000 kbps cho LAN).
  2. Kiểm tra băng thông mạng giữa máy chủ và máy khách.
  3. Đảm bảo cổng UDP 5004 không bị chặn.
  4. Sử dụng Ethernet có dây thay vì Wi-Fi.
  5. Kiểm tra tỷ lệ mất gói trong trình xem từ xa.

Đồng bộ file thất bại

Giải pháp:

  1. Kiểm tra cổng TCP 5002 mở.
  2. Xác minh đủ dung lượng ổ đĩa trên máy khách.
  3. Kiểm tra file nguồn vẫn tồn tại trên máy chủ.
  4. Thử đồng bộ đến một máy khách riêng lẻ để cách ly vấn đề.

Vấn đề Giấy phép

Giấy phép hiện "over_limit"

Giải pháp:

  1. Ngắt kết nối máy khách không sử dụng.
  2. Console cũng tính vào giới hạn thiết bị.
  3. Nâng cấp giấy phép nếu cần thêm thiết bị.

Giấy phép hiện "offline_locked"

Giải pháp:

  1. Khôi phục kết nối internet trên PC máy chủ.
  2. Kiểm tra tường lửa không chặn truy cập đến máy chủ cấp phép.
  3. Xác minh DNS đang hoạt động.
  4. Sau khi kết nối được khôi phục, giấy phép tự động chuyển lại trạng thái hoạt động.

Vấn đề Chung

Ứng dụng chạy chậm

Giải pháp:

  1. Kiểm tra tài nguyên hệ thống (RAM, CPU) trên PC máy chủ.
  2. Đóng ứng dụng không cần thiết trên máy chủ.
  3. Kiểm tra dung lượng ổ đĩa còn trống.
  4. Với danh sách hội viên lớn, hệ thống sử dụng cuộn ảo nên hiệu suất nên ổn.

Không thấy trang trong thanh bên

Giải pháp:

  1. Kiểm tra quyền vai trò thu ngân. Trang bị ẩn nếu vai trò không có quyền truy cập.
  2. Đăng nhập bằng tài khoản quản trị để xem tất cả trang.

Thay đổi cài đặt không có hiệu lực

Giải pháp:

  1. Đảm bảo đã nhấp Lưu sau khi thay đổi.
  2. Thay đổi mạng yêu cầu khởi động lại máy chủ.
  3. Thay đổi giá áp dụng cho phiên mới, không phiên đang chạy.
  4. Thay đổi giao diện máy khách được đẩy tự động theo thời gian thực.