HandyCafe Docs
it-admin

Cara Mengonfigurasi Pengaturan Jaringan

Panduan ini mencakup konfigurasi jaringan yang diperlukan agar HandyCafe Server dan klien dapat berkomunikasi. Anda akan mempelajari cara mengubah port server, menyiapkan kunci koneksi untuk autentikasi, mengonfigurasi Windows Firewall, memecahkan masalah konektivitas, dan menangani pengaturan multi-VLAN.

Cara Mengubah Port Server

HandyCafe menggunakan beberapa port untuk berbagai jenis komunikasi. Nilai default berfungsi untuk sebagian besar pengaturan. Ubah hanya jika ada konflik dengan aplikasi lain.

Yang Anda butuhkan

  • HandyCafe Server yang berjalan dengan akses admin.
  • Pengetahuan tentang port mana yang sudah digunakan di jaringan Anda (gunakan netstat -an untuk memeriksa).
  • Kemampuan untuk memulai ulang HandyCafe Server setelah melakukan perubahan.

Langkah-langkah

  1. Buka aplikasi HandyCafe Server dan navigasikan ke Settings di sidebar kiri.
  2. Pilih tab Network.
  3. Temukan field TCP Port. Defaultnya adalah 5001. Ubah ke nomor port yang Anda inginkan. Port ini menangani komunikasi perintah dan respons utama antara server dan klien.
  4. Temukan field File Transfer Port dan UDP Port. Ubah jika diperlukan. Port transfer file menangani sinkronisasi aset (ikon, gambar). Port UDP menangani streaming layar untuk desktop jarak jauh.
  5. Klik Save untuk menerapkan konfigurasi port baru.
  6. Mulai ulang aplikasi HandyCafe Server agar perubahan port berlaku.
  7. Perbarui konfigurasi port di setiap HandyCafe Client agar sesuai dengan port server baru. Setiap klien harus dikonfigurasi untuk terhubung ke port yang sama dengan yang didengarkan server.

Hasil yang diharapkan

Setelah dimulai ulang, server mendengarkan di port baru. Klien yang dikonfigurasi dengan port yang cocok berhasil terhubung.

Kesalahan umum

  • Mengubah port server tanpa memperbarui klien. Klien akan gagal terhubung karena masih mencoba menjangkau port lama.
  • Memilih port yang sudah digunakan oleh layanan lain. Server akan gagal mengikat dan tidak akan mulai. Periksa dengan netstat -an | findstr :5001 (ganti 5001 dengan port pilihan Anda) sebelum memutuskan nomor port.
  • Lupa memulai ulang server. Perubahan port tidak berlaku hingga proses server dimulai ulang.

Cara Menyiapkan Kunci Koneksi

Kunci koneksi adalah rahasia bersama yang mengautentikasi komunikasi antara server dan klien. Setiap pesan TCP diautentikasi menggunakan HMAC-SHA256 dengan kunci ini. Tanpa kunci yang cocok, klien tidak dapat terhubung.

Yang Anda butuhkan

  • HandyCafe Server yang berjalan.
  • Akses ke semua PC klien untuk memperbarui konfigurasi mereka.

Langkah-langkah

  1. Navigasikan ke Settings > Network di aplikasi HandyCafe Server.
  2. Temukan field Connection Key.
  3. Masukkan rahasia bersama yang kuat. Gunakan kombinasi huruf, angka, dan simbol. Kunci harus memiliki minimal 16 karakter. Contohnya: hC!2026$NetCafe#Secure.
  4. Klik Save.
  5. Di setiap PC HandyCafe Client, buka pengaturan klien dan masukkan kunci koneksi yang sama persis. Kunci harus cocok karakter per karakter, termasuk huruf besar-kecil dan karakter khusus.

Hasil yang diharapkan

Semua klien dengan kunci yang cocok berhasil terhubung. Perangkat mana pun tanpa kunci yang benar ditolak oleh server. Ini mencegah mesin yang tidak sah bergabung dengan jaringan Anda.

Kesalahan umum

  • Mengetik kunci secara berbeda di server dan klien. Bahkan perbedaan satu karakter menyebabkan kegagalan autentikasi. Salin dan tempel kunci untuk menghindari kesalahan ketik.
  • Menggunakan kunci yang sangat pendek atau sederhana seperti "1234" atau "password." Meskipun sistem menerima string apa pun, kunci yang lemah memberikan sedikit keamanan.
  • Lupa memperbarui satu atau dua PC klien setelah mengubah kunci. Klien-klien tersebut akan muncul sebagai terputus hingga kuncinya diperbarui.

Cara Mengonfigurasi Windows Firewall

Windows Firewall memblokir koneksi masuk secara default. Anda harus membuat aturan untuk mengizinkan lalu lintas HandyCafe.

Yang Anda butuhkan

  • Akses administrator di PC server.
  • Nomor port yang digunakan HandyCafe Server Anda (default: TCP 5001, 5002, 5003 dan UDP 5004).

Langkah-langkah

  1. Buka Windows Firewall with Advanced Security. Tekan Win+R, ketik wf.msc, dan tekan Enter.
  2. Di panel kiri, klik Inbound Rules.
  3. Di panel kanan, klik New Rule.
  4. Pilih Port sebagai jenis aturan dan klik Next.
  5. Pilih TCP, masukkan 5001 di field specific local ports, dan klik Next. Pilih Allow the connection dan klik Next. Centang semua profil (Domain, Private, Public) dan klik Next. Beri nama aturan "HandyCafe TCP 5001" dan klik Finish.
  6. Ulangi langkah 3 hingga 5 untuk TCP port 5002 (transfer file) dan TCP port 5003. Buat masing-masing sebagai aturan terpisah dengan nama yang deskriptif.
  7. Buat satu aturan lagi. Kali ini pilih UDP sebagai ganti TCP, masukkan 5004 untuk port, dan ikuti langkah yang sama. Beri nama "HandyCafe UDP 5004."
  8. Verifikasi bahwa keempat aturan muncul di daftar Inbound Rules dan menampilkan tanda centang hijau yang menunjukkan bahwa aturan tersebut diaktifkan.

Hasil yang diharapkan

Windows Firewall mengizinkan koneksi masuk di semua port HandyCafe. PC klien kini dapat menjangkau server melalui firewall.

Kesalahan umum

  • Membuat aturan outbound sebagai ganti aturan inbound. Server membutuhkan aturan inbound untuk menerima koneksi dari klien. Koneksi outbound biasanya diizinkan secara default.
  • Lupa aturan UDP. Tanpanya, streaming desktop jarak jauh tidak akan berfungsi meskipun komunikasi perintah (TCP) berfungsi normal.
  • Memilih hanya profil "Domain". Jika jaringan Anda diklasifikasikan sebagai Private atau Public oleh Windows, aturan tidak akan berlaku. Centang ketiga profil untuk keamanan.

Cara Memecahkan Masalah Konektivitas Klien

Ikuti proses sistematis ini ketika klien tidak dapat terhubung ke server.

Yang Anda butuhkan

  • Akses ke PC server dan PC klien yang terpengaruh.
  • Command prompt atau terminal di kedua mesin.

Langkah-langkah

  1. Verifikasi server sedang berjalan. Di PC server, konfirmasikan bahwa aplikasi HandyCafe Server terbuka dan halaman utama menampilkan Admin Panel. Jika server tidak berjalan, mulailah.

  2. Ping server dari klien. Di PC klien, buka command prompt dan jalankan ping [server-ip] (ganti dengan alamat IP server Anda yang sebenarnya). Jika ping gagal, masalah ada di lapisan jaringan. Periksa kabel, switch, dan konfigurasi IP. Klien dan server harus berada di jaringan yang sama atau memiliki rute di antara mereka.

  3. Periksa apakah port server mendengarkan. Di PC server, buka command prompt dan jalankan netstat -an | findstr :5001 (ganti 5001 dengan TCP port yang Anda konfigurasikan). Anda seharusnya melihat baris yang menampilkan LISTENING di port tersebut. Jika tidak, server gagal mengikat ke port. Periksa konflik port.

  4. Periksa aturan firewall. Di PC server, verifikasi bahwa aturan Windows Firewall dari bagian di atas ada dan diaktifkan. Menonaktifkan sementara firewall (lalu mengaktifkan kembali) dapat mengonfirmasi apakah firewall adalah masalahnya.

  5. Verifikasi kunci koneksi cocok. Di PC klien, buka pengaturan HandyCafe Client dan konfirmasikan kunci koneksi identik dengan yang ada di server. Kunci yang tidak cocok menyebabkan klien tampak seolah tidak dapat terhubung sama sekali. Server menolak autentikasi secara diam-diam.

  6. Periksa penemuan mDNS. Klien HandyCafe menggunakan mDNS untuk secara otomatis menemukan server di jaringan lokal. Jika mDNS diblokir (beberapa jaringan terkelola menonaktifkan multicast), klien tidak dapat menemukan server secara otomatis. Dalam hal ini, masukkan alamat IP server secara manual dalam konfigurasi klien.

Hasil yang diharapkan

Dengan mengikuti langkah-langkah ini secara berurutan, Anda mengisolasi masalah ke lapisan tertentu: jaringan, port, firewall, autentikasi, atau penemuan. Sebagian besar masalah konektivitas diselesaikan di langkah 2 (jaringan) atau langkah 4 (firewall).

Kesalahan umum

  • Melewatkan langkah 1. Jika aplikasi server tidak berjalan, tidak ada hal lain yang penting.
  • Mengasumsikan firewall bukan masalahnya karena "kemarin masih berfungsi." Pembaruan Windows terkadang mengatur ulang aturan firewall atau mengklasifikasikan ulang profil jaringan.

Cara Menyiapkan HandyCafe di Beberapa VLAN

Dalam jaringan yang lebih besar, server dan klien mungkin berada di VLAN (virtual local area network) yang berbeda. Karena siaran mDNS tidak melintasi batas VLAN, penemuan otomatis tidak akan berfungsi.

Yang Anda butuhkan

  • Alamat IP statis server.
  • Routing yang dikonfigurasi antar VLAN pada switch atau router jaringan Anda.
  • Aturan firewall yang mengizinkan lalu lintas HandyCafe antar VLAN.

Langkah-langkah

  1. Tetapkan alamat IP statis ke PC HandyCafe Server. Alamat yang ditetapkan DHCP dapat berubah, merusak konfigurasi klien. Konfigurasikan IP statis melalui Windows Network Settings atau fitur reservasi server DHCP Anda.

  2. Di setiap HandyCafe Client, buka konfigurasi klien dan masukkan alamat IP server secara manual alih-alih mengandalkan penemuan otomatis.

  3. Masukkan TCP port dan kunci koneksi yang benar di konfigurasi setiap klien.

  4. Pada router jaringan atau switch layer-3, pastikan lalu lintas pada port HandyCafe (TCP 5001-5003, UDP 5004 secara default) diizinkan untuk merutekan antara VLAN server dan VLAN klien.

  5. Uji konektivitas dari klien di VLAN jarak jauh dengan melakukan ping ke IP server. Kemudian verifikasi bahwa HandyCafe Client terhubung dan muncul di Admin Panel server.

Hasil yang diharapkan

PC klien di VLAN yang berbeda terhubung ke server menggunakan alamat IP yang dikonfigurasi secara manual. Semua fitur berfungsi seperti pada jaringan subnet tunggal.

Kesalahan umum

  • Menggunakan DHCP untuk server tanpa reservasi. Jika IP server berubah, setiap klien kehilangan koneksinya.
  • Lupa mengizinkan lalu lintas UDP antar VLAN. Koneksi TCP mungkin berfungsi (perintah berhasil) sementara lalu lintas UDP diblokir (streaming desktop jarak jauh gagal).
  • Tidak memperhitungkan aturan firewall antar-VLAN pada switch terkelola. Switch enterprise sering memblokir lalu lintas antar-VLAN secara default.