Proxmox VEでのxterm.jsインタラクティブコンソールの設定
VMおよびLXCコンテナでクリップボードサポートとダイナミック解像度調整を最適化したxterm.jsインタラクティブターミナルを有効化する技術ガイド。
0閲覧数
xterm.jsベースのコンソールをネイティブなnoVNCビューアーよりも有効にすることで、ネイティブなブラウザ内コピー&ペーストサポート、ダイナミックスクリーンリサイズ、および優れたレンダリングパフォーマンスを持つフローイングなインタラクティブターミナルを提供します。
Ubuntu ServerなどのVMがインタラクティブターミナルの出力をProxmoxのWebインターフェースに送信するには、マシンのハードウェアで仮想シリアルポートインターフェースをプロビジョニングすることが必須です。
ステップ A: ハイパーバイザーでシリアルポートをプロビジョニングする
Sección titulada «Paso A: Aprovisionar el Puerto Serie en el Hipervisor»- Proxmox VEのWebコンソールにログインします。
- 左側のメニューから仮想マシンを選択します。
- ハードウェアタブに移動します。
- 追加ドロップダウンボタンをクリックし、シリアルポートを選択します。
0のインデックスを割り当ててシリアルポートを追加します(Serial 0)。- ハードウェアパネルの< strong>ディスプレイグラフィックカードを選択し、編集をクリックして、コントローラーを< strong>シリアルターミナル0 (serial0)に変更します。
- OKをクリックします。
ステップ B: ゲストオペレーティングシステム (ゲスト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 - カーネルの再設定を適用するため、仮想マシンの OS を再起動します:
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コンテナを選択します。
- オプションタブに移動します。
- コンソールモードオプションを選択し、二重クリックします。
- 値をデフォルトからシェルに変更します。
- OKをクリックします。
- LXCコンテナを再起動して論理変更を反映してください。
🚀 xterm.jsへのアクセスと操作
Sección titulada «🚀 Acceso e Interacción con xterm.js»ターゲットホストが初期化されたら:
- 仮想マシンまたはコンテナの右上メニューからコンソールドロップダウンボタンをクリックしてください。
- ディスプレイがシリアルモードで構成されているため、Webコンソールは自動的にxterm.jsターミナルに接続します。
- モニターが非アクティブまたは待機状態になっている場合は、Enter キーを 1 回押して、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.

