HandyCafe Docs
it-admin

Premiers pas : Administrateur IT

Ce guide couvre la configuration technique de HandyCafe. A la fin, vous aurez le serveur et les clients installes, le reseau configure, les menus d'applications construits et la gestion a distance testee.

Temps necessaire : 5 minutes (plus le temps de deploiement des clients)

Etape 1 : Installer le serveur et les clients

Installation du serveur :

  1. Verifiez que votre PC serveur repond aux exigences systeme.
  2. Telechargez et installez le serveur HandyCafe sur votre PC de gestion.
  3. Lancez le serveur et completez l'assistant de premiere configuration pour creer le compte admin.
  4. Notez l'adresse IP locale du PC serveur. Les clients en auront besoin pour se connecter.

Installation du client (repetez pour chaque PC) :

  1. Telechargez HandyCafe Client sur chaque PC destine aux clients.
  2. Installez et lancez le client.
  3. Le client recherche le serveur sur le reseau local via la decouverte mDNS.
  4. Si le serveur n'est pas trouve automatiquement, saisissez l'adresse IP du serveur manuellement dans les parametres du client.
  5. Une fois connecte, le client apparait dans le panneau d'administration du serveur.

Astuce : Utilisez la fonctionnalite de nommage automatique du serveur (Parametres > Clients) pour nommer automatiquement les clients avec un prefixe tel que "PC #1", "PC #2", etc. Vous pouvez personnaliser les noms d'affichage par la suite.

Consultez Installation du serveur et Installation du client pour les etapes detaillees.

Etape 2 : Configurer les parametres reseau

Rendez-vous dans Parametres > Reseau sur le serveur.

HandyCafe utilise quatre ports pour la communication :

Port Par defaut Fonction
Port TCP 5001 Communication commande/reponse
Port fichier 5002 Transferts de fichiers entre serveur et clients
Port gestion a distance 5003 Controle du streaming bureau a distance
Port UDP 5004 Donnees de streaming d'ecran

Configuration :

  1. Definissez les ports (les valeurs par defaut conviennent a la plupart des configurations).
  2. Definissez la cle de connexion. C'est un secret partage utilise pour l'authentification HMAC-SHA256. Tous les clients doivent utiliser la meme cle.
  3. Cliquez sur Enregistrer.

Regles de pare-feu :

Assurez-vous que ces ports sont ouverts sur le serveur et les PC clients :

  • TCP : 5001, 5002, 5003 (entrant sur le serveur, sortant sur les clients)
  • UDP : 5004 (bidirectionnel pour le streaming d'ecran)

Important : Tous les PC doivent se trouver sur le meme reseau local (sous-reseau). HandyCafe utilise mDNS pour la decouverte des clients, ce qui necessite une connectivite LAN.

Consultez Parametres reseau pour toutes les options reseau.

Etape 3 : Configurer le menu client

Le menu client est le lanceur d'applications que les clients voient sur leur bureau. Rendez-vous dans Parametres > Clients > onglet Contenu.

  1. Creez des categories. Regroupez les applications par type (par exemple Jeux, Navigateurs, Reseaux sociaux, Outils).
  2. Ajoutez des applications a chaque categorie :
    • Definissez le nom et la description de l'application.
    • Choisissez le type d'application : Jeu, Navigateur, Lien, Fichier ou Application.
    • Definissez le chemin de l'executable ou l'URI de lancement.
    • Telechargez une icone et eventuellement une image d'affiche pour la carte de l'application.
  3. Reordonnez les categories et applications a l'aide des poignees de glissement.
  4. Basculez la visibilite pour afficher ou masquer des elements.
  5. Cliquez sur Enregistrer.

Les modifications sont transmises a tous les clients connectes automatiquement en temps reel via TCP.

Astuce : Utilisez l'integration IGDB pour rechercher automatiquement les metadonnees et icones de jeux.

Consultez Menu client pour la documentation complete du constructeur de menus.

Etape 4 : Configurer l'ecran d'inactivite et l'apparence

Ecran d'inactivite (Parametres > Clients > onglet Ecran d'inactivite) :

L'ecran d'inactivite est ce que les clients voient lorsqu'aucune session n'est active (l'ecran de verrouillage).

  1. Activez le diaporama de l'ecran d'inactivite.
  2. Ajoutez des images ou videos (PNG, JPG, WebP, GIF, MP4, WebM).
  3. Definissez la duree par element et l'effet de transition (fondu, glissement, zoom).
  4. Activez eventuellement une superposition d'horloge et un affichage du nom du cafe avec des couleurs personnalisees.
  5. Cliquez sur Enregistrer.

Apparence (Parametres > Clients > onglet Apparence) :

Configurez l'aspect du bureau en ligne que les clients utilisent durant les sessions.

  1. Sélectionnez un thème : Neon Arena, Crimson Pulse ou Emerald Depth.
  2. Choisissez une preconfiguration de mise en page : Split Classic, Hero Wide Top, Catalog Wide Bottom ou Compact Focus.
  3. Configurez l'arriere-plan : couleur unie, degrade, image ou video avec superposition et parametres de flou.
  4. Ajustez la densite des cartes (Grande, Moyenne, Compacte) et les effets de survol.
  5. Cliquez sur Enregistrer.

Consultez Ecran d'inactivite du client et Apparence du client pour toutes les options.

Etape 5 : Tester le bureau a distance et les captures d'ecran

Verifiez que la gestion a distance fonctionne :

Captures d'ecran :

  1. Dans le panneau d'administration, selectionnez n'importe quelle carte de client en ligne.
  2. Cliquez sur Capture d'ecran sur la carte du client.
  3. Une capture d'ecran de l'ecran du client apparait dans le visualiseur.
  4. Vous pouvez telecharger ou actualiser la capture d'ecran.

Bureau a distance :

  1. Selectionnez une carte de client en ligne et cliquez sur Bureau a distance.
  2. Une fenetre de bureau a distance s'ouvre avec un streaming H.264 en direct.
  3. Vous pouvez controler la souris et le clavier sur le PC distant.
  4. La synchronisation du presse-papiers fonctionne entre le serveur et le client.

Remarque : Le bureau a distance utilise le streaming UDP. Si la video est saccadee, verifiez votre bande passante reseau et assurez-vous que le port UDP 5004 n'est pas bloque. Vous pouvez egalement ajuster le debit dans les parametres du flux (350-25 000 kbps).

Consultez Bureau a distance et Captures d'ecran pour toutes les fonctionnalites de gestion a distance.

Vue d'ensemble de l'architecture reseau

PC Serveur (Gestion)
    |
    |--- TCP (5001) --- Commande/Reponse (bincode + HMAC-SHA256)
    |--- TCP (5002) --- Transferts de fichiers
    |--- TCP (5003) --- Controle de gestion a distance
    |--- UDP (5004) --- Streaming d'ecran (H.264)
    |--- mDNS ------- Decouverte des clients (automatique)
    |
    +-- PC Client 1
    +-- PC Client 2
    +-- PC Client 3
    +-- ...

Prochaines etapes