Ir al contenido

在 Proxmox VE 中配置 xterm.js 交互式控制台

用于在 VM 和 LXC 容器中启用优化的 xterm.js 交互式终端的实用指南,支持剪贴板功能和动态分辨率调整。

0阅读

启用基于 xterm.js 的控制台而不是原生 noVNC 查看器,可提供具有浏览器原生复制粘贴支持、动态屏幕调整和更优渲染性能的流畅交互式终端。


为了让 VM(例如 Ubuntu Server)将其交互式终端输出传送到 Proxmox 的网页界面,必须在虚拟机管理程序的硬件上分配一个虚拟串行端口。

步骤 A:在虚拟机管理程序中分配串行端口

Sección titulada «Paso A: Aprovisionar el Puerto Serie en el Hipervisor»
  1. 登录到 Proxmox VE 网页控制台。
  2. 在左侧菜单中选择虚拟机。
  3. 导航到 硬件 选项卡。
  4. 点击 Add 下拉按钮,然后选择 串行端口。
  5. 添加串口,分配索引 0(Serial 0)。
  6. 在硬件面板中选择 显示 卡,点击 编辑,并将控制器更改为 串行终端 0 (serial0)。
  7. 点击 确定。

如果在 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

在 LXC 容器环境中(例如安全网关 lxc-portelcore-vpn-01),无需添加虚拟串口硬件,因为 Proxmox 直接通过原生 TTY 接口管理通信。

  1. 在 Proxmox 左侧树形菜单中选择你的 LXC 容器。
  2. 导航到 选项 选项卡。
  3. 选择 控制台模式 选项并双击它。
  4. 将 默认 值更改为 Shell。
  5. 点击 确定。
  6. 重新启动 LXC 容器以应用逻辑更改。

目标主机初始化后:

  1. 转到虚拟机或容器的右上角菜单栏,然后点击下拉按钮控制台。
  2. 当屏幕设置为串行模式时,网络控制台将自动连接到终端xterm.js。
  3. 如果显示器处于非活动或待机状态,请按一次 Enter,以强制 Linux 认证服务显示登录提示符 (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.