이전 버전 WSL의 수동 설치 단계

간단하게 하려면 일반적으로 wsl --install을 사용하여 Linux용 Windows 하위 시스템을 설치하는 것이 좋지만, 이전 빌드의 Windows를 실행하는 경우에는 수동 설치 단계가 지원되지 않을 수 있습니다. 아래에 수동 설치 단계가 설명되어 있습니다. 설치 과정에서 문제가 발생하는 경우 문제 해결 가이드의 설치 섹션을 참조하세요.

1단계 - Linux용 Windows 하위 시스템 사용

Windows에서 Linux 배포를 설치하려면 먼저 "Linux용 Windows 하위 시스템" 옵션 기능을 사용하도록 설정합니다.

PowerShell을 관리자 권한(시작 메뉴 > PowerShell >에서 관리자 권한으로 실행 >을 마우스 오른쪽 단추로 클릭)으로 열고 다음 명령을 입력합니다.

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

이제 2단계로 이동하여 WSL 2로 업데이트하는 것이 좋습니다. 그러나 WSL 1만 설치하려면 이제 머신을 다시 시작하여 6단계 - 선택한 Linux 배포 설치로 이동할 수 있습니다. WSL 2로 업데이트하려면 머신이 다시 시작될 때까지 기다린 후 다음 단계로 이동합니다.

2단계 - WSL 2 실행을 위한 요구 사항 확인

WSL 2로 업데이트하려면 Windows 10을 실행해야 합니다.

• x64 시스템의 경우: 버전 1903 이상, 빌드 18362.1049 이상.
• ARM64 시스템의 경우: 버전 2004 이상, 빌드 19041 이상

또는 Windows 11.

버전 및 빌드 번호를 확인하려면 Windows 로고 키 + R을 선택하고, winver를 입력하고, 확인을 선택합니다. [설정] 메뉴에서 최신 Windows 버전으로 업데이트합니다.

3단계 - Virtual Machine 기능 사용

WSL 2를 설치하려면 먼저 Virtual Machine 플랫폼 옵션 기능을 사용하도록 설정해야 합니다. 이 기능을 사용하려면 머신에 가상화 기능이 필요합니다.

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

dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

머신을 다시 시작하여 WSL 설치를 완료하고 WSL 2로 업데이트합니다.

4단계 - Linux 커널 업데이트 패키지 다운로드

Linux 커널 업데이트 패키지는 Windows 운영 체제 이미지 내에서 WSL을 실행하기 위해 WSL 2 Linux 커널의 최신 버전을 설치합니다. (더 자주 푸시되는 업데이트와 함께 Microsoft Store에서 WSL을 실행하려면 wsl.exe --install 또는 wsl.exe --update을(를) 사용합니다.)

1. 최신 패키지를 다운로드합니다.

   • x64 머신용 최신 WSL2 Linux 커널 업데이트 패키지

   참고

   ARM64 머신을 사용하는 경우 ARM64 패키지를 대신 다운로드하세요. 사용하고 있는 머신의 종류를 잘 모르는 경우 명령 프롬프트 또는 PowerShell을 열고 systeminfo | find "System Type"을 입력합니다. 주의: 비 영어 Windows 버전에서는 "시스템 유형" 문자열을 변환하여 검색 텍스트를 수정해야 할 수 있습니다. find 명령에 대한 따옴표는 이스케이프해야 할 수도 있습니다. 예를 들어 독일어 systeminfo | find '"Systemtyp"'입니다.

2. 이전 단계에서 다운로드한 업데이트 패키지를 실행합니다. (실행하려면 두 번 클릭 - 관리자 권한을 요구하는 메시지가 표시되면 '예'를 선택하여 이 설치를 승인합니다.)

설치가 완료되면 새 Linux 배포를 설치할 때 WSL 2를 기본 버전으로 설정하는 다음 단계로 이동합니다. (새 Linux 설치를 WSL 1로 설정하려면 이 단계를 건너뜁니다.)

5단계 - WSL 2를 기본 버전으로 설정

PowerShell을 열고 이 명령을 실행하여 새 Linux 배포를 설치할 때 WSL 2를 기본 버전으로 설정합니다.

wsl --set-default-version 2

6단계 - 선택한 Linux 배포 설치

1. Microsoft Store를 열고 즐겨 찾는 Linux 배포를 선택합니다.

   

   각 배포에 대한 Microsoft Store 페이지를 여는 링크는 다음과 같습니다.

   • Ubuntu 18.04 LTS
   • Ubuntu 20.04 LTS
   • Ubuntu 22.04 LTS
   • openSUSE Leap 15.1
   • SUSE Linux Enterprise Server 12 SP5
   • SUSE Linux Enterprise Server 15 SP1
   • Kali Linux
   • Debian GNU/Linux
   • Fedora Remix for WSL
   • Pengwin
   • Pengwin Enterprise
   • Alpine WSL
   • Raft(평가판)
   • Alma Linux

2. 배포 페이지에서 "가져오기"를 선택합니다.

   

새로 설치된 Linux 배포를 처음 시작하면 콘솔 창이 열리고 파일이 압축 해제되어 PC에 저장될 때까지 1~2분 정도 기다려야 합니다. 이후의 모든 시작은 1초도 걸리지 않습니다.

새 Linux 배포를 위한 사용자 계정 및 암호를 만들어야 합니다.

축하합니다! Windows 운영 체제와 완전히 통합된 Linux 배포를 성공적으로 설치하고 설정했습니다.

설치 문제 해결

설치 과정에서 문제가 발생하는 경우 문제 해결 가이드의 설치 섹션을 참조하세요.

배포판 다운로드

Microsoft Store를 사용하여 WSL Linux 배포판을 설치할 수 없는(또는 설치하고 싶지 않은) 몇 가지 시나리오가 있습니다. 사용자가 Microsoft Store를 지원하지 않는 Windows Server 또는 LTSC(장기 서비스) 데스크톱 OS SKU를 실행하고 있거나, 회사 네트워크 정책 및/또는 관리자가 사용자 환경에서 Microsoft Store 사용을 허용하지 않는 경우입니다. 이러한 경우 WSL 자체는 제공되지만 Linux 배포판을 직접 다운로드해야 할 수도 있습니다.

Microsoft Store 앱을 사용할 수 없는 경우 다음 링크를 사용하여 Linux 배포판을 다운로드하고 수동으로 설치하면 됩니다.

• Ubuntu
• Ubuntu 24.04
• Ubuntu 22.04 LTS
• Ubuntu 20.04
• Ubuntu 20.04 ARM
• Ubuntu 18.04
• Ubuntu 18.04 ARM
• Ubuntu 16.04
• Debian GNU/Linux
• Kali Linux
• SUSE Linux Enterprise Server 12
• SUSE Linux Enterprise Server 15 SP2
• SUSE Linux Enterprise Server 15 SP3
• openSUSE Tumbleweed
• openSUSE Leap 15.3
• openSUSE Leap 15.2
• Oracle Linux 8.5
• Oracle Linux 7.9
• Fedora Remix for WSL

이렇게 하면 <distro>.appx 패키지가 선택한 폴더에 다운로드됩니다.

원한다면 명령줄을 통해 원하는 배포판을 다운로드할 수도 있습니다. PowerShell에서 Invoke-WebRequest cmdlet을 사용하면 됩니다. 예를 들어 Ubuntu 20.04를 다운로드하려면 다음을 수행합니다.

Invoke-WebRequest -Uri https://aka.ms/wslubuntu2004 -OutFile Ubuntu.appx -UseBasicParsing

다운로드에 curl 명령줄 유틸리티를 사용할 수도 있습니다. curl을 사용하여 Ubuntu 20.04를 다운로드하려면 다음을 수행합니다.

curl.exe -L -o ubuntu-2004.appx https://aka.ms/wslubuntu2004

이 예제에서는 PowerShell에서 Invoke-WebRequest의 PowerShell curl 별칭이 아닌 실제 curl 실행 파일이 호출되도록 curl이 아닌 curl.exe가 실행됩니다.

배포판이 다운로드되면 다운로드 파일이 들어 있는 폴더로 이동하여 해당 디렉터리에서 다음 명령을 실행합니다. 여기서 app-name은 Linux 배포판 .appx 파일의 이름입니다.

Add-AppxPackage .\app_name.appx

Appx 패키지 다운로드가 완료되면 appx 파일을 두 번 클릭하여 새 배포 실행을 시작할 수 있습니다. (wsl -l 명령은 이 단계가 완료될 때까지 배포가 설치되었음을 표시하지 않습니다.)

Windows Server를 사용 중이거나 위의 명령을 실행하는 동안 문제가 발생하면 Windows Server 설명서 페이지에서 대체 설치 지침을 찾아 .appx 파일을 zip 파일로 변경하여 설치할 수 있습니다.

배포판이 설치되면 지침에 따라 새 Linux 배포판의 사용자 계정 및 암호를 만듭니다.

Windows 터미널 설치(선택 사항)

Windows 터미널을 사용하면 여러 탭 또는 창을 열어 여러 Linux 배포판 또는 다른 명령줄(PowerShell, 명령 프롬프트, Azure CLI 등)을 표시하고 빠르게 전환할 수 있습니다. 고유한 색 구성표, 글꼴 스타일, 크기, 배경 이미지 및 사용자 지정 바로 가기 키를 사용하여 터미널을 원하는 대로 사용자 지정할 수 있습니다. 자세한 정보

Windows 터미널을 설치합니다.