ZVM 설치 프로그램 내부에서 키보드가 아무 반응도 하지 않는다면 가상 머신을 다시 만들기 전에 브라우저 콘솔부터 문제를 해결하세요. VM 화면 내부를 클릭해 입력을 캡처하고, 깨끗한 Chrome 또는 Edge 세션으로 전환한 다음 영어가 아닌 입력 방법을 일시적으로 비활성화하고 다시 테스트하세요.
해결된 한 커뮤니티 사례에서는 Windows 10, Windows 11, Linux Mint, Ubuntu 설치 프로그램에서 모두 문제가 발생했지만, 사용자가 Chrome으로 전환하자 동일한 ZVM이 바로 작동했습니다. 따라서 서로 관련 없는 여러 게스트 운영 체제에서 동일한 키보드 문제가 나타날 때는 브라우저 또는 noVNC 입력 처리를 가장 먼저 의심하는 것이 좋습니다.
문제가 VM인지 브라우저인지 확인하는 방법
하나의 ISO만 실패한다면 게스트 이미지가 문제일 수 있습니다. 서로 관련 없는 네 개의 설치 프로그램이 모두 첫 화면까지 도달하지만 Enter나 Tab을 전혀 인식하지 않는다면, 공통으로 사용되는 웹 콘솔, 브라우저 또는 로컬 입력 방법이 원인일 가능성이 높습니다.
가상 하드웨어를 변경하기 전에 VM 내부에서 마우스가 움직이는지, 콘솔이 특수 동작에 반응하는지 확인하세요. 마우스도 상호 작용하지 않는다면 콘솔에 포커스가 전혀 없을 수 있습니다.
1단계: VM 콘솔 내부를 클릭하세요
웹 기반 VNC 콘솔은 일반적으로 페이지에 포커스가 있고 VM 캔버스를 클릭한 후에만 입력을 캡처합니다. 포인터를 게스트 화면 안으로 이동하고 한 번 클릭한 다음 화살표 키, Enter, Tab 또는 Esc 같은 기본 키를 눌러 보세요.
첫 번째 클릭 후 키보드가 갑자기 작동한다면 게스트 내부에서 변경할 사항은 없습니다.
2단계: Chrome 또는 Edge에서 테스트하세요
브라우저마다 키보드 이벤트, 포커스, 클립보드 동작 및 특수 키 조합 처리 방식이 다를 수 있습니다. 확인된 원 사례에서는 Chrome으로 전환하자 문제가 즉시 해결되었습니다.
noVNC 프로젝트를 참고하면 브라우저에 따라 입력 동작이 달라질 수 있는 이유를 기술적으로 이해하는 데 도움이 됩니다.
3단계: 키를 가로채는 입력 방법을 비활성화하세요
테스트하는 동안 호스트 컴퓨터를 기본 영어 키보드 레이아웃으로 일시적으로 전환하고 IME/문자 조합 모드를 끄세요. 일부 입력 방법은 브라우저가 원격 콘솔로 키 입력을 보내기 전에 키 입력을 변환합니다.
이는 영어가 아닌 키보드를 지원하지 않는다는 뜻이 아닙니다. 입력을 가로채는 한 가지 계층을 제거하기 위한 진단 단계입니다.
4단계: 깨끗한 브라우저 세션에서 테스트하세요
시크릿 창을 열고 ZimaOS에 로그인한 다음 VM을 다시 실행하세요. 키를 재매핑하거나, 비밀번호를 관리하거나, 단축키를 가로채거나, 페이지를 변경하는 확장 프로그램이 웹 콘솔을 방해할 수 있습니다.
일반 프로필에서는 작동하지 않지만 시크릿 세션에서는 VM이 작동한다면 ZVM 설정을 변경하지 말고 확장 프로그램을 하나씩 다시 활성화하세요.
5단계: 물리 키보드를 배제하세요
노트북에서는 내장 키보드와 기본 USB 키보드를 각각 테스트하세요. 가능하다면 다른 컴퓨터에서도 VM을 사용해 보세요. 이를 통해 로컬 장치 또는 운영 체제별 입력 문제와 ZimaOS 측 문제를 빠르게 구분할 수 있습니다.
VM 하드웨어 설정은 언제 확인해야 하나요?
여러 개의 깨끗한 브라우저와 컴퓨터에서 키보드가 작동하지 않는 것을 확인한 후에만 VM 정의를 살펴보세요. 이 시점에서는 게스트에 일반적인 가상 입력 장치가 있는지, 새로 만든 테스트 VM에서도 원래 VM과 동일한 문제가 발생하는지 확인하세요.
ZVM 설정 가이드에서 VM 구성에 관한 전반적인 내용을 확인할 수 있습니다.
처음부터 하지 말아야 할 일
- 서로 관련 없는 여러 게스트 설치 프로그램에서 동일한 문제가 발생한다면 새 ISO를 반복해서 다운로드하지 마세요.
- 브라우저 포커스를 배제하기 전에 libvirt XML을 편집하지 마세요.
- 브라우저 하나가 키 입력을 보내지 못한다는 이유만으로 ZimaOS를 다시 설치하지 마세요.
- 마우스가 작동한다고 해서 키보드 캡처도 올바르게 작동한다고 단정하지 마세요.
FAQ
ZVM에서 마우스 입력은 작동하지만 키보드 입력은 작동하지 않는 이유는 무엇인가요?
브라우저가 포인터 이벤트는 전달하지만 키보드 포커스가 다른 페이지 요소, 확장 프로그램 또는 입력 방법에 남아 있을 수 있습니다. 콘솔을 클릭하고 깨끗한 브라우저에서 테스트하세요.
어떤 브라우저를 먼저 사용해 봐야 하나요?
Chrome으로 문제가 해결된 확인된 커뮤니티 사례가 있으므로 Chrome을 먼저 진단용으로 사용해 보는 것이 좋습니다. Edge도 테스트할 만한 Chromium 기반 브라우저입니다.
VM ISO를 변경해야 하나요?
여러 운영 체제 설치 프로그램에서 동일한 키보드 문제가 발생한다면 변경할 필요가 없습니다. 이러한 패턴은 ISO보다 먼저 콘솔 또는 입력 경로를 의심해야 한다는 뜻입니다.
이 문제를 해결하려면 SSH를 사용해야 하나요?
대개는 그렇지 않습니다. 먼저 브라우저 포커스와 호환성을 확인하세요. 웹 입력 계층을 배제한 후에야 SSH나 VM 정의 변경을 고려할 수 있습니다.
