Initialiser l'accès distant VNC (client Linux)

Sur un client Linux, après connexion à la console web 10888 (voir Mettre à jour le client Linux), une carte « Initialiser VNC » apparaît. Un clic configure VNC et le signale à la console, qui peut alors se connecter à ce client à distance. Dans la grande majorité des cas, c'est entièrement automatique, sans configuration manuelle ; ce n'est que lorsque le flux automatique est bloqué par l'environnement (x11vnc absent, bureau Wayland, etc.) que la section « Gestion manuelle » ci-dessous est nécessaire.

Ce que fait l'initialisation en un clic

Après un clic sur « Initialiser VNC », le client (vdclient, exécuté en tant que root) effectue automatiquement, dans l'ordre :

1. Désactive la fenêtre de plantage Apport (Ubuntu/Debian uniquement) : empêche la fenêtre « Un problème de programme système a été détecté » d'apparaître sur le bureau qui va être pris en main, au cas où l'installation de x11vnc échoue.
2. Vérifie le type de session de bureau : s'il s'agit d'une session Wayland, x11vnc ne peut pas capturer l'écran, il vous guide donc pour passer à Xorg (voir le Cas 2).
3. Garantit l'installation de x11vnc : s'il est absent, il l'installe automatiquement en ligne via le gestionnaire de paquets de la distribution (apt / dnf / yum / zypper / pacman).
4. Génère un mot de passe aléatoire dynamique de 8 caractères et l'écrit dans le fichier de mots de passe VNC.
5. Détecte automatiquement les DISPLAY et XAUTHORITY de la session graphique et démarre x11vnc sur :0 au port 9015.
6. Signale automatiquement l'IP, le port 9015 et le mot de passe dynamique au serveur de démarrage, afin que la console puisse se connecter à distance — vous ne saisissez jamais de mot de passe.
7. Écrit un marqueur de démarrage automatique : ensuite, à chaque démarrage du client, vdclient relance automatiquement VNC dès que le bureau et le serveur sont prêts — inutile de cliquer à nouveau.

Le port VNC est fixé à 9015 ; le mot de passe de contrôle est aléatoire, généré dynamiquement à chaque initialisation et signalé automatiquement à la console — il ne peut pas et n'a pas besoin d'être défini manuellement.

Étapes d'initialisation automatique

1. Sur le poste client lui-même, ouvrez http://localhost:10888 dans un navigateur et connectez-vous avec le compte administrateur (par défaut admin / 123456).
2. Sur la carte « Initialiser VNC », cliquez sur le bouton « Initialiser VNC ».
3. Le message « VNC initialisé » indique la réussite — la console peut désormais se connecter à distance.

Gestion manuelle lorsque le logiciel n'y parvient pas automatiquement

Si le clic signale un échec, traitez-le selon le cas ci-dessous. Ensuite, revenez à la console et cliquez à nouveau sur « Initialiser VNC » : vous devez réessayer via le bouton, car seul le bouton signale les informations VNC à la console ; démarrer x11vnc à la main seul ne les signale pas, et la console ne peut pas se connecter.

Cas 1 : x11vnc introuvable et l'installation automatique a échoué

Fréquent lorsque le client n'a pas d'accès réseau ou aucun dépôt configuré. Le message ressemble à « x11vnc introuvable et installation automatique échouée, veuillez l'installer manuellement : apt-get install -y x11vnc ».

Installez x11vnc manuellement dans le terminal du client selon le type de système (vdclient s'exécute en tant que root ; l'installation manuelle nécessite aussi root) :

Système	Commande d'installation
Ubuntu / Debian / Kylin / UOS (basés sur deb)	apt-get install -y x11vnc
openEuler / Anolis / RHEL / CentOS (récents)	dnf install -y x11vnc
RHEL / CentOS (anciens)	yum install -y x11vnc
openSUSE	zypper install x11vnc
Arch	pacman -S x11vnc

Si x11vnc n'est pas dans le dépôt, configurez d'abord un dépôt fonctionnel (ou téléchargez x11vnc et ses dépendances et installez-les hors ligne). Une fois installé, revenez à la console et cliquez à nouveau sur « Initialiser VNC ».

Cas 2 : le bureau est Wayland et VNC ne peut pas capturer l'écran

Des bureaux comme GNOME utilisent par défaut le compositeur Wayland, mais x11vnc capture l'écran via X11 et ne peut pas capturer le bureau sous Wayland. Vous devez passer à une session Xorg.

Bascule automatique depuis la console (recommandé) : après un clic sur « Initialiser VNC », si Wayland est détecté, une boîte de confirmation apparaît :

Le bureau actuel est Wayland, où VNC ne peut pas capturer l'écran. Passer à Xorg redémarrera le gestionnaire d'affichage et fermera la session de bureau actuelle (retour automatique à Xorg en ~15 s). Continuer ?

Après un clic sur OK, le client modifie automatiquement la configuration de GDM (écrit WaylandEnable=false, en sauvegardant l'original sous *.osvbak) et redémarre le gestionnaire d'affichage pour basculer vers Xorg. Une fois le bureau revenu sous Xorg (environ 15 secondes), cliquez à nouveau sur « Initialiser VNC ».

Gestion manuelle si la bascule automatique échoue : s'il signale que la configuration GDM est introuvable, que le redémarrage du gestionnaire d'affichage a échoué, ou que la session est toujours Wayland après la bascule, opérez manuellement dans le terminal du client :

1. Modifiez la configuration de GDM (/etc/gdm3/custom.conf sur Debian/Ubuntu/Kylin/UOS, /etc/gdm/custom.conf sur les systèmes basés sur Red Hat) et ajoutez ou modifiez dans la section [daemon] :

   [daemon]
   WaylandEnable=false

2. Redémarrez le gestionnaire d'affichage (cela ferme la session du bureau actuel, enregistrez donc votre travail d'abord) :

   systemctl restart display-manager

   Vous pouvez aussi simplement redémarrer le client ; ou, sur l'écran de connexion GDM, cliquer sur l'engrenage en bas à droite et choisir « sur Xorg » (on Xorg) avant de vous connecter.

3. Après avoir confirmé que vous êtes dans une session Xorg, revenez à la console et cliquez à nouveau sur « Initialiser VNC ».

WaylandEnable=false déjà défini mais toujours Wayland : en général, la session actuelle ne s'est pas reconnectée — redémarrez le client ou reconnectez-vous à Xorg, puis initialisez à nouveau.

Cas 3 : après la bascule vers Xorg, cliquez encore une fois

La bascule automatique vers Xorg ferme et rouvre la session du bureau (environ 15 secondes), ce qui interrompt cette initialisation. Une fois le bureau revenu, revenez à la console et cliquez à nouveau sur « Initialiser VNC » pour terminer le démarrage et le signalement.

Vérification et dépannage

• Sur le client, vérifiez si x11vnc s'exécute sur le port 9015 :

  pgrep -a x11vnc
  ss -lntp | grep 9015

• Le journal de démarrage se trouve dans log/x11vnc.log, sous le répertoire du programme vdclient ; utilisez-le pour diagnostiquer les échecs (p. ex. DISPLAY/XAUTHORITY introuvables, port occupé, BadMatch de capture, etc.).

• Lorsque la console indique que le client est disponible pour une connexion distante, le signalement a réussi.

Remarques

Cette fonction n'est disponible que sur les clients Linux ; les clients Windows utilisent un lien TightVNC distinct et n'ont pas ce bouton.

Le client doit avoir une session de bureau graphique en cours d'exécution (X/Xorg) ; il ne peut pas être initialisé depuis un terminal en mode texte ni lorsqu'aucun bureau n'est connecté.

Une fois initialisé, il démarre automatiquement au démarrage — inutile de cliquer à nouveau après le redémarrage du client ; à chaque fois (y compris au démarrage automatique), il régénère le mot de passe dynamique et le signale à la console.

Les clients Xinchuang (Kylin, UOS, openEuler, Anolis, etc.) suivent exactement le même flux : traitez les systèmes basés sur deb selon la ligne Kylin / UOS, et ceux basés sur Red Hat selon la ligne openEuler / Anolis.