在 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»- 登录到 Proxmox VE 网页控制台。
- 在左侧菜单中选择虚拟机。
- 导航到 硬件 选项卡。
- 点击 Add 下拉按钮,然后选择 串行端口。
- 添加串口,分配索引
0(Serial 0)。 - 在硬件面板中选择 显示 卡,点击 编辑,并将控制器更改为 串行终端 0 (serial0)。
- 点击 确定。
步骤 B:在客户操作系统 (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»- 在 Proxmox 左侧树形菜单中选择你的 LXC 容器。
- 导航到 选项 选项卡。
- 选择 控制台模式 选项并双击它。
- 将 默认 值更改为 Shell。
- 点击 确定。
- 重新启动 LXC 容器以应用逻辑更改。
🚀 访问与交互 xterm.js
Sección titulada «🚀 Acceso e Interacción con xterm.js»目标主机初始化后:
- 转到虚拟机或容器的右上角菜单栏,然后点击下拉按钮控制台。
- 当屏幕设置为串行模式时,网络控制台将自动连接到终端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.

