Keperluan Sistem

Sebelum memasang HandyCafe di kafe internet, pusat permainan atau arena esukan anda, pastikan perkakasan dan rangkaian anda memenuhi keperluan berikut.

Keperluan PC Pelayan

Pelayan ialah stesen pengurusan anda. Ini adalah PC tempat anda menjalankan HandyCafe Server untuk memantau dan mengawal seluruh kafe.

Komponen	Minimum	Disyorkan
Sistem Pengendalian	Windows 10+ (64-bit), macOS 12 Monterey+ atau Linux (64-bit)	Windows 10/11 (64-bit), macOS 12+ atau Linux (64-bit)
Pemproses	Dwi-teras 2.0 GHz	Empat-teras 2.5 GHz+
RAM	4 GB	8 GB+
Ruang Cakera	500 MB (aplikasi)	2 GB+ (dengan rakaman dan tangkapan skrin)
Paparan	1280 x 720	1920 x 1080+
Rangkaian	100 Mbps Ethernet	Gigabit Ethernet

Nota: Jika anda menggunakan desktop jarak jauh dengan rakaman sesi, peruntukkan ruang cakera tambahan untuk rakaman MP4 (lebih kurang 50-200 MB setiap jam rakaman bergantung pada kualiti).

Nota Linux: HandyCafe dibina dengan Tauri v2 yang menggunakan WebKit2GTK pada Linux. Anda mesti memasang pakej runtime libwebkit2gtk-4.1 sebelum menjalankan aplikasi. Distribusi yang disokong termasuk Ubuntu 22.04+, Fedora 38+ dan distribusi lain yang menyediakan versi WebKit2GTK yang setara.

Keperluan PC Klien

Setiap PC pelanggan menjalankan HandyCafe Client, yang bersambung ke pelayan melalui rangkaian tempatan.

Komponen	Minimum	Disyorkan
Sistem Pengendalian	Windows 10+ (64-bit), macOS 12 Monterey+ atau Linux (64-bit)	Windows 10/11 (64-bit), macOS 12+ atau Linux (64-bit)
Pemproses	Dwi-teras 1.5 GHz	Empat-teras 2.0 GHz+
RAM	2 GB	4 GB+
Ruang Cakera	200 MB	500 MB+
Rangkaian	100 Mbps Ethernet	Gigabit Ethernet

Nota: Ini adalah keperluan untuk perisian HandyCafe Client sahaja. PC anda memerlukan sumber tambahan untuk permainan dan aplikasi yang pelanggan anda gunakan.

Keperluan Rangkaian

Semua PC (pelayan dan klien) mesti berada pada rangkaian tempatan yang sama (LAN).

Port yang Diperlukan

Port	Protokol	Arah	Tujuan
5001	TCP	Pelayan: masuk, Klien: keluar	Komunikasi arahan dan respons
5002	TCP	Dwiarah	Pemindahan fail
5003	TCP	Pelayan: masuk, Klien: keluar	Saluran kawalan pengurusan jarak jauh
5004	UDP	Dwiarah	Penstriman skrin (desktop jarak jauh)

Penting: Ini adalah port lalai. Anda boleh menukarnya dalam Tetapan Rangkaian. Jika anda menukar port pada pelayan, kemas kini konfigurasi klien untuk sepadan.

Konfigurasi Tembok Api

Windows Firewall: HandyCafe cuba menambah peraturan tembok api secara automatik semasa pemasangan. Jika konfigurasi automatik gagal, tambah peraturan masuk secara manual untuk port yang disenaraikan di atas.
macOS Firewall: Buka Tetapan Sistem > Rangkaian > Tembok Api dan benarkan sambungan masuk untuk HandyCafe. Sebagai alternatif, tambah port yang disenaraikan di atas ke senarai kebenaran tembok api anda.
Linux (iptables / ufw): Jika anda menggunakan ufw, jalankan sudo ufw allow 5001:5004/tcp dan sudo ufw allow 5004/udp. Untuk iptables mentah, tambah peraturan INPUT ACCEPT yang setara untuk port TCP 5001-5003 dan port UDP 5004.
Tembok api pihak ketiga: Tambah pengecualian untuk binari pelayan HandyCafe pada PC pelayan dan binari klien HandyCafe pada PC klien.
Router/Suis: Tiada konfigurasi khas diperlukan untuk operasi LAN sahaja. Jika anda mempunyai VLAN, pastikan pelayan dan semua klien berada pada VLAN yang sama atau penghalaan membenarkan port yang diperlukan.

Penemuan Klien

HandyCafe menggunakan mDNS (DNS multicast) untuk penemuan klien automatik pada rangkaian tempatan. Ini memerlukan:

Semua PC pada subnet yang sama
Trafik multicast tidak disekat oleh suis atau router
Jika mDNS tidak berfungsi (contoh: merentasi subnet), klien boleh bersambung dengan memasukkan alamat IP pelayan secara manual

Pertimbangan Lebar Jalur

Ciri	Anggaran Lebar Jalur
Operasi biasa (setiap klien)	< 1 Kbps
Penstriman desktop jarak jauh	350 - 25,000 Kbps (boleh dikonfigurasikan)
Pemindahan penyegerakan fail	Terhad oleh kelajuan rangkaian
Tangkapan skrin	~100 KB setiap tangkapan skrin

Untuk kafe biasa dengan 20-50 PC, LAN 100 Mbps standard sudah memadai. Gigabit Ethernet disyorkan jika anda kerap menggunakan desktop jarak jauh untuk berbilang PC secara serentak.

Keperluan Konsol

Jika anda mengurus konsol permainan (PlayStation, Xbox dan sebagainya), konsol mesti berada pada rangkaian yang sama dengan pelayan. Setiap konsol dikenal pasti melalui alamat MAC nya dan didaftarkan secara manual dalam Tetapan Konsol.