Déploiement
UnyDesk se déploie comme un service autonome. Le point public important est qu'il possède son propre runtime, sa propre API et son propre chemin de distribution host.
Modèle runtime
Le service repose sur :
- Un backend Go
- Une adresse HTTP principale d'écoute
- Un HTTP/3 natif optionnel lorsque les certificats sont configurés
- Des assets frontend statiques
- Des fichiers de réglage pour utilisateurs, hosts, hosts approuvés et identité publique
- Des artefacts de téléchargement host servis depuis le répertoire configuré
Modèle reverse proxy
Pour une exposition Internet, le modèle habituel est :
- Exposer
UnyDeskderrière un reverse proxy - Transmettre les headers d'hôte et d'adresse client d'origine
- Garder les cookies et CSRF cohérents avec l'URL publique
- Exposer les chemins websocket pour les canaux host et session
- Terminer TLS au proxy sauf activation volontaire du TLS/HTTP3 natif
Endpoints publics à préserver
Les déploiements doivent préserver :
/healthz/api/v1/info/api/v1/auth/*/api/v1/bootstrap/*/api/v1/hosts/api/v1/hosts/ws/api/v1/sessions/download/host/*
Si ces routes sont réécrites incorrectement, le frontend peut charger alors que le pairing host ou le routage session échoue.
Attendu opérationnel
Un déploiement correct doit permettre d'ouvrir l'UI, télécharger un package host, s'authentifier ou utiliser une invitation bornée, voir la présence host et créer une session sans changer les noms produits ni basculer dans les menus TRINITY ou UnyPort.