Problèmes d'affichage du bureau

Écran noir ou vide#

Vous ouvrez le viewer VNC et voyez un rectangle noir au lieu de votre bureau.

Votre bureau est encore en train de démarrer#

C'est la cause la plus fréquente. La connexion VNC peut s'établir avant que l'environnement graphique ait fini de se lancer. Il faut que le processus d'initialisation se termine et que l'environnement de bureau se charge, ce qui prend jusqu'à 60 secondes après la création de la VM.

Attendez que le tableau de bord affiche running. S'il affiche déjà running, patientez encore 15 à 20 secondes le temps que le serveur d'affichage s'initialise.

Votre bureau s'est arrêté#

Si votre bureau marchait et que l'écran est devenu noir, la VM a peut-être été arrêtée ou a planté.

Retournez au tableau de bord et vérifiez le statut. S'il affiche stopped, relancez-le. S'il affiche running mais que l'écran reste noir, rafraîchissez la page.

Résolution d'affichage#

Il arrive que le viewer VNC ne négocie pas correctement la résolution, ce qui donne un écran noir ou partiellement rendu.

Rafraîchissez l'onglet du navigateur. Le client VNC se reconnectera et renégociera l'affichage.

Le viewer ne se connecte pas#

Le viewer affiche "Échec de la connexion au bureau" ou "Ce bureau est déconnecté" avec un bouton "Reconnecter", ou reste sur "Connexion au bureau...". Si le viewer lui-même ne se charge pas, il affiche "Échec de la connexion VNC" avec un bouton "Réessayer".

Votre bureau n'est pas encore en running#

Le proxy WebSocket ne transmet les connexions qu'aux bureaux démarrés avec une adresse IP confirmée. Si votre bureau est encore en pending ou booting, la connexion échouera.

Attendez que le statut passe à running avant d'ouvrir le viewer.

Réseau ou pare-feu#

Si vous êtes derrière un pare-feu d'entreprise, les connexions WebSocket peuvent être bloquées.

Testez sur un autre réseau (partage de connexion mobile, par exemple). Si ça marche ailleurs, c'est votre pare-feu qui bloque.

Compatibilité navigateur#

Le viewer fonctionne mieux dans les navigateurs modernes. Les vieux navigateurs ou les extensions de confidentialité agressives peuvent interférer avec les WebSocket.

Utilisez une version récente de Chrome, Firefox ou Edge. Désactivez temporairement les extensions pour vérifier.

Clavier ou souris ne fonctionnent pas#

Vous voyez votre bureau mais les saisies clavier et les clics ne passent pas.

Problème de focus#

Le canvas VNC doit avoir le focus pour capter les saisies. Si vous avez cliqué en dehors du viewer ou changé d'onglet, les saisies ne sont plus transmises.

Cliquez sur la zone du viewer VNC pour lui redonner le focus. Si ça ne marche pas, rafraîchissez la page.

Disposition du clavier#

Le viewer envoie des keycodes bases sur votre clavier local. La VM utilise un clavier US par défaut. Si vous avez un clavier différent, certains caractères spéciaux peuvent ne pas correspondre.

Presse-papiers#

Le copier-coller entre votre machine et la session VNC ne fonctionne pas via le protocole VNC.

Utilisez le terminal pour les opérations qui nécessitent le presse-papiers. Le terminal supporte le copier-coller standard.

Si rien ne marche#

Essayez dans l'ordre :

1. Rafraîchissez la page pour forcer une nouvelle connexion WebSocket
2. Essayez un autre navigateur
3. Vérifiez que votre bureau est en running
4. Arrêtez et relancez votre bureau pour réinitialiser le serveur d'affichage
5. Si le problème touche plusieurs bureaux, écrivez à contact@spinestudio.dev