Configuration de la Console Interactive xterm.js dans Proxmox VE
Техническое руководство по включению интерактивных терминалов xterm.js с оптимизированной поддержкой буфера обмена и динамической настройкой разрешения в VM и контейнерах LXC.
Включение консоли на основе xterm.js вместо родного просмотрщика noVNC обеспечивает плавную интерактивную терминальную сессию с родной поддержкой копирования и вставки в браузере, динамическим масштабированием экрана и лучшей производительностью рендеринга.
1. Настройка на виртуальных машинах (VM)
Sección titulada «1. Configuración en Máquinas Virtuales (VM)»Чтобы VM (например, Ubuntu Server) направляли свой интерактивный вывод терминала на веб-интерфейс Proxmox, обязательно настройте виртуальный последовательный порт в оборудовании машины.
Шаг А: Настройка последовательного порта в гипервизоре
Sección titulada «Paso A: Aprovisionar el Puerto Serie en el Hipervisor»- Войдите в веб-консоль Proxmox VE.
- Выберите виртуальную машину в левом боковом меню.
- Перейдите на вкладку Аппаратное обеспечение.
- Нажмите на кнопку Добавить и выберите Последовательный порт.
- Добавьте последовательный порт, присвоив ему индекс
0(Последовательный 0). - Выберите видеокарту Дисплей на панели аппаратного обеспечения, нажмите Редактировать и измените контроллер на Последовательный терминал 0 (serial0).
- Нажмите ОК.
Шаг Б: Настройка в гостевой операционной системе (Guest OS)
Sección titulada «Paso B: Configuración en el Sistema Operativo Invitado (Guest OS)»Если виртуальный последовательный порт добавлен в Proxmox, но не включен в загрузчике гостевой операционной системы, экран консоли xterm.js будет черным. Необходимо проинструктировать ядро Linux о том, чтобы оно реплицировало свой вывод:
- Получите доступ к виртуальной машине через временное SSH-соединение или через графическую консоль noVNC.
- Отредактируйте файл конфигурации загрузчика GRUB:
Ventana de terminal sudo nano /etc/default/grub - Найдите политику
GRUB_CMDLINE_LINUX_DEFAULTи включите параметры последовательной консоли (tty0иttyS0со скоростью 115200 бод):- Предыдущая конфигурация:
Ventana de terminal GRUB_CMDLINE_LINUX_DEFAULT="maybe-ubiquity" - Измененная конфигурация:
Ventana de terminal GRUB_CMDLINE_LINUX_DEFAULT="console=tty0 console=ttyS0,115200"
- Предыдущая конфигурация:
- Сохраните изменения (Ctrl+O, подтвердите Enter и выйдите Ctrl+X).
- Обновите политики загрузчика GRUB на загрузочном разделе:
Ventana de terminal sudo update-grub - Перезагрузите операционную систему виртуальной машины, чтобы применить переконфигурацию ядра:
Ventana de terminal sudo reboot
2. Настройка в контейнерах LXC
Sección titulada «2. Configuración en Contenedores LXC»В средах контейнеров LXC (например, в безопасности lxc-portelcore-vpn-01), нет необходимости добавлять виртуализированное оборудование последовательного порта, поскольку Proxmox управляет связью напрямую через родные интерфейсы TTY.
Уникальная процедура в LXC
Sección titulada «Procedimiento Único en LXC»- Выберите свой контейнер LXC в боковой панели слева в Proxmox.
- Перейдите на вкладку Параметры.
- Выберите параметр Режим консоли и дважды кликните на нем.
- Измените значение По умолчанию на Shell.
- Нажмите ОК.
- Перезапустите контейнер LXC, чтобы распространить логические изменения.
🚀 Доступ и взаимодействие с xterm.js
Sección titulada «🚀 Acceso e Interacción con xterm.js»Как только целевой хост будет инициализирован:
- Перейдите в правый верхний меню машины виртуальной или контейнера и нажмите на кнопку развертывания Console.
- Поскольку экран настроен в серийном режиме, веб-консоль будет автоматически подключена к терминалу xterm.js.
- Если монитор отображается как неактивный или в режиме ожидания, нажмите Enter один раз, чтобы заставить службу аутентификации Linux отобразить приглашение входа (
w-server-login:).
⚡ Контрольный список операций 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.

