HandyCafe Docs
it-admin

Premiers pas : Administrateur IT

Ce guide couvre la configuration technique de HandyCafe. À la fin, vous aurez le serveur et les clients installés, le réseau configuré, les menus d'applications construits et la gestion à distance testée.

Temps nécessaire : 5 minutes (plus le temps de déploiement des clients)

Étape 1 : Installer le serveur et les clients

Installation du serveur :

  1. Vérifiez que votre PC serveur répond aux exigences système.
  2. Téléchargez et installez le serveur HandyCafe sur votre PC de gestion.
  3. Lancez le serveur et complétez l'assistant de première configuration pour créer le compte admin.
  4. Notez l'adresse IP locale du PC serveur. Les clients en auront besoin pour se connecter.

Installation du client (répétez pour chaque PC) :

  1. Téléchargez HandyCafe Client sur chaque PC destiné aux clients.
  2. Installez et lancez le client.
  3. Le client recherche le serveur sur le réseau local via la découverte mDNS.
  4. Si le serveur n'est pas trouvé automatiquement, saisissez l'adresse IP du serveur manuellement dans les paramètres du client.
  5. Une fois connecté, le client apparaît dans le panneau d'administration du serveur.

Astuce : Utilisez la fonctionnalité de nommage automatique du serveur (Paramètres > Clients) pour nommer automatiquement les clients avec un préfixe 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 étapes détaillées.

Étape 2 : Configurer les paramètres réseau

Rendez-vous dans Paramètres > Réseau sur le serveur.

HandyCafe utilise quatre ports pour la communication :

Port Par défaut Fonction
Port TCP 5001 Communication commande/réponse
Port fichier 5002 Transferts de fichiers entre serveur et clients
Port gestion à distance 5003 Contrôle du streaming bureau à distance
Port UDP 5004 Données de streaming d'écran

Configuration :

  1. Définissez les ports (les valeurs par défaut conviennent à la plupart des configurations).
  2. Définissez la clé de connexion. C'est un secret partagé utilisé pour l'authentification HMAC-SHA256. Tous les clients doivent utiliser la même clé.
  3. Cliquez sur Enregistrer.

Règles 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'écran)

Important : Tous les PC doivent se trouver sur le même réseau local (sous-réseau). HandyCafe utilise mDNS pour la découverte des clients, ce qui nécessite une connectivité LAN.

Consultez Paramètres réseau pour toutes les options réseau.

Étape 3 : Configurer le menu client

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

  1. Créez des catégories. Regroupez les applications par type (par exemple Jeux, Navigateurs, Réseaux sociaux, Outils).
  2. Ajoutez des applications à chaque catégorie :
    • Définissez le nom et la description de l'application.
    • Choisissez le type d'application : Jeu, Navigateur, Lien, Fichier ou Application.
    • Définissez le chemin de l'exécutable ou l'URI de lancement.
    • Téléchargez une icône et éventuellement une image d'affiche pour la carte de l'application.
  3. Réordonnez les catégories et applications à l'aide des poignées de glissement.
  4. Basculez la visibilité pour afficher ou masquer des éléments.
  5. Cliquez sur Enregistrer.

Les modifications sont transmises à tous les clients connectés automatiquement en temps réel via TCP.

Astuce : Utilisez l'intégration IGDB pour rechercher automatiquement les métadonnées et icônes de jeux.

Consultez Menu client pour la documentation complète du constructeur de menus.

Étape 4 : Configurer l'écran d'inactivité et l'apparence

Écran d'inactivité (Paramètres > Clients > onglet Écran d'inactivité) :

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

  1. Activez le diaporama de l'écran d'inactivité.
  2. Ajoutez des images ou vidéos (PNG, JPG, WebP, GIF, MP4, WebM).
  3. Définissez la durée par élément et l'effet de transition (fondu, glissement, zoom).
  4. Activez éventuellement une superposition d'horloge et un affichage du nom du café avec des couleurs personnalisées.
  5. Cliquez sur Enregistrer.

Apparence (Paramètres > 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 préconfiguration de mise en page : Split Classic, Hero Wide Top, Catalog Wide Bottom ou Compact Focus.
  3. Configurez l'arrière-plan : couleur unie, dégradé, image ou vidéo avec superposition et paramètres de flou.
  4. Ajustez la densité des cartes (Grande, Moyenne, Compacte) et les effets de survol.
  5. Cliquez sur Enregistrer.

Consultez Écran d'inactivité du client et Apparence du client pour toutes les options.

Étape 5 : Tester le bureau à distance et les captures d'écran

Vérifiez que la gestion à distance fonctionne :

Captures d'écran :

  1. Dans le panneau d'administration, sélectionnez n'importe quelle carte de client en ligne.
  2. Cliquez sur Capture d'écran sur la carte du client.
  3. Une capture d'écran de l'écran du client apparaît dans le visualiseur.
  4. Vous pouvez télécharger ou actualiser la capture d'écran.

Bureau à distance :

  1. Sélectionnez une carte de client en ligne et cliquez sur Bureau à distance.
  2. Une fenêtre de bureau à distance s'ouvre avec un streaming H.264 en direct.
  3. Vous pouvez contrôler 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 à distance utilise le streaming UDP. Si la vidéo est saccadée, vérifiez votre bande passante réseau et assurez-vous que le port UDP 5004 n'est pas bloqué. Vous pouvez également ajuster le débit dans les paramètres du flux (350-25 000 kbps).

Consultez Bureau à distance et Captures d'écran pour toutes les fonctionnalités de gestion à distance.

Vue d'ensemble de l'architecture réseau

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 étapes