HandyCafe Docs
it-admin

Sinkronisasi File

Sinkronisasi File mendistribusikan file dari HandyCafe Server ke PC klien di seluruh jaringan. Gunakan untuk mendorong pembaruan game, file konfigurasi, penginstal perangkat lunak, dan aset menu klien tanpa harus mengunjungi setiap mesin.

Ini menggunakan pendekatan berbasis manifest sehingga hanya file yang berubah atau baru yang dikirim, yang membuat sinkronisasi berulang menjadi cepat.

Halaman ini berada di Settings > File Sync.

Aktifkan Sinkronisasi Klien

Tombol di kanan atas halaman mengontrol seluruh fitur. Saat Enable Client Sync dimatikan, halaman melaporkan bahwa sinkronisasi klien dijeda dan tindakan publikasi serta penghapusan diblokir. Aktifkan sebelum Anda mempublikasikan apa pun.

Publikasikan Sumber Sinkronisasi

Bagian Publish Sync Source adalah tempat sinkronisasi dibuat. Ini memerlukan dua nilai:

Field Apa itu
Source Path File atau folder di server yang ingin Anda distribusikan. Gunakan Pick File atau Pick Folder untuk memilihnya, atau ketik jalurnya langsung.
Target Path On Clients Jalur absolut di mana konten harus ditempatkan pada setiap klien. Ini tidak opsional. Contoh: C:\Games\SteamLibrary\common\Game atau /opt/apps/game.

Jalur target harus valid di mesin klien, bukan di server. Jika klien Anda menyimpan game mereka di D: dan Anda memasukkan jalur C:, sinkronisasi akan mendarat di tempat yang salah.

Pilih Publish Sync setelah kedua kolom terisi. Konten disajikan ke klien langsung dari jalur sumber. Server tidak menyimpan salinan kedua.

Cara Kerja Sinkronisasi

Perbandingan Berbasis Manifest

Saat sinkronisasi dimulai, server menghasilkan file manifest: daftar setiap file yang akan disinkronkan beserta checksum-nya. Setiap klien membandingkan manifest ini dengan file lokalnya sendiri.

  • File yang tidak ada di klien ditandai untuk diunduh.
  • File yang checksum-nya berbeda (berarti telah dimodifikasi) ditandai untuk diunduh.
  • File yang cocok dilewati sepenuhnya.

Hanya delta antara server dan klien yang ditransfer, yang membuat sinkronisasi berulang menjadi cepat.

Transfer Berbasis Chunk

File besar dibagi menjadi chunk yang lebih kecil untuk ditransfer melalui TCP:

  • Keandalan. Jika sebuah chunk gagal, hanya chunk itu yang diulang, bukan seluruh file.
  • Pelacakan kemajuan. Kemajuan transfer dilaporkan pada level chunk.
  • Efisiensi jaringan. Ukuran chunk disesuaikan untuk kondisi LAN yang umum.

Transfer menggunakan File Port khusus dari Network Settings, 5002 secara default. Jika port tersebut diblokir oleh firewall, tidak ada file yang akan mencapai klien.

Folder yang Disinkronkan

Daftar Synced Folders menunjukkan satu baris per jalur target, masing-masing dengan rilis terbaru yang dipublikasikan. Sebuah baris melaporkan jumlah rilis, jumlah file, dan total ukuran. Gunakan Refresh untuk memuat ulang daftar.

Pilih sebuah baris untuk membuka detailnya di sebelah kanan. Panel detail mencantumkan setiap entri dalam sumber tersebut dengan jalurnya, jenis (file atau direktori), ukuran dan checksum, bersama dengan jalur root sumber, jalur target, dan waktu publikasi. Kotak pencarian memfilter entri berdasarkan jalur relatif atau target.

Menghapus Sinkronisasi

Ada dua tindakan hapus yang berbeda. Mereka melakukan hal yang berbeda:

  • Remove Synced Folder menghapus jalur target dari daftar sinkronisasi. File sumber Anda di server tidak tersentuh.
  • Delete Entry menghapus item dari jalur sumber asli di server. Ini permanen dan juga didorong ke klien. HandyCafe meminta konfirmasi terlebih dahulu.

Kedua tindakan memerlukan Enable Client Sync untuk diaktifkan.

Kasus Penggunaan

  • Menerapkan pembaruan game. Dorong patch game ke semua PC gaming sekaligus sehingga setiap mesin menjalankan versi yang sama.
  • Mendorong file konfigurasi. Distribusikan pengaturan jaringan yang diperbarui atau preferensi aplikasi ke semua klien.
  • Mendistribusikan perangkat lunak. Instal aplikasi di PC klien dengan menyinkronkan paket penginstal atau aplikasi portabel.
  • Memperbarui aset menu klien. Sinkronkan ikon baru, poster, atau file media yang digunakan oleh menu klien.

Tips

  • Jadwalkan sinkronisasi besar selama jam-jam sepi agar sesi aktif tidak bersaing untuk bandwidth.
  • Periksa kembali jalur target sebelum mempublikasikan. Ini adalah penyebab paling umum dari sinkronisasi yang tampaknya berhasil tetapi tidak muncul di klien.
  • Server dan klien harus berada di LAN yang sama.

Halaman Terkait