SPICE Windows 게스트 에이전트 커뮤니티 포크 가이드
I refuse to let SPICE die
Hacker News레거시화된 SPICE 프로토콜을 위한 Windows 게스트 에이전트를 커뮤니티가 포크하여 지속적으로 지원하고 있습니다.
- 특히, 실물 GPU 패스스루 환경에서도 마우스 포인터가 끊김 없이 작동하며 클립보드 공유 및 파일 전송 기능을 제공합니다.
- 따라서 QEMU/KVM 기반의 가상 데스크톱 환경에서 Windows 11 같은 최신 게스트 OS를 운영할 때 필수적인 솔루션입니다.
- 본 에이전트는 커뮤니티가 유지하는 포크 버전이므로, 사용 전 UCRT64 셸 환경 등 복잡한 빌드 및 설치 과정을 숙지해야 합니다.
본 자료는 Red Hat에서 더 이상 유지보수하지 않는 SPICE 프로토콜의 Windows 게스트 를 커뮤니티가 포크하여 지속적으로 지원하는 프로젝트에 대한 안내입니다. 이 에이전트는 클라이언트 마우스 모드, 데스크톱 해상도 일치, 텍스트 및 이미지 클립보드 공유, 파일 전송 기능을 제공합니다. 특히 실제 를 패스스루하면서 SPICE 디스플레이 장치를 함께 사용할 때 발생하는 마우스 움직임 손실 문제를 해결하는 기능이 포함되어 있습니다.
이 에이전트는 QEMU/KVM 환경에서 Windows 11과 같은 최신 게스트 OS를 사용하는 경우에 필수적입니다. 설치 후에는 관리자 권한으로 MSI 파일을 실행하여 서비스를 설정하고, SPICE 연결을 재설정해야 합니다. 정상 작동 여부를 확인하기 위해 클립보드(텍스트 및 비트맵 양방향), 파일 전송 기능, 그리고 WDDM QXL 드라이버 사용 시의 동적 해상도 변경 등을 점검할 수 있습니다.
빌드는 UCRT64 셸 환경을 사용하는 것이 권장되며, `install.sh`, `build.sh`, `package.sh` 등의 스크립트를 순차적으로 실행하여 진행됩니다. 또한, GitHub Actions를 통해 x64 UCRT64 MSI가 `windows-2022`에서 빌드되지만, 로컬 개발 환경에서는 CMake와 MSVC도 사용 가능합니다. 이 과정은 복잡한 서명 및 아티팩트 관리를 포함하므로 정확한 절차 준수가 요구됩니다.
용어 풀이
- 에이전트
- 목표를 받으면 스스로 계획을 세우고 도구를 써서 여러 단계의 작업을 해내는 AI.
- GPU
- 많은 계산을 한꺼번에 처리하는 칩. AI 학습과 실행에 가장 많이 써요.