Ir al contenido

Configuration de la console interactive xterm.js sur Proxmox VE

Guide technique pour l'activation de terminaux interactifs xterm.js optimisés avec support du presse-papiers et ajustement dynamique de la résolution dans les VM et les conteneurs LXC.

0vues

Enabling the console based on xterm.js instead of the native noVNC viewer provides a fluid interactive terminal with native copy and paste support in the browser, dynamic screen resizing and superior rendering performance.


1. Configuration des Machines Virtuelles (VM)

Sección titulada «1. Configuración en Máquinas Virtuales (VM)»

Pour que les VM (par exemple, Ubuntu Server) canalisent leur sortie de terminal interactif vers l'interface web de Proxmox, il est obligatoire de provisionner une interface de port série virtuel dans le matériel de la machine.

Étape A : Provisionner le Port Série sur l'Hyperviseur

Sección titulada «Paso A: Aprovisionar el Puerto Serie en el Hipervisor»
  1. Connectez-vous à la console web de Proxmox VE.
  2. Sélectionnez la machine virtuelle dans le menu latéral gauche.
  3. Navigate to the Hardware tab.
  4. Cliquez sur le bouton déroulant Add et sélectionnez Serial Port.
  5. Ajoutez le port série en attribuant l'index 0 (Serial 0).
  6. Sélectionnez la carte graphique Display dans le panneau matériel, cliquez sur Edit et changez le pilote pour Serial terminal 0 (serial0).
  7. Cliquez sur OK.

Étape B : Configuration dans le Système d'Exploitation Invité (Guest OS)

Sección titulada «Paso B: Configuración en el Sistema Operativo Invitado (Guest OS)»

Si le port série virtuel est ajouté dans Proxmox mais n'est pas activé dans le chargeur d'amorçage du système invité, l'écran de la console xterm.js s'affichera en noir. Il est impératif d'indiquer au noyau Linux de répliquer sa sortie :

  1. Accédez à la machine virtuelle via une connexion SSH temporaire ou via la console graphique noVNC.
  2. Edit the GRUB bootloader configuration file:
    Ventana de terminal
    sudo nano /etc/default/grub
  3. Locate the GRUB_CMDLINE_LINUX_DEFAULT policy and incorporate the serial console parameters (tty0 and ttyS0 at a speed of 115200 bauds):
    • Previous configuration:
      Ventana de terminal
      GRUB_CMDLINE_LINUX_DEFAULT="maybe-ubiquity"
    • Modified configuration:
      Ventana de terminal
      GRUB_CMDLINE_LINUX_DEFAULT="console=tty0 console=ttyS0,115200"
  4. Enregistrez les modifications (Ctrl + O, confirmez avec Entrée et quittez avec Ctrl + X).
  5. Update the GRUB bootloader policies on the boot partition:
    Ventana de terminal
    sudo update-grub
  6. Restart the virtual machine operating system to apply the kernel reconfiguration:
    Ventana de terminal
    sudo reboot

Dans les environnements de conteneurs LXC (comme la passerelle de sécurité lxc-portelcore-vpn-01), il n'est pas nécessaire d'ajouter de matériel série virtualisé, car Proxmox gère la communication directement via des interfaces TTY natives.

  1. Sélectionnez votre conteneur LXC dans l'arborescence latérale gauche de Proxmox.
  2. Allez à l'onglet Options.
  3. Sélectionnez l'option Console mode et double-cliquez dessus.
  4. Modifiez la valeur de Default en Shell.
  5. Cliquez sur OK.
  6. Redémarrez le conteneur LXC pour propager les modifications logiques.

Une fois que l'hôte de destination a été initialisé :

  1. Go to the top right menu bar of the virtual machine or container and click on the Console dropdown button.
  2. With the screen configured in serial mode, the web console will automatically connect to the xterm.js terminal.
  3. Si le moniteur s'affiche comme étant inactif ou en veille, appuyez une fois sur Enter pour forcer le service d'authentification Linux à afficher l'invite de connexion (w-server-login:).

  • ✓ Hardware Serial: Interfaz virtual Serial 0 añadida y vinculada al controlador Display en Proxmox.
  • ✓ Redirección de Kernel: Parámetro console=ttyS0 configurado en el cargador GRUB y compilado con éxito.
  • ✓ Terminal LXC: Parámetro de consola de contenedor ajustado a modo Shell y reiniciado correctamente.