Skip to content

WSL 버전 호환성 가이드 ​

WSL 버전이 WSL Dashboard 의 지원 범위를 벗어난 것으로 감지되면 앱에 경고가 표시됩니다. 지원되지 않는 버전에서 실행하면 두 가지 문제가 발생할 수 있습니다.

  • 데이터에 위험이 있습니다: 압축, 스파스 VHD, 복제, 가져오기, 내보내기 같은 작업은 가상 디스크를 직접 읽고 쓰므로 지원되지 않는 버전에서는 데이터가 손상될 수 있습니다.
  • 일부 기능이 제대로 작동하지 않을 수 있습니다: 예를 들어 [boot], [gpu], [time] 과 같은 구성 항목은 이전 버전에서 지원되지 않습니다.

전체 기능을 사용하기 전에 WSL 을 지원되는 버전으로 업데이트하세요.

1. 현재 버전 확인 ​

관리자 권한으로 PowerShell 을 열고 다음을 실행합니다.

powershell
wsl --version

"WSL Version" 줄의 값을 기록해 두세요. 명령이 오류를 반환하거나 이 줄이 없다면 Windows 에 기본 포함된 이전 버전의 WSL 을 사용하고 있는 것이므로, 아래 업그레이드 단계로 바로 이동하세요.

2. 업그레이드 방법 ​

방법 1: 설치 관리자를 직접 다운로드 (권장 — 더 빠르고 안정적) ​

먼저 공식 릴리스 페이지로 이동합니다.

https://github.com/microsoft/WSL/releases/latest

최신(또는 현재 지원되는) 버전을 선택하고 wsl.<version>.x64.msi 를 다운로드한 뒤(ARM64 장치에서는 arm64 선택) 두 번 클릭하여 설치합니다.

Windows 10 21H2 이상이 필요하며, "Windows 기능 켜기/끄기"에서 "가상 머신 플랫폼" 기능이 활성화되어 있어야 합니다.

방법 2: 명령줄로 업데이트 ​

관리자 권한으로 PowerShell 을 열고 다음을 실행합니다.

powershell
wsl --update

Microsoft Store 를 사용할 수 없다면 대신 강제로 다운로드합니다.

powershell
wsl --update --web-download

3. 업그레이드 후 ​

powershell
wsl --shutdown
wsl --version

버전이 지원 범위 안에 있음을 확인한 뒤 WSL Dashboard 를 완전히 종료하고 다시 시작하면 경고가 사라집니다.

관련 링크 ​