Ir al contenido

Configuration de la Console Interactive xterm.js dans Proxmox VE

Техническое руководство по включению интерактивных терминалов xterm.js с оптимизированной поддержкой буфера обмена и динамической настройкой разрешения в VM и контейнерах LXC.

0просмотры

Включение консоли на основе 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»
  1. Войдите в веб-консоль Proxmox VE.
  2. Выберите виртуальную машину в левом боковом меню.
  3. Перейдите на вкладку Аппаратное обеспечение.
  4. Нажмите на кнопку Добавить и выберите Последовательный порт.
  5. Добавьте последовательный порт, присвоив ему индекс 0 (Последовательный 0).
  6. Выберите видеокарту Дисплей на панели аппаратного обеспечения, нажмите Редактировать и измените контроллер на Последовательный терминал 0 (serial0).
  7. Нажмите ОК.

Шаг Б: Настройка в гостевой операционной системе (Guest OS)

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

Если виртуальный последовательный порт добавлен в Proxmox, но не включен в загрузчике гостевой операционной системы, экран консоли xterm.js будет черным. Необходимо проинструктировать ядро Linux о том, чтобы оно реплицировало свой вывод:

  1. Получите доступ к виртуальной машине через временное SSH-соединение или через графическую консоль noVNC.
  2. Отредактируйте файл конфигурации загрузчика GRUB:
    Ventana de terminal
    sudo nano /etc/default/grub
  3. Найдите политику 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"
  4. Сохраните изменения (Ctrl+O, подтвердите Enter и выйдите Ctrl+X).
  5. Обновите политики загрузчика GRUB на загрузочном разделе:
    Ventana de terminal
    sudo update-grub
  6. Перезагрузите операционную систему виртуальной машины, чтобы применить переконфигурацию ядра:
    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»
  1. Выберите свой контейнер LXC в боковой панели слева в Proxmox.
  2. Перейдите на вкладку Параметры.
  3. Выберите параметр Режим консоли и дважды кликните на нем.
  4. Измените значение По умолчанию на Shell.
  5. Нажмите ОК.
  6. Перезапустите контейнер LXC, чтобы распространить логические изменения.

🚀 Доступ и взаимодействие с xterm.js

Sección titulada «🚀 Acceso e Interacción con xterm.js»

Как только целевой хост будет инициализирован:

  1. Перейдите в правый верхний меню машины виртуальной или контейнера и нажмите на кнопку развертывания Console.
  2. Поскольку экран настроен в серийном режиме, веб-консоль будет автоматически подключена к терминалу xterm.js.
  3. Если монитор отображается как неактивный или в режиме ожидания, нажмите 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=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.