HandyCafe Docs
it-admin

Bermula: Pentadbir IT

Panduan ini merangkumi persediaan teknikal HandyCafe. Pada akhirnya, anda akan mempunyai pelayan dan klien yang dipasang, rangkaian yang dikonfigurasikan, menu aplikasi yang dibina dan pengurusan jarak jauh yang diuji.

Masa untuk diselesaikan: 5 minit (serta masa penggunaan klien)

Langkah 1: Pasang Pelayan dan Klien

Pemasangan pelayan:

  1. Pastikan PC pelayan anda memenuhi keperluan sistem.
  2. Muat turun dan pasang HandyCafe Server pada PC pengurusan anda.
  3. Lancarkan pelayan dan lengkapkan Wizard Persediaan Pertama untuk mencipta akaun pentadbir.
  4. Catat alamat IP tempatan PC pelayan. Klien memerlukan ini untuk bersambung.

Pemasangan klien (ulang untuk setiap PC):

  1. Muat turun HandyCafe Client pada setiap PC pelanggan.
  2. Pasang dan lancarkan klien.
  3. Klien mencari pelayan pada rangkaian tempatan menggunakan penemuan mDNS.
  4. Jika pelayan tidak ditemui secara automatik, masukkan alamat IP pelayan secara manual dalam tetapan klien.
  5. Setelah bersambung, klien muncul pada Panel Pentadbir pelayan.

Tip: Gunakan ciri penamaan automatik pelayan (Tetapan > Klien) untuk menamakan klien secara automatik dengan awalan seperti "PC #1", "PC #2" dan seterusnya. Anda boleh menyesuaikan nama paparan kemudian.

Lihat Pemasangan Pelayan dan Pemasangan Klien untuk langkah terperinci.

Langkah 2: Konfigurasikan Tetapan Rangkaian

Navigasi ke Tetapan > Rangkaian pada pelayan.

HandyCafe menggunakan empat port untuk komunikasi:

Port Lalai Tujuan
Port TCP 5001 Komunikasi arahan dan respons
Port Fail 5002 Pemindahan fail antara pelayan dan klien
Port Pengurusan Jarak Jauh 5003 Kawalan penstriman desktop jarak jauh
Port UDP 5004 Data penstriman skrin

Konfigurasi:

  1. Tetapkan port (lalai sesuai untuk kebanyakan persediaan).
  2. Tetapkan Kunci Sambungan. Ini adalah rahsia kongsi yang digunakan untuk pengesahan HMAC-SHA256. Semua klien mesti menggunakan kunci yang sama.
  3. Klik Simpan.

Peraturan tembok api:

Pastikan port ini dibuka pada kedua-dua pelayan dan PC klien:

  • TCP: 5001, 5002, 5003 (masuk pada pelayan, keluar pada klien)
  • UDP: 5004 (dwiarah untuk penstriman skrin)

Penting: Semua PC mesti berada pada rangkaian tempatan yang sama (subnet). HandyCafe menggunakan mDNS untuk penemuan klien, yang memerlukan ketersambungan LAN.

Lihat Tetapan Rangkaian untuk semua pilihan rangkaian.

Langkah 3: Sediakan Menu Klien

Menu klien ialah pelancar aplikasi yang pelanggan lihat pada desktop mereka. Navigasi ke Tetapan > Klien > Tab Kandungan.

  1. Cipta kategori. Kumpulkan aplikasi mengikut jenis (contoh: Permainan, Pelayar, Media Sosial, Alatan).
  2. Tambah aplikasi ke setiap kategori:
    • Tetapkan nama aplikasi dan penerangan.
    • Pilih jenis aplikasi: Permainan, Pelayar, Pautan, Fail atau Aplikasi.
    • Tetapkan laluan boleh laksana atau URI pelancaran.
    • Muat naik ikon dan secara pilihan imej poster untuk kad aplikasi.
  3. Susun semula kategori dan aplikasi menggunakan pemegang seret.
  4. Togol keterlihatan untuk menunjukkan atau menyembunyikan item.
  5. Klik Simpan.

Perubahan ditolak ke semua klien yang bersambung secara automatik dalam masa nyata melalui TCP.

Tip: Gunakan integrasi IGDB untuk mencari metadata dan ikon permainan secara automatik.

Lihat Menu Klien untuk dokumentasi pembina menu yang lengkap.

Langkah 4: Konfigurasikan Skrin Tunggu dan Penampilan

Skrin Tunggu (Tetapan > Klien > Tab Skrin Tunggu):

Skrin tunggu ialah apa yang pelanggan lihat apabila tiada sesi aktif (skrin kunci).

  1. Aktifkan tayangan slaid skrin tunggu.
  2. Tambah imej atau video (PNG, JPG, WebP, GIF, MP4, WebM).
  3. Tetapkan tempoh setiap item dan kesan peralihan (pudar, slaid, zum).
  4. Secara pilihan aktifkan tindanan jam dan paparan nama kafe dengan warna tersuai.
  5. Klik Simpan.

Penampilan (Tetapan > Klien > Tab Penampilan):

Konfigurasikan rupa desktop dalam talian yang pelanggan gunakan semasa sesi.

  1. Pilih tema: Neon Arena, Crimson Pulse atau Emerald Depth.
  2. Pilih pratetap susun atur: Split Classic, Hero Wide Top, Catalog Wide Bottom atau Compact Focus.
  3. Konfigurasikan latar belakang: warna pepejal, kecerunan, imej atau video dengan tetapan tindanan dan kabur.
  4. Laraskan kepadatan kad (Besar, Sederhana, Padat) dan kesan hover.
  5. Klik Simpan.

Lihat Skrin Tunggu Klien dan Penampilan Klien untuk semua pilihan.

Langkah 5: Uji Desktop Jarak Jauh dan Tangkapan Skrin

Sahkan bahawa pengurusan jarak jauh berfungsi:

Tangkapan Skrin:

  1. Pada Panel Pentadbir, pilih mana-mana kad klien dalam talian.
  2. Klik Tangkapan Skrin pada kad klien.
  3. Tangkapan skrin klien muncul dalam pemapar.
  4. Anda boleh memuat turun atau memuat semula tangkapan skrin.

Desktop Jarak Jauh:

  1. Pilih kad klien dalam talian dan klik Desktop Jarak Jauh.
  2. Tetingkap desktop jarak jauh dibuka dengan penstriman H.264 secara langsung.
  3. Anda boleh mengawal tetikus dan papan kekunci pada PC jauh.
  4. Penyegerakan papan keratan berfungsi antara pelayan dan klien.

Nota: Desktop jarak jauh menggunakan penstriman UDP. Jika video lambat, periksa lebar jalur rangkaian anda dan pastikan port UDP 5004 tidak disekat. Anda juga boleh melaraskan kadar bit dalam tetapan strim (350-25,000 kbps).

Lihat Desktop Jarak Jauh dan Tangkapan Skrin untuk semua ciri jarak jauh.

Gambaran Keseluruhan Seni Bina Rangkaian

PC Pelayan (Pengurusan)
    |
    |--- TCP (5001) --- Arahan/Respons (bincode + HMAC-SHA256)
    |--- TCP (5002) --- Pemindahan Fail
    |--- TCP (5003) --- Kawalan Pengurusan Jarak Jauh
    |--- UDP (5004) --- Penstriman Skrin (H.264)
    |--- mDNS ------- Penemuan Klien (automatik)
    |
    +-- PC Klien 1
    +-- PC Klien 2
    +-- PC Klien 3
    +-- ...

Apa yang Perlu Dilakukan Seterusnya