HandyCafe Docs
it-admin

Primii pași: Administrator IT

Acest ghid acoperă configurarea tehnică a HandyCafe. La final, veți avea serverul și clienții instalați, rețeaua configurată, meniurile de aplicații construite și gestionarea la distanță testată.

Timp de finalizare: 5 minute (plus timpul de distribuire a clienților)

Pasul 1: Instalarea serverului și clienților

Instalarea serverului:

  1. Verificați că PC-ul server îndeplinește cerințele de sistem.
  2. Descărcați și instalați Serverul HandyCafe pe PC-ul de management.
  3. Lansați serverul și finalizați Asistentul de configurare inițială pentru a crea contul de administrator.
  4. Notați adresa IP locală a PC-ului server. Clienții vor avea nevoie de aceasta pentru conectare.

Instalarea clientului (repetați pentru fiecare PC):

  1. Descărcați HandyCafe Client pe fiecare PC destinat clienților.
  2. Instalați și lansați clientul.
  3. Clientul caută serverul în rețeaua locală folosind descoperirea mDNS.
  4. Dacă serverul nu este găsit automat, introduceți adresa IP a serverului manual în setările clientului.
  5. Odată conectat, clientul apare în Panoul de administrare al serverului.

Sfat: Folosiți funcția de denumire automată a serverului (Setări > Clienți) pentru a numi automat clienții cu un prefix precum "PC #1", "PC #2" etc. Puteți personaliza numele afișate ulterior.

Consultați Instalarea serverului și Instalarea clientului pentru pașii detaliați.

Pasul 2: Configurarea setărilor de rețea

Navigați la Setări > Rețea pe server.

HandyCafe folosește patru porturi pentru comunicare:

Port Implicit Scop
Port TCP 5001 Comunicare comenzi și răspunsuri
Port fișiere 5002 Transfer de fișiere între server și clienți
Port gestionare la distanță 5003 Controlul streaming-ului desktop-ului la distanță
Port UDP 5004 Date de streaming ecran

Configurare:

  1. Setați porturile (valorile implicite funcționează pentru majoritatea configurărilor).
  2. Setați Cheia de conexiune. Aceasta este un secret partajat folosit pentru autentificarea HMAC-SHA256. Toți clienții trebuie să folosească aceeași cheie.
  3. Dați clic pe Salvare.

Reguli de firewall:

Asigurați-vă că aceste porturi sunt deschise atât pe server cât și pe PC-urile client:

  • TCP: 5001, 5002, 5003 (întrare pe server, ieșire pe clienți)
  • UDP: 5004 (bidirecțional pentru streaming ecran)

Important: Toate PC-urile trebuie să fie în aceeași rețea locală (subrețea). HandyCafe folosește mDNS pentru descoperirea clienților, ceea ce necesită conectivitate LAN.

Consultați Setări rețea pentru toate opțiunile de rețea.

Pasul 3: Configurarea meniului clientului

Meniul clientului este lansatorul de aplicații pe care clienții il văd pe desktop. Navigați la Setări > Clienți > tab-ul Conținut.

  1. Creați categorii. Grupați aplicațiile pe tip (de exemplu, Jocuri, Browsere, Social Media, Instrumente).
  2. Adăugați aplicații în fiecare categorie:
    • Setați numele aplicației și descrierea.
    • Alegeți tipul aplicației: Joc, Browser, Link, Fișier sau Aplicație.
    • Setați calea executabilului sau URI-ul de lansare.
    • Încărcați o pictogramă și opțional o imagine poster pentru cardul aplicației.
  3. Reordonați categoriile și aplicațiile folosind mânerele de tragere.
  4. Comutați vizibilitatea pentru a afișa sau ascunde elemente.
  5. Dați clic pe Salvare.

Modificările sunt transmise automat tuturor clienților conectați în timp real prin TCP.

Sfat: Folosiți integrarea IGDB pentru a căuta automat metadate și pictograme de jocuri.

Consultați Meniul clientului pentru documentația completă a constructorului de meniu.

Pasul 4: Configurarea ecranului de inactivitate și a aspectului

Ecranul de inactivitate (Setări > Clienți > tab-ul Ecran inactiv):

Ecranul de inactivitate este ceea ce văd clienții când nicio sesiune nu este activă (ecranul de blocare).

  1. Activați prezentarea ecranului de inactivitate.
  2. Adăugați imagini sau videoclipuri (PNG, JPG, WebP, GIF, MP4, WebM).
  3. Setați durata per element și efectul de tranziție (estompare, glisare, zoom).
  4. Opțional activați suprapunerea ceasului și afișarea numelui cafe-ului cu culori personalizate.
  5. Dați clic pe Salvare.

Aspectul (Setări > Clienți > tab-ul Aspect):

Configurați aspectul desktop-ului online pe care clienții il folosesc în timpul sesiunilor.

  1. Selectați o temă: Neon Arena, Crimson Pulse sau Emerald Depth.
  2. Alegeți o presetare de aranjament: Split Classic, Hero Wide Top, Catalog Wide Bottom sau Compact Focus.
  3. Configurați fundalul: culoare solidă, gradient, imagine sau video cu setări de suprapunere și estompare.
  4. Ajustați densitatea cardurilor (Mare, Medie, Compactă) și efectele hover.
  5. Dați clic pe Salvare.

Consultați Ecranul de inactivitate al clientului și Aspectul clientului pentru toate opțiunile.

Pasul 5: Testarea desktop-ului la distanță și a capturilor de ecran

Verificați că gestionarea la distanță funcționează:

Capturi de ecran:

  1. În Panoul de administrare, selectați orice card de client online.
  2. Dați clic pe Captură de ecran pe cardul clientului.
  3. O captură a ecranului clientului apare în vizualizator.
  4. Puteți descărca sau reimprospatata captura.

Desktop la distanță:

  1. Selectați un card de client online și dați clic pe Desktop la distanță.
  2. Se deschide o fereastră de desktop la distanță cu streaming H.264 live.
  3. Puteți controla mouse-ul și tastatura pe PC-ul la distanță.
  4. Sincronizarea clipboard-ului funcționează între server și client.

Notă: Desktop-ul la distanță folosește streaming UDP. Dacă videoul are intârzieri, verificați lățimea de bandă a rețelei și asigurați-vă că portul UDP 5004 nu este blocat. Puteți de asemenea ajusta bitrate-ul în setările de streaming (350-25.000 kbps).

Consultați Desktop la distanță și Capturi de ecran pentru toate funcțiile de la distanță.

Prezentarea generală a arhitecturii de rețea

PC Server (Management)
    |
    |--- TCP (5001) --- Comenzi/Răspunsuri (bincode + HMAC-SHA256)
    |--- TCP (5002) --- Transfer fișiere
    |--- TCP (5003) --- Control gestionare la distanță
    |--- UDP (5004) --- Streaming ecran (H.264)
    |--- mDNS ------- Descoperire clienți (automată)
    |
    +-- PC Client 1
    +-- PC Client 2
    +-- PC Client 3
    +-- ...

Ce urmează