HandyCafe Docs
it-admin

Memulai: Administrator IT

Panduan ini mencakup pengaturan teknis HandyCafe. Di akhir panduan, Anda akan memiliki server dan klien terinstal, jaringan terkonfigurasi, menu aplikasi terbangun, dan manajemen jarak jauh teruji.

Waktu penyelesaian: 5 menit (ditambah waktu deploy klien)

Langkah 1: Instal Server dan Klien

Instalasi server:

  1. Verifikasi PC server Anda memenuhi persyaratan sistem.
  2. Unduh dan instal HandyCafe Server di PC manajemen Anda.
  3. Luncurkan server dan selesaikan Wizard Pengaturan Awal untuk membuat akun admin.
  4. Catat alamat IP lokal PC server. Klien akan membutuhkan ini untuk terhubung.

Instalasi klien (ulangi untuk setiap PC):

  1. Unduh HandyCafe Client di setiap PC pelanggan.
  2. Instal dan luncurkan klien.
  3. Klien mencari server di jaringan lokal menggunakan penemuan mDNS.
  4. Jika server tidak ditemukan secara otomatis, masukkan alamat IP server secara manual di pengaturan klien.
  5. Setelah terhubung, klien muncul di Panel Admin server.

Tips: Gunakan fitur penamaan otomatis server (Pengaturan > Klien) untuk secara otomatis memberi nama klien dengan awalan seperti "PC #1", "PC #2", dll. Anda dapat menyesuaikan nama tampilan nanti.

Lihat Instalasi Server dan Instalasi Klien untuk langkah detail.

Langkah 2: Konfigurasikan Pengaturan Jaringan

Navigasikan ke Pengaturan > Jaringan di server.

HandyCafe menggunakan empat port untuk komunikasi:

Port Default Tujuan
Port TCP 5001 Komunikasi perintah dan respons
Port File 5002 Transfer file antara server dan klien
Port Manajemen Jarak Jauh 5003 Kontrol streaming desktop jarak jauh
Port UDP 5004 Data streaming layar

Konfigurasi:

  1. Atur port (default cocok untuk sebagian besar pengaturan).
  2. Atur Kunci Koneksi. Ini adalah rahasia bersama yang digunakan untuk autentikasi HMAC-SHA256. Semua klien harus menggunakan kunci yang sama.
  3. Klik Simpan.

Aturan firewall:

Pastikan port ini terbuka di PC server dan klien:

  • TCP: 5001, 5002, 5003 (masuk di server, keluar di klien)
  • UDP: 5004 (dua arah untuk streaming layar)

Penting: Semua PC harus berada di jaringan lokal yang sama (subnet). HandyCafe menggunakan mDNS untuk penemuan klien, yang memerlukan konektivitas LAN.

Lihat Pengaturan Jaringan untuk semua opsi jaringan.

Langkah 3: Siapkan Menu Klien

Menu klien adalah peluncur aplikasi yang dilihat pelanggan di desktop mereka. Navigasikan ke Pengaturan > Klien > tab Konten.

  1. Buat kategori. Kelompokkan aplikasi berdasarkan tipe (misalnya Game, Browser, Media Sosial, Alat).
  2. Tambahkan aplikasi ke setiap kategori:
    • Atur nama aplikasi dan deskripsi.
    • Pilih jenis aplikasi: Game, Browser, Link, File, atau App.
    • Atur path eksekutabel atau URI peluncuran.
    • Unggah ikon dan secara opsional gambar poster untuk kartu aplikasi.
  3. Urutkan ulang kategori dan aplikasi menggunakan pegangan seret.
  4. Alihkan visibilitas untuk menampilkan atau menyembunyikan item.
  5. Klik Simpan.

Perubahan dikirimkan ke semua klien yang terhubung secara otomatis secara real-time melalui TCP.

Tips: Gunakan integrasi IGDB untuk mencari metadata dan ikon game secara otomatis.

Lihat Menu Klien untuk dokumentasi lengkap pembangun menu.

Langkah 4: Konfigurasikan Layar Idle dan Tampilan

Layar Idle (Pengaturan > Klien > tab Layar Idle):

Layar idle adalah apa yang dilihat pelanggan saat tidak ada sesi aktif (layar kunci).

  1. Aktifkan slideshow layar idle.
  2. Tambahkan gambar atau video (PNG, JPG, WebP, GIF, MP4, WebM).
  3. Atur durasi per item dan efek transisi (fade, slide, zoom).
  4. Secara opsional aktifkan overlay jam dan tampilan nama kafe dengan warna kustom.
  5. Klik Simpan.

Tampilan (Pengaturan > Klien > tab Tampilan):

Konfigurasikan tampilan desktop online yang digunakan pelanggan selama sesi.

  1. Pilih tema: Neon Arena, Crimson Pulse, atau Emerald Depth.
  2. Pilih preset tata letak: Split Classic, Hero Wide Top, Catalog Wide Bottom, atau Compact Focus.
  3. Konfigurasikan latar belakang: warna solid, gradien, gambar, atau video dengan pengaturan overlay dan blur.
  4. Sesuaikan kepadatan kartu (Besar, Sedang, Ringkas) dan efek hover.
  5. Klik Simpan.

Lihat Layar Idle Klien dan Tampilan Klien untuk semua opsi.

Langkah 5: Uji Desktop Jarak Jauh dan Tangkapan Layar

Verifikasi bahwa manajemen jarak jauh berfungsi:

Tangkapan Layar:

  1. Di Panel Admin, pilih kartu klien online mana pun.
  2. Klik Tangkapan Layar pada kartu klien.
  3. Tangkapan layar dari layar klien muncul di penampil.
  4. Anda dapat mengunduh atau menyegarkan tangkapan layar.

Desktop Jarak Jauh:

  1. Pilih kartu klien online dan klik Desktop Jarak Jauh.
  2. Jendela desktop jarak jauh terbuka dengan streaming H.264 langsung.
  3. Anda dapat mengendalikan mouse dan keyboard di PC jarak jauh.
  4. Sinkronisasi clipboard bekerja antara server dan klien.

Catatan: Desktop jarak jauh menggunakan streaming UDP. Jika video lambat, periksa bandwidth jaringan Anda dan pastikan port UDP 5004 tidak diblokir. Anda juga dapat menyesuaikan bitrate di pengaturan stream (350-25.000 kbps).

Lihat Desktop Jarak Jauh dan Tangkapan Layar untuk semua fitur remote.

Gambaran Arsitektur Jaringan

PC Server (Manajemen)
    |
    |--- TCP (5001) --- Perintah/Respons (bincode + HMAC-SHA256)
    |--- TCP (5002) --- Transfer File
    |--- TCP (5003) --- Kontrol Manajemen Jarak Jauh
    |--- UDP (5004) --- Streaming Layar (H.264)
    |--- mDNS ------- Penemuan Klien (otomatis)
    |
    +-- PC Klien 1
    +-- PC Klien 2
    +-- PC Klien 3
    +-- ...

Apa yang Harus Dilakukan Selanjutnya