Requisiti di Sistema

Prima di installare HandyCafe nel tuo internet cafe, gaming center o arena esports, verifica che l'hardware e la rete soddisfino i seguenti requisiti.

Requisiti del PC Server

Il server e la tua postazione di gestione. E il PC su cui esegui HandyCafe Server per monitorare e controllare l'intero locale.

Componente	Minimo	Consigliato
Sistema Operativo	Windows 10+ (64-bit), macOS 12 Monterey+, o Linux (64-bit)	Windows 10/11 (64-bit), macOS 12+, o Linux (64-bit)
Processore	Dual-core 2.0 GHz	Quad-core 2.5 GHz+
RAM	4 GB	8 GB+
Spazio su Disco	500 MB (applicazione)	2 GB+ (con registrazioni e screenshot)
Display	1280 x 720	1920 x 1080+
Rete	100 Mbps Ethernet	Gigabit Ethernet

Nota: Se utilizzi il desktop remoto con registrazione sessione, alloca spazio su disco aggiuntivo per le registrazioni MP4 (circa 50-200 MB per ora di registrazione a seconda della qualita).

Nota Linux: HandyCafe e costruito con Tauri v2 che utilizza WebKit2GTK su Linux. Devi installare il pacchetto runtime libwebkit2gtk-4.1 prima di eseguire l'applicazione. Le distribuzioni supportate includono Ubuntu 22.04+, Fedora 38+ e altre distribuzioni che distribuiscono una versione equivalente di WebKit2GTK.

Requisiti del PC Client

Ogni PC destinato ai clienti esegue HandyCafe Client, che si connette al server tramite la rete locale.

Componente	Minimo	Consigliato
Sistema Operativo	Windows 10+ (64-bit), macOS 12 Monterey+, o Linux (64-bit)	Windows 10/11 (64-bit), macOS 12+, o Linux (64-bit)
Processore	Dual-core 1.5 GHz	Quad-core 2.0 GHz+
RAM	2 GB	4 GB+
Spazio su Disco	200 MB	500 MB+
Rete	100 Mbps Ethernet	Gigabit Ethernet

Nota: Questi sono i requisiti solo per il software HandyCafe Client. I tuoi PC avranno bisogno di risorse aggiuntive per i giochi e le applicazioni utilizzati dai clienti.

Requisiti di Rete

Tutti i PC (server e client) devono essere sulla stessa rete locale (LAN).

Porte Richieste

Porta	Protocollo	Direzione	Scopo
5001	TCP	Server: in entrata, Client: in uscita	Comunicazione comandi e risposte
5002	TCP	Bidirezionale	Trasferimento file
5003	TCP	Server: in entrata, Client: in uscita	Canale di controllo gestione remota
5004	UDP	Bidirezionale	Streaming schermo (desktop remoto)

Importante: Queste sono le porte predefinite. Puoi cambiarle nelle Impostazioni di Rete. Se cambi le porte sul server, aggiorna la configurazione del client per farle corrispondere.

Configurazione del Firewall

Windows Firewall: HandyCafe tenta di aggiungere automaticamente le regole del firewall durante l'installazione. Se la configurazione automatica fallisce, aggiungi manualmente le regole in entrata per le porte elencate sopra.
Firewall macOS: Apri Impostazioni di Sistema > Rete > Firewall e consenti le connessioni in entrata per HandyCafe. In alternativa, aggiungi le porte elencate sopra alla lista delle eccezioni del firewall.
Linux (iptables / ufw): Se usi ufw, esegui sudo ufw allow 5001:5004/tcp e sudo ufw allow 5004/udp. Per iptables diretto, aggiungi regole INPUT ACCEPT equivalenti per le porte TCP 5001-5003 e la porta UDP 5004.
Firewall di terze parti: Aggiungi eccezioni per il binario del server HandyCafe sul PC server e il binario del client HandyCafe sui PC client.
Router/Switch: Nessuna configurazione speciale necessaria per il funzionamento solo LAN. Se hai VLAN, assicurati che server e tutti i client siano sulla stessa VLAN o che il routing consenta le porte richieste.

Scoperta Client

HandyCafe utilizza mDNS (multicast DNS) per la scoperta automatica dei client sulla rete locale. Questo richiede:

Tutti i PC sulla stessa sottorete
Traffico multicast non bloccato da switch o router
Se mDNS non funziona (ad esempio tra sottoreti), i client possono connettersi inserendo manualmente l'indirizzo IP del server

Considerazioni sulla Larghezza di Banda

Funzionalita	Larghezza di Banda Approssimativa
Operazioni normali (per client)	< 1 Kbps
Streaming desktop remoto	350 - 25.000 Kbps (configurabile)
Trasferimento sincronizzazione file	Limitato dalla velocita della rete
Cattura screenshot	~100 KB per screenshot

Per un locale tipico con 20-50 PC, una LAN standard a 100 Mbps e sufficiente. Gigabit Ethernet e consigliato se utilizzi frequentemente il desktop remoto per piu PC contemporaneamente.

Requisiti Console

Se gestisci console da gioco (PlayStation, Xbox, ecc.), le console devono essere sulla stessa rete del server. Ogni console e identificata dal suo indirizzo MAC e registrata manualmente nelle Impostazioni Console.