HandyCafe Docs
it-admin

Per Iniziare: Amministratore IT

Questa guida copre la configurazione tecnica di HandyCafe. Alla fine avrai server e client installati, la rete configurata, i menu app creati e la gestione remota testata.

Tempo per completare: 5 minuti (piu il tempo di distribuzione dei client)

Passo 1: Installa Server e Client

Installazione del server:

  1. Verifica che il tuo PC server soddisfi i requisiti di sistema.
  2. Scarica e installa HandyCafe Server sul tuo PC di gestione.
  3. Avvia il server e completa la Configurazione Guidata Iniziale per creare l'account admin.
  4. Annota l'indirizzo IP locale del PC server. I client ne avranno bisogno per connettersi.

Installazione del client (ripeti per ogni PC):

  1. Scarica HandyCafe Client su ogni PC destinato ai clienti.
  2. Installa e avvia il client.
  3. Il client cerca il server sulla rete locale utilizzando la scoperta mDNS.
  4. Se il server non viene trovato automaticamente, inserisci l'indirizzo IP del server manualmente nelle impostazioni del client.
  5. Una volta connesso, il client appare nel Pannello Admin del server.

Suggerimento: Usa la funzionalita di denominazione automatica del server (Impostazioni > Client) per denominare automaticamente i client con un prefisso come "PC #1", "PC #2", ecc. Puoi personalizzare i nomi visualizzati in seguito.

Consulta Installazione Server e Installazione Client per i passaggi dettagliati.

Passo 2: Configura le Impostazioni di Rete

Vai su Impostazioni > Rete nel server.

HandyCafe utilizza quattro porte per la comunicazione:

Porta Predefinita Scopo
Porta TCP 5001 Comunicazione comandi e risposte
Porta File 5002 Trasferimento file tra server e client
Porta Gestione Remota 5003 Controllo streaming desktop remoto
Porta UDP 5004 Dati streaming schermo

Configurazione:

  1. Imposta le porte (i valori predefiniti funzionano per la maggior parte delle configurazioni).
  2. Imposta la Chiave di Connessione. E un segreto condiviso utilizzato per l'autenticazione HMAC-SHA256. Tutti i client devono utilizzare la stessa chiave.
  3. Clicca Salva.

Regole del firewall:

Assicurati che queste porte siano aperte sia sul server che sui PC client:

  • TCP: 5001, 5002, 5003 (in entrata sul server, in uscita sui client)
  • UDP: 5004 (bidirezionale per lo streaming schermo)

Importante: Tutti i PC devono essere sulla stessa rete locale (sottorete). HandyCafe utilizza mDNS per la scoperta dei client, che richiede connettivita LAN.

Consulta Impostazioni di Rete per tutte le opzioni di rete.

Passo 3: Configura il Menu Client

Il menu client e il launcher di applicazioni che i clienti vedono sul loro desktop. Vai su Impostazioni > Client > Scheda Contenuti.

  1. Crea categorie. Raggruppa le app per tipo (ad esempio Giochi, Browser, Social Media, Strumenti).
  2. Aggiungi app a ogni categoria:
    • Imposta il nome dell'app e la descrizione.
    • Scegli il tipo di app: Gioco, Browser, Link, File o App.
    • Imposta il percorso eseguibile o l'URI di avvio.
    • Carica un'icona e opzionalmente un'immagine poster per la scheda dell'app.
  3. Riordina categorie e app usando i trascinatori.
  4. Attiva/disattiva la visibilita per mostrare o nascondere elementi.
  5. Clicca Salva.

Le modifiche vengono inviate a tutti i client connessi automaticamente in tempo reale tramite TCP.

Suggerimento: Usa l'integrazione IGDB per cercare automaticamente metadati e icone dei giochi.

Consulta Menu Client per la documentazione completa del costruttore di menu.

Passo 4: Configura Schermata di Inattivita e Aspetto

Schermata di Inattivita (Impostazioni > Client > Scheda Schermata di Inattivita):

La schermata di inattivita e cio che i clienti vedono quando nessuna sessione e attiva (la schermata di blocco).

  1. Abilita lo slideshow della schermata di inattivita.
  2. Aggiungi immagini o video (PNG, JPG, WebP, GIF, MP4, WebM).
  3. Imposta la durata per elemento e l'effetto di transizione (dissolvenza, scorrimento, zoom).
  4. Opzionalmente abilita una sovrapposizione orologio e la visualizzazione del nome locale con colori personalizzati.
  5. Clicca Salva.

Aspetto (Impostazioni > Client > Scheda Aspetto):

Configura l'aspetto del desktop online che i clienti utilizzano durante le sessioni.

  1. Seleziona un tema: Neon Arena, Crimson Pulse o Emerald Depth.
  2. Scegli un layout preimpostato: Split Classic, Hero Wide Top, Catalog Wide Bottom o Compact Focus.
  3. Configura lo sfondo: colore solido, gradiente, immagine o video con impostazioni di sovrapposizione e sfocatura.
  4. Regola la densita schede (Grande, Media, Compatta) e gli effetti hover.
  5. Clicca Salva.

Consulta Schermata di Inattivita Client e Aspetto Client per tutte le opzioni.

Passo 5: Testa Desktop Remoto e Screenshot

Verifica che la gestione remota funzioni:

Screenshot:

  1. Nel Pannello Admin, seleziona qualsiasi scheda client online.
  2. Clicca Screenshot sulla scheda del client.
  3. Uno screenshot dello schermo del client appare nel visualizzatore.
  4. Puoi scaricare o aggiornare lo screenshot.

Desktop Remoto:

  1. Seleziona una scheda client online e clicca Desktop Remoto.
  2. Si apre una finestra di desktop remoto con streaming H.264 in tempo reale.
  3. Puoi controllare mouse e tastiera sul PC remoto.
  4. La sincronizzazione degli appunti funziona tra server e client.

Nota: Il desktop remoto utilizza streaming UDP. Se il video e lento, controlla la larghezza di banda della rete e assicurati che la porta UDP 5004 non sia bloccata. Puoi anche regolare il bitrate nelle impostazioni dello streaming (350-25.000 kbps).

Consulta Desktop Remoto e Screenshot per tutte le funzionalita remote.

Panoramica dell'Architettura di Rete

PC Server (Gestione)
    |
    |--- TCP (5001) --- Comandi/Risposte (bincode + HMAC-SHA256)
    |--- TCP (5002) --- Trasferimento File
    |--- TCP (5003) --- Controllo Gestione Remota
    |--- UDP (5004) --- Streaming Schermo (H.264)
    |--- mDNS ------- Scoperta Client (automatica)
    |
    +-- PC Client 1
    +-- PC Client 2
    +-- PC Client 3
    +-- ...

Cosa Fare Dopo