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.
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.
1. Configuração em Máquinas Virtuais (VM)
Sección titulada «1. Configuración en Máquinas Virtuales (VM)»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.
Passo A: Provisionar a Porta Serial no Hipervisor
Sección titulada «Paso A: Aprovisionar el Puerto Serie en el Hipervisor»- Faça login no console web do Proxmox VE.
- Selecione a máquina virtual no menu lateral esquerdo.
- Navegue até a aba Hardware.
- Haz clic en el botón desplegable Add y selecciona Serial Port.
- Añade el puerto serie asignando el índice 0 (Serial 0).
- Selecciona la tarjeta gráfica Display en el panel de hardware, haz clic en Edit y cambia el controlador a Serial terminal 0 (serial0).
- 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:
- Acesse a máquina virtual por meio de uma conexão SSH temporária ou pelo console noVNC gráfico.
- Edite o arquivo de configuração do gerenciador de inicialização GRUB:
Ventana de terminal sudo nano /etc/default/grub - Localiza la directiva
GRUB_CMDLINE_LINUX_DEFAULTe incorpora los parámetros de consola serie (tty0yttyS0a 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"
- Configuración anterior:
- Guarda los cambios (Ctrl + O, confirma con Enter y sal con Ctrl + X.)
- Atualize as diretivas do gerenciador GRUB na partição de inicialização:
Ventana de terminal sudo update-grub - Reinicie o sistema operacional da máquina virtual para aplicar a reconfiguração do kernel:
Ventana de terminal sudo reboot
2. Configuração em Contêineres LXC
Sección titulada «2. Configuración en Contenedores LXC»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.
Procedimento Único no LXC
Sección titulada «Procedimiento Único en LXC»- Selecione seu contêiner LXC na árvore lateral esquerda do Proxmox.
- Navega a la pestaña Options.
- Selecciona la opción Console mode y haz doble clic sobre ella.
- Modifica el valor de Default a Shell.
- Haz clic en OK.
- Reinicie o contêiner LXC para propagar as alterações lógicas.
🚀 Acesso e Interação com xterm.js
Sección titulada «🚀 Acceso e Interacción con xterm.js»Uma vez que o host de destino tenha sido inicializado:
- 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.
- Al estar configurada la pantalla en modo serie, la consola web se conectará automáticamente a la terminal xterm.js.
- 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:
).
⚡ Checklist de Operação do xterm.js
Sección titulada «⚡ Checklist de Operación de xterm.js»- ✓ Hardware Serial: Interfaz virtual Serial 0 añadida y vinculada al controlador Display en Proxmox.
- ✓ Redirección de Kernel: Parámetro
console=ttyS0configurado en el cargador GRUB y compilado con éxito. - ✓ Terminal LXC: Parámetro de consola de contenedor ajustado a modo Shell y reiniciado correctamente.

