Problemes de connexion VNC

Ecrans noirs, erreurs WebSocket et problemes de saisie dans le viewer VNC.

3 min de lecture

Ecran noir ou vide

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

Le bureau est encore en train de demarrer

C'est la cause la plus frequente. La connexion VNC peut s'etablir avant que l'environnement graphique ait fini de se lancer. Il faut que cloud-init termine et que XFCE charge, ce qui prend jusqu'a 60 secondes apres la creation de la VM.

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

Le bureau s'est arrete

Si le bureau marchait et que l'ecran est devenu noir, la VM a peut-etre ete arretee ou a plante.

Retournez au tableau de bord et verifiez le statut. S'il affiche stopped, relancez-le. S'il affiche running mais que l'ecran reste noir, rafraichissez la page.

Resolution d'affichage

Il arrive que le viewer VNC ne negocie pas correctement la resolution, ce qui donne un ecran noir ou partiellement rendu.

Rafraichissez l'onglet du navigateur. Le client VNC se reconnectera et renegociera l'affichage.

Echec de connexion WebSocket

Vous voyez "WebSocket connection failed" ou le viewer ne se charge pas.

Le bureau n'est pas encore en running

Le proxy WebSocket ne transmet les connexions qu'aux bureaux demarres avec une adresse IP confirmee. Si le bureau est encore en pending ou booting, la connexion echouera.

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

Reseau ou pare-feu

Si vous etes derriere un pare-feu d'entreprise, les connexions WebSocket sur le port 3001 peuvent etre bloquees.

Testez sur un autre reseau (partage de connexion mobile, par exemple). Si ca marche ailleurs, c'est votre pare-feu qui bloque.

Compatibilite navigateur

Le viewer fonctionne mieux dans les navigateurs modernes. Les vieux navigateurs ou les extensions de confidentialite agressives peuvent interferer avec les WebSocket.

Utilisez une version recente de Chrome, Firefox ou Edge. Desactivez temporairement les extensions pour verifier.

Clavier ou souris ne fonctionnent pas

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

Probleme de focus

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

Cliquez sur la zone du viewer VNC pour lui redonner le focus. Si ca ne marche pas, rafraichissez la page.

Disposition du clavier

Le viewer envoie des keycodes bases sur votre clavier local. La VM utilise un clavier US par defaut. Si vous avez un clavier different, certains caracteres speciaux 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 operations qui necessitent le presse-papiers. Le terminal supporte le copier-coller standard.

Si rien ne marche

Essayez dans l'ordre :

  1. Rafraichissez la page pour forcer une nouvelle connexion WebSocket
  2. Essayez un autre navigateur
  3. Verifiez que le bureau est en running
  4. Arretez et relancez le bureau pour reinitialiser le serveur d'affichage
  5. Si le probleme touche plusieurs bureaux, ecrivez a contact@talentai.fr