Ir al contenido

Configuração de Console Interativa xterm.js no Proxmox VE

Guia técnico para habilitar terminais interativos xterm.js otimizados com suporte de área de transferência e ajuste de resolução dinâmico em VMs e contêineres LXC.

0lecturas

Habilitar o console baseado em xterm.js em vez do visualizador nativo noVNC proporciona um terminal interativo fluido com suporte nativo de copiar e colar no navegador, redimensionamento de tela dinâmico e desempenho de renderização superior.


Para que as VMs (por exemplo, Ubuntu Server) canalizem sua saída de terminal interativo para a interface web do Proxmox, é obrigatório provisionar uma interface de porta serial virtual no hardware da máquina.

  1. Faça login no console web do Proxmox VE.
  2. Selecione a máquina virtual no menu lateral esquerdo.
  3. Navegue até a aba Hardware.
  4. Haz clic en el botón desplegable Add y selecciona Serial Port.
  5. Añade el puerto serie asignando el índice 0 (Serial 0).
  6. Selecciona la tarjeta gráfica Display en el panel de hardware, haz clic en Edit y cambia el controlador a Serial terminal 0 (serial0).
  7. Haz clic en OK.

Passo B: Configuração no Sistema Operacional Convidado (Guest OS)

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

Se a porta serial virtual for adicionada no Proxmox, mas não for habilitada no carregador de inicialização do sistema convidado, a tela do console xterm.js ficará preta. É imperativo instruir o kernel do Linux para que replique sua saída:

  1. Acesse a máquina virtual por meio de uma conexão SSH temporária ou pelo console noVNC gráfico.
  2. Edite o arquivo de configuração do gerenciador de inicialização GRUB:
    Ventana de terminal
    sudo nano /etc/default/grub
  3. Localiza la directiva GRUB_CMDLINE_LINUX_DEFAULT e incorpora los parámetros de consola serie (tty0 y ttyS0 a una velocidad de 115200 baudios):
    • Configuración anterior:
      Ventana de terminal
      GRUB_CMDLINE_LINUX_DEFAULT="maybe-ubiquity"
    • Configuración modificada:
      Ventana de terminal
      GRUB_CMDLINE_LINUX_DEFAULT="console=tty0 console=ttyS0,115200"
  4. Guarda los cambios (Ctrl + O, confirma con Enter y sal con Ctrl + X.)
  5. Atualize as diretivas do gerenciador GRUB na partição de inicialização:
    Ventana de terminal
    sudo update-grub
  6. Reinicie o sistema operacional da máquina virtual para aplicar a reconfiguração do kernel:
    Ventana de terminal
    sudo reboot

En entornos de contenedores LXC (como la pasarela de seguridad lxc-portelcore-vpn-01), no es necesario añadir hardware serie virtualizado, puesto que Proxmox gestiona la comunicación directamente a través de interfaces nativas TTY.

  1. Selecione seu contêiner LXC na árvore lateral esquerda do Proxmox.
  2. Navega a la pestaña Options.
  3. Selecciona la opción Console mode y haz doble clic sobre ella.
  4. Modifica el valor de Default a Shell.
  5. Haz clic en OK.
  6. Reinicie o contêiner LXC para propagar as alterações lógicas.

Uma vez que o host de destino tenha sido inicializado:

  1. Dirígete a la barra de menú superior derecha de la máquina virtual o contenedor y haz clic en el botón desplegable Console.
  2. Al estar configurada la pantalla en modo serie, la consola web se conectará automáticamente a la terminal xterm.js.
  3. Se o monitor estiver inativo ou em espera, pressione Enter uma vez para forcar o serviço de autenticaça de Linux a desplegar o prompt de login (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.