Khắc phục sự cố

Trang này bao gồm các giải pháp cho các vấn đề phổ biến được tổ chức theo từng danh mục.

Vấn đề kết nối

Máy khách không tìm thấy máy chủ

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

Giải pháp:

Xác minh HandyCafe Server đang chạy trên máy quản lý.
Đảm bảo cả hai máy tính đều nằm trong cùng một subnet (ví dụ: cả hai đều trên 192.168.1.x).
Kiểm tra rằng mDNS không bị chặn bởi switch mạng hoặc router của bạn.
Thử kết nối thủ công: nhập địa chỉ IP của máy chủ trực tiếp trong cài đặt máy khách.
Xác minh không có phần mềm nào khác đang sử dụng cổng TCP của máy chủ (mặc định: 5001).

Máy khách kết nối rồi ngắt ngay lập tức

Triệu chứng: Máy khách hiển thị "Đã kết nối" trong thời gian ngắn rồi quay lại "Đang tìm kiếm."

Giải pháp:

Xác minh khóa kết nối khớp trên cả máy chủ và máy khách. Khóa được đặt trong Cài đặt > Mạng trên máy chủ.
Kiểm tra sự ổn định của mạng (mất gói, vấn đề cáp).
Đảm bảo máy chủ chưa đạt đến giới hạn PC theo giấy phép.
Xem lại nhật ký máy chủ để tìm thông báo lỗi xác thực.

Máy khách hiển thị "Ngoại tuyến" trên máy chủ nhưng PC đang chạy

Triệu chứng: PC máy khách đang bật và ứng dụng máy khách đang chạy nhưng máy chủ hiển thị nó là ngoại tuyến.

Giải pháp:

Trên PC máy khách, xác minh HandyCafe Client thực sự đang chạy (kiểm tra khay hệ thống).
Kiểm tra kết nối mạng trên PC máy khách (nó có thể ping máy chủ không?).
Xác minh quy tắc tường lửa: cổng TCP 5001-5003 phải mở trên cả máy chủ và máy khách.
Khởi động lại HandyCafe Client trên PC bị ảnh hưởng.
Nếu sử dụng VLAN, đảm bảo VLAN của máy chủ và máy khách có thể giao tiếp.

Không thể kết nối sau khi thay đổi cài đặt mạng

Triệu chứng: Sau khi thay đổi cổng hoặc khóa kết nối, máy khách không thể kết nối.

Giải pháp:

Đảm bảo máy khách được cập nhật với số cổng mới và khóa kết nối.
Khởi động lại HandyCafe Server sau khi thay đổi cài đặt mạng.
Cập nhật quy tắc tường lửa để cho phép các cổng mới.
Tất cả máy khách phải được cấu hình lại với các giá trị mới.

Vấn đề phiên

Không thể bắt đầu phiên trên máy khách

Triệu chứng: Nút bắt đầu bị vô hiệu hóa hoặc hành động bắt đầu thất bại với lỗi.

Giải pháp:

Kiểm tra trạng thái giấy phép. Nếu ở chế độ chỉ đọc, không thể bắt đầu phiên mới.
Xác minh trạng thái máy khách là "Nhàn rỗi". Phiên chỉ có thể bắt đầu trên máy khách nhàn rỗi.
Kiểm tra quyền của thu ngân. Vai trò phải có quyền AUTH_CLIENT_LOGIN.
Đảm bảo cấu hình giá (Cài đặt > Giá phải có mức giá theo giờ hợp lệ).

Bộ đếm thời gian phiên hiển thị sai thời gian

Triệu chứng: Thời gian hiển thị không khớp với thời gian đã trôi qua thực tế.

Giải pháp:

Kiểm tra đồng hồ hệ thống trên cả máy chủ và PC máy khách. Chúng nên được đồng bộ hóa (sử dụng NTP).
Nếu phiên bị tạm dừng, thời gian tạm dừng không được tính.
Đối với các phiên trả trước, bộ đếm thời gian hiển thị thời gian còn lại, không phải thời gian đã trôi qua.

Chi phí phiên có vẻ sai

Triệu chứng: Số tiền tính phí không khớp với mong đợi.

Giải pháp:

Kiểm tra lịch trình giá. Nếu được kích hoạt, phiên có thể đã qua nhiều khung giá với các hệ số khác nhau.
Xem lại cài đặt giá: giá theo giờ cơ bản, VAT, phí khởi động, làm tròn.
Kiểm tra các phân đoạn giá của phiên trong chi tiết giao dịch để có sự phân tích.
Xác minh hoa hồng và phí cố định của phương thức thanh toán.
Đối với các phiên trả trước, kiểm tra xem chế độ "Khóa khi mua" hoặc "Lịch trình trực tiếp" có hoạt động không.

Phiên tạm dừng không thể tiếp tục

Triệu chứng: Hành động tiếp tục thất bại hoặc không khả dụng.

Giải pháp:

Xác minh PC máy khách vẫn kết nối với máy chủ.
Kiểm tra rằng trạng thái máy khách hiển thị "Tạm dừng" (màu cam).
Nếu máy khách bị ngắt kết nối trong khi tạm dừng, có thể cần kết nối lại trước.

Vấn đề thanh toán

Phương thức thanh toán không có trong danh sách

Triệu chứng: Phương thức thanh toán dự kiến không xuất hiện khi đóng phiên hoặc đơn hàng.

Giải pháp:

Xác minh phương thức thanh toán tồn tại trong Quản lý > Phương thức thanh toán.
Kiểm tra rằng phương thức thanh toán đang hoạt động (không bị xóa hoặc vô hiệu hóa).
Kiểm tra quyền của thu ngân. PAYMENT_MANAGE phải được cấp để xem tất cả các phương thức.

Tính toán hoa hồng có vẻ không chính xác

Triệu chứng: Hoa hồng bị khấu trừ không khớp với tỷ lệ dự kiến.

Giải pháp:

Xác minh tỷ lệ hoa hồng (dưới dạng phần trăm) và phí cố định của phương thức thanh toán.
Công thức hoa hồng: hoa hồng = (số tiền tính phí * tỷ lệ hoa hồng / 100) + phí cố định.
Kiểm tra xem thu ngân có áp dụng ghi đè thủ công cho số tiền tính phí không.

Vấn đề hiển thị của máy khách

Màn hình nhàn rỗi của máy khách trống

Triệu chứng: Màn hình nhàn rỗi không hiển thị gì thay vì trình chiếu đã cấu hình.

Giải pháp:

Xác minh rằng màn hình nhàn rỗi được bật trong Cài đặt > Máy khách > Màn hình nhàn rỗi.
Kiểm tra rằng ít nhất một mục phương tiện (hình ảnh hoặc video) đã được thêm vào.
Xác minh các tệp phương tiện hợp lệ và không bị hỏng.
Kích hoạt đồng bộ để đẩy cài đặt mới nhất đến máy khách.

Menu máy khách không hiển thị ứng dụng

Triệu chứng: Trình khởi chạy ứng dụng trống hoặc thiếu danh mục.

Giải pháp:

Xác minh ứng dụng và danh mục được cấu hình trong Cài đặt > Máy khách > Nội dung.
Kiểm tra rằng danh mục và ứng dụng đã bật hiển thị.
Xác minh máy khách đã nhận được dữ liệu menu mới nhất (thay đổi tự động đẩy qua TCP).
Khởi động lại máy khách nếu đồng bộ thời gian thực không áp dụng.

Chủ đề giao diện máy khách không được áp dụng

Triệu chứng: Máy khách hiển thị giao diện mặc định thay vì chủ đề đã cấu hình.

Giải pháp:

Xác minh cài đặt chủ đề đã được lưu trong Cài đặt > Máy khách > Giao diện.
Kích hoạt đẩy cài đặt đến máy khách.
Khởi động lại ứng dụng máy khách.

Vấn đề máy tính từ xa

Máy tính từ xa bị lag hoặc giật

Triệu chứng: Luồng video bị trễ, giật hoặc có tốc độ khung hình thấp.

Giải pháp:

Giảm bitrate (thử 1000-2000 kbps cho sử dụng LAN tiêu chuẩn).
Giảm cài đặt FPS.
Sử dụng Ethernet có dây thay vì WiFi.
Kiểm tra tắc nghẽn mạng hoặc sử dụng băng thông cao từ các ứng dụng khác.
Đảm bảo cổng UDP 5004 không bị chặn hoặc giới hạn tốc độ.

Máy tính từ xa hiển thị màn hình đen

Triệu chứng: Cửa sổ máy tính từ xa mở nhưng chỉ hiển thị màu đen.

Giải pháp:

Xác minh máy khách đang trực tuyến và phản hồi (thử chụp màn hình trước).
Kiểm tra cổng UDP 5004 mở hai chiều.
Trình điều khiển đồ họa của máy khách có thể cần cập nhật.
Thử yêu cầu làm mới khung hình chính.

Không thể điều khiển chuột hoặc bàn phím từ xa

Triệu chứng: Bạn có thể thấy màn hình từ xa nhưng nhấp chuột và gõ phím không có hiệu lực.

Giải pháp:

Xác minh cổng quản lý từ xa (TCP 5003) mở.
Kiểm tra rằng ứng dụng máy khách có quyền hệ thống phù hợp.
Một số trò chơi toàn màn hình có thể chặn đầu vào từ xa.

Vấn đề cấp phép

Giấy phép hiển thị "offline_grace"

Triệu chứng: Trạng thái giấy phép hiển thị offline_grace với đếm ngược.

Giải pháp:

Khôi phục kết nối internet trên máy chủ PC.
Kiểm tra phân giải DNS. Máy chủ phải truy cập được máy chủ cấp phép.
Kiểm tra xem proxy hoặc tường lửa có chặn kết nối HTTPS ra ngoài không.
Bạn có 72 giờ để khôi phục kết nối trước khi máy chủ bị khóa.

Giấy phép hiển thị "over_limit"

Triệu chứng: Nhiều máy khách kết nối hơn giấy phép cho phép.

Giải pháp:

Ngắt kết nối các máy khách nhàn rỗi không sử dụng.
Kiểm tra số lượng máy khách hiện tại so với giới hạn giấy phép của bạn.
Nâng cấp giấy phép của bạn để có thêm dung lượng PC.
Lưu ý: các máy chơi game cũng tính vào tổng giới hạn PC.

Giấy phép hiển thị "expired" hoặc "revoked"

Triệu chứng: Máy chủ vào chế độ hạn chế.

Giải pháp:

Kiểm tra ngày hết hạn giấy phép của bạn.
Gia hạn giấy phép của bạn qua trang web HandyCafe.
Đối với giấy phép bị thu hồi, liên hệ hỗ trợ HandyCafe.

Vấn đề chung

Thay đổi cài đặt không được lưu

Triệu chứng: Thay đổi bị hoàn tác sau khi điều hướng khỏi cài đặt.

Giải pháp:

Đảm bảo nhấp vào nút Lưu sau khi thực hiện thay đổi.
Kiểm tra lỗi xác thực (các trường được đánh dấu với thông báo lỗi).
Xác minh bạn có quyền quản trị viên.

Nhật ký kiểm toán thiếu mục

Triệu chứng: Các hành động dự kiến không xuất hiện trong trang Nhật ký.

Giải pháp:

Kiểm tra bộ lọc nhật ký. Đảm bảo chọn đúng danh mục và phạm vi ngày.
Xác minh quyền LOG_DISPLAY_FULL được cấp (nếu không chỉ hiển thị nhật ký hôm nay).
Tìm kiếm bằng trường tìm kiếm văn bản cho hành động cụ thể.