Ir al contenido

Proxmox VE에서 xterm.js 대화형 콘솔 설정

VM 및 LXC 컨테이너에서 클립보드 지원과 동적 해상도 조정을 갖춘 최적화된 xterm.js 대화형 터미널을 활성화하는 기술 가이드.

0조회

xterm.js 기반 콘솔을 네이티브 noVNC 뷰어 대신 활성화하면 브라우저에서 복사 및 붙여넣기 지원, 동적 화면 크기 조정, 렌더링 성능이 향상된 부드러운 대화형 터미널을 제공합니다.


Ubuntu Server와 같은 VM이 Proxmox 웹 인터페이스로 인터랙티브 터미널 출력을 전달하려면, 머신 하드웨어에 가상 시리얼 포트를 할당하는 것이 필수적입니다.

단계 A: 하이퍼바이저에서 시리얼 포트 할당

Sección titulada «Paso A: Aprovisionar el Puerto Serie en el Hipervisor»
  1. Proxmox VE 웹 콘솔에 로그인합니다.
  2. 왼쪽 사이드메뉴에서 가상 머신을 선택합니다.
  3. 하드웨어 탭을 탐색합니다.
  4. 추가 버튼을 클릭하고 시리얼 포트를 선택합니다.
  5. 인덱스 0(시리얼 0)을 할당하여 시리얼 포트를 추가합니다.
  6. 하드웨어 패널에서 그래픽 카드 Display를 선택하고 수정을 클릭한 후 컨트롤러를 시리얼 터미널 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 baud 속도)를 추가합니다:
    • 이전 설정:
      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. 기본값 값을 셸로 수정하세요.
  5. 확인을 클릭합니다.
  6. 논리적 변경 사항을 적용하기 위해 LXC 컨테이너를 재시작하세요.

🚀 xterm.js에 대한 액세스 및 상호작용

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

대상 호스트가 초기화되면:

  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.