WSL2, WSA 또는 Docker가 실행되지 않음

증상

wsl 명령이 Linux를 시작하는 대신 오류로 종료되고, Docker Desktop은 가상화 또는 Hyper-V를 사용할 수 없다고 보고하며, Android 앱과 Android Studio 에뮬레이터가 시작되지 않습니다.

일반적인 원인

가상화 구성 요소 — Hyper-V 및 관련 항목 — 가 “최적화 프로그램”, 트윅 모음집에 의해 비활성화되었거나 Windows 업데이트 실패 후 손상되었습니다. 이것들이 없으면 WSL2, WSA 및 Docker는 자체 가상 머신을 시작할 수 없습니다. 가상화는 보안 하위 시스템에서도 사용됩니다: BoosterX 설정과의 연관성은 «VBS (Virtualization Based Security)» 문서에 설명되어 있습니다.

BoosterX에서의 수정

BoosterX → «수정» 섹션(왼쪽 메뉴)을 엽니다.
검색에 «Linux»를 입력합니다.
«Linux (WSL2), WSA (Android Studio), Docker» 카드를 열고 **«수정»**을 누릅니다.
Windows를 재부팅합니다.

수정은 Hyper-V를 복원하고 WSL 작동에 필요한 Windows 구성 요소를 활성화합니다. BoosterX는 공식 웹사이트 boosterx.org에서 다운로드할 수 있습니다.

확인 방법

터미널을 열고 wsl을 실행하세요 — Linux 콘솔이 열려야 합니다. 그런 다음 Docker Desktop과 Android 앱을 실행하세요: 두 환경 모두 가상화 오류 없이 시작되어야 합니다.

BoosterX 없이 수동 대안

제어판 → 프로그램 → 프로그램 및 기능 → Windows 기능 켜기 또는 끄기를 열고 «Linux용 Windows 하위 시스템»과 «가상 머신 플랫폼»을 체크합니다; 사용 가능한 에디션에서는 «Hyper-V»도 체크합니다. 확인을 누르고 구성 요소 설치를 기다린 후 PC를 재부팅합니다. 그런 다음 터미널에서 wsl --update을 실행하여 WSL 커널을 업데이트합니다.

도움이 되지 않았다면

Windows가 가상화가 비활성화되었다고 보고하면 BIOS/UEFI에서 활성화 여부를 확인하세요. 다음으로 오류와 시간이 일치하는 Windows 이벤트 로그 항목을 확인하세요 — 사건 분석에는 EventX가 도움이 됩니다. BoosterX 수정이 도움이 되지 않았거나 문제가 다시 발생하면 지원에 오류 텍스트를 첨부하여 문의하세요.

최종 확인: 2026-09-20. 전체 수정 카탈로그.