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»- Proxmox VE 웹 콘솔에 로그인합니다.
- 왼쪽 사이드메뉴에서 가상 머신을 선택합니다.
- 하드웨어 탭을 탐색합니다.
- 추가 버튼을 클릭하고 시리얼 포트를 선택합니다.
- 인덱스
0(시리얼 0)을 할당하여 시리얼 포트를 추가합니다. - 하드웨어 패널에서 그래픽 카드 Display를 선택하고 수정을 클릭한 후 컨트롤러를 시리얼 터미널 0 (serial0)으로 변경합니다.
- 확인을 클릭합니다.
단계 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 baud 속도)를 추가합니다:- 이전 설정:
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 컨테이너를 선택하세요.
- 옵션 탭으로 이동하세요.
- 콘솔 모드 옵션을 선택하고 두 번 클릭하세요.
- 기본값 값을 셸로 수정하세요.
- 확인을 클릭합니다.
- 논리적 변경 사항을 적용하기 위해 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.

