HandyCafe Docs
owner it-admin

Persyaratan Sistem

Sebelum menginstal HandyCafe di warnet, pusat gaming, atau arena esports Anda, verifikasi bahwa perangkat keras dan jaringan Anda memenuhi persyaratan berikut.

Persyaratan PC Server

Server adalah stasiun manajemen Anda. Ini adalah PC tempat Anda menjalankan HandyCafe Server untuk memantau dan mengendalikan seluruh kafe.

Komponen Minimum Disarankan
Sistem Operasi Windows 10+ (64-bit), macOS 12 Monterey+, atau Linux (64-bit) Windows 10/11 (64-bit), macOS 12+, atau Linux (64-bit)
Prosesor Dual-core 2.0 GHz Quad-core 2.5 GHz+
RAM 4 GB 8 GB+
Ruang Disk 500 MB (aplikasi) 2 GB+ (dengan rekaman dan tangkapan layar)
Tampilan 1280 x 720 1920 x 1080+
Jaringan 100 Mbps Ethernet Gigabit Ethernet

Catatan: Jika Anda menggunakan desktop jarak jauh dengan perekaman sesi, alokasikan ruang disk tambahan untuk rekaman MP4 (sekitar 50-200 MB per jam rekaman tergantung pada kualitas).

Catatan Linux: HandyCafe dibangun dengan Tauri v2 yang menggunakan WebKit2GTK di Linux. Anda harus menginstal paket runtime libwebkit2gtk-4.1 sebelum menjalankan aplikasi. Distribusi yang didukung meliputi Ubuntu 22.04+, Fedora 38+ dan distribusi lain yang menyertakan versi WebKit2GTK yang setara.

Persyaratan PC Klien

Setiap PC pelanggan menjalankan HandyCafe Client, yang terhubung ke server melalui jaringan lokal.

Komponen Minimum Disarankan
Sistem Operasi Windows 10+ (64-bit), macOS 12 Monterey+, atau Linux (64-bit) Windows 10/11 (64-bit), macOS 12+, atau Linux (64-bit)
Prosesor Dual-core 1.5 GHz Quad-core 2.0 GHz+
RAM 2 GB 4 GB+
Ruang Disk 200 MB 500 MB+
Jaringan 100 Mbps Ethernet Gigabit Ethernet

Catatan: Ini adalah persyaratan untuk perangkat lunak HandyCafe Client saja. PC Anda akan membutuhkan sumber daya tambahan untuk game dan aplikasi yang digunakan pelanggan Anda.

Persyaratan Jaringan

Semua PC (server dan klien) harus berada di jaringan lokal yang sama (LAN).

Port yang Diperlukan

Port Protokol Arah Tujuan
5001 TCP Server: masuk, Klien: keluar Komunikasi perintah dan respons
5002 TCP Dua arah Transfer file
5003 TCP Server: masuk, Klien: keluar Saluran kontrol manajemen jarak jauh
5004 UDP Dua arah Streaming layar (desktop jarak jauh)

Penting: Ini adalah port default. Anda dapat mengubahnya di Pengaturan Jaringan. Jika Anda mengubah port di server, perbarui konfigurasi klien agar cocok.

Konfigurasi Firewall

  • Windows Firewall: HandyCafe mencoba menambahkan aturan firewall secara otomatis saat instalasi. Jika konfigurasi otomatis gagal, tambahkan secara manual aturan masuk untuk port yang tercantum di atas.
  • macOS Firewall: Buka Pengaturan Sistem > Jaringan > Firewall dan izinkan koneksi masuk untuk HandyCafe. Atau, tambahkan port yang tercantum di atas ke daftar izin firewall Anda.
  • Linux (iptables / ufw): Jika Anda menggunakan ufw, jalankan sudo ufw allow 5001:5004/tcp dan sudo ufw allow 5004/udp. Untuk iptables mentah, tambahkan aturan INPUT ACCEPT yang setara untuk port TCP 5001-5003 dan port UDP 5004.
  • Firewall pihak ketiga: Tambahkan pengecualian untuk biner server HandyCafe di PC server dan biner klien HandyCafe di PC klien.
  • Router/Switch: Tidak diperlukan konfigurasi khusus untuk operasi LAN saja. Jika Anda memiliki VLAN, pastikan server dan semua klien berada di VLAN yang sama atau bahwa routing mengizinkan port yang diperlukan.

Penemuan Klien

HandyCafe menggunakan mDNS (multicast DNS) untuk penemuan klien otomatis di jaringan lokal. Ini memerlukan:

  • Semua PC di subnet yang sama
  • Lalu lintas multicast tidak diblokir oleh switch atau router
  • Jika mDNS tidak berfungsi (misalnya lintas subnet), klien dapat terhubung dengan memasukkan alamat IP server secara manual

Pertimbangan Bandwidth

Fitur Perkiraan Bandwidth
Operasi normal (per klien) < 1 Kbps
Streaming desktop jarak jauh 350 - 25.000 Kbps (dapat dikonfigurasi)
Transfer sinkronisasi file Dibatasi oleh kecepatan jaringan
Pengambilan tangkapan layar ~100 KB per tangkapan layar

Untuk kafe tipikal dengan 20-50 PC, LAN 100 Mbps standar sudah cukup. Gigabit Ethernet disarankan jika Anda sering menggunakan desktop jarak jauh untuk beberapa PC secara bersamaan.

Persyaratan Konsol

Jika Anda mengelola konsol gaming (PlayStation, Xbox, dll.), konsol harus berada di jaringan yang sama dengan server. Setiap konsol diidentifikasi berdasarkan alamat MAC-nya dan didaftarkan secara manual di Pengaturan Konsol.