Yêu cầu hệ thống

Trước khi cài đặt HandyCafe trong quán internet, trung tâm game hoặc đấu trường esports của bạn, hãy kiểm tra xem phần cứng và mạng của bạn có đáp ứng các yêu cầu sau không.

Yêu cầu cho máy chủ PC

Máy chủ là trạm quản lý của bạn. Đây là PC nơi bạn chạy HandyCafe Server để giám sát và điều khiển toàn bộ quán.

Thành phần	Tối thiểu	Khuyến nghị
Hệ điều hành	Windows 10+ (64-bit), macOS 12 Monterey+, hoặc Linux (64-bit)	Windows 10/11 (64-bit), macOS 12+, hoặc Linux (64-bit)
Bộ xử lý	Dual-core 2.0 GHz	Quad-core 2.5 GHz+
RAM	4 GB	8 GB+
Dung lượng đĩa	500 MB (ứng dụng)	2 GB+ (với ghi âm và ảnh chụp màn hình)
Màn hình	1280 x 720	1920 x 1080+
Mạng	Ethernet 100 Mbps	Ethernet Gigabit

Lưu ý: Nếu bạn sử dụng remote desktop với ghi âm phiên, hãy phân bổ thêm dung lượng đĩa cho các bản ghi MP4 (khoảng 50-200 MB mỗi giờ ghi tùy thuộc vào chất lượng).

Lưu ý Linux: HandyCafe được xây dựng với Tauri v2 sử dụng WebKit2GTK trên Linux. Bạn phải cài đặt gói runtime libwebkit2gtk-4.1 trước khi chạy ứng dụng. Các bản phân phối được hỗ trợ bao gồm Ubuntu 22.04+, Fedora 38+ và các bản phân phối khác có phiên bản WebKit2GTK tương đương.

Yêu cầu cho máy khách PC

Mỗi PC phục vụ khách hàng chạy HandyCafe Client, kết nối với máy chủ qua mạng cục bộ.

Thành phần	Tối thiểu	Khuyến nghị
Hệ điều hành	Windows 10+ (64-bit), macOS 12 Monterey+, hoặc Linux (64-bit)	Windows 10/11 (64-bit), macOS 12+, hoặc Linux (64-bit)
Bộ xử lý	Dual-core 1.5 GHz	Quad-core 2.0 GHz+
RAM	2 GB	4 GB+
Dung lượng đĩa	200 MB	500 MB+
Mạng	Ethernet 100 Mbps	Ethernet Gigabit

Lưu ý: Đây là yêu cầu chỉ dành cho phần mềm HandyCafe Client. PC của bạn sẽ cần thêm tài nguyên cho các trò chơi và ứng dụng mà khách hàng của bạn sử dụng.

Yêu cầu mạng

Tất cả các PC (máy chủ và máy khách) phải nằm trên cùng một mạng cục bộ (LAN).

Cổng cần thiết

Cổng	Giao thức	Hướng	Mục đích
5001	TCP	Máy chủ: vào, Máy khách: ra	Giao tiếp lệnh và phản hồi
5002	TCP	Hai chiều	Truyền tệp
5003	TCP	Máy chủ: vào, Máy khách: ra	Kênh điều khiển quản lý từ xa
5004	UDP	Hai chiều	Truyền phát màn hình (remote desktop)

Quan trọng: Đây là các cổng mặc định. Bạn có thể thay đổi chúng trong Cài đặt mạng. Nếu bạn thay đổi cổng trên máy chủ, hãy cập nhật cấu hình máy khách để khớp.

Cấu hình tường lửa

Tường lửa Windows: HandyCafe cố gắng thêm quy tắc tường lửa tự động trong quá trình cài đặt. Nếu cấu hình tự động thất bại, hãy thêm thủ công các quy tắc vào cho các cổng được liệt kê ở trên.
Tường lửa macOS: Mở Cài đặt hệ thống > Mạng > Tường lửa và cho phép kết nối đến cho HandyCafe. Hoặc, thêm các cổng được liệt kê ở trên vào danh sách cho phép của tường lửa.
Linux (iptables / ufw): Nếu bạn sử dụng ufw, chạy sudo ufw allow 5001:5004/tcp và sudo ufw allow 5004/udp. Đối với iptables thô, thêm các quy tắc INPUT ACCEPT tương đương cho các cổng TCP 5001-5003 và cổng UDP 5004.
Tường lửa bên thứ ba: Thêm ngoại lệ cho tệp thực thi HandyCafe server trên máy chủ PC và tệp thực thi HandyCafe client trên máy khách PC.
Router/Switch: Không cần cấu hình đặc biệt cho hoạt động chỉ LAN. Nếu bạn có VLAN, đảm bảo máy chủ và tất cả máy khách nằm trên cùng một VLAN hoặc rằng định tuyến cho phép các cổng cần thiết.

Khám phá máy khách

HandyCafe sử dụng mDNS (multicast DNS) để tự động phát hiện máy khách trên mạng cục bộ. Điều này yêu cầu:

Tất cả các PC trên cùng một subnet
Lưu lượng multicast không bị chặn bởi switch hoặc router
Nếu mDNS không hoạt động (ví dụ, qua các subnet), máy khách có thể kết nối bằng cách nhập địa chỉ IP của máy chủ thủ công

Cân nhắc về băng thông

Tính năng	Băng thông ước tính
Hoạt động bình thường (mỗi máy khách)	< 1 Kbps
Truyền phát remote desktop	350 - 25,000 Kbps (có thể cấu hình)
Truyền đồng bộ tệp	Giới hạn bởi tốc độ mạng
Chụp ảnh màn hình	~100 KB mỗi ảnh chụp

Đối với một quán thông thường với 20-50 PC, một mạng LAN 100 Mbps tiêu chuẩn là đủ. Ethernet Gigabit được khuyến nghị nếu bạn thường xuyên sử dụng remote desktop cho nhiều PC cùng lúc.

Yêu cầu cho máy chơi game

Nếu bạn quản lý máy chơi game (PlayStation, Xbox, v.v.), các máy chơi game phải nằm trên cùng mạng với máy chủ. Mỗi máy chơi game được xác định bằng địa chỉ MAC của nó và được đăng ký thủ công trong Cài đặt máy chơi game.