Windows 10에 Linux용 Windows 하위 시스템 설치 가이드Windows Subsystem for Linux Installation Guide for Windows 10

WSL(Linux용 Windows 하위 시스템)을 설치하는 데 사용할 수 있는 두 가지 옵션이 있습니다.There are two options available for installing Windows Subsystem for Linux (WSL):

  • 단순화된 설치 (미리 보기 릴리스) : wsl --installSimplified install (preview release): wsl --install

    wsl --install 단순화된 설치 명령을 사용하려면 Windows 참가자 프로그램에 가입하고 Windows 10(OS 빌드 20262 이상)의 미리 보기 빌드를 설치해야 하지만 수동 설치 단계를 따를 필요가 없습니다.The wsl --install simplified install command requires that you join the Windows Insiders Program and install a preview build of Windows 10 (OS build 20262 or higher), but eliminates the need to follow the manual install steps. 관리자 권한으로 명령 창을 열고 wsl --install을 실행하고 다시 시작하기만 하면 WSL을 사용할 준비가 됩니다.All you need to do is open a command window with administrator privileges and run wsl --install, after a restart you will be ready to use WSL.

  • 수동 설치 : 아래에 나열된 여섯 단계를 수행합니다.Manual install: Follow the six steps listed below.

    WSL의 수동 설치 단계는 아래에 나열되어 있으며 모든 버전의 Windows 10에 Linux를 설치하는 데 사용할 수 있습니다.The manual install steps for WSL are listed below and can be used to install Linux on any version of Windows 10.

참고

설치 과정에서 문제가 발생하는 경우 이 페이지의 맨 아래에 있는 설치 문제 해결 섹션을 확인합니다.If you run into an issue during the install process, check the Troubleshooting installation section at the bottom of this page.

Windows 참가자를 위한 단순화된 설치Simplified Installation for Windows Insiders

Linux용 Windows 하위 시스템의 설치 프로세스는 Windows 10의 최신 Windows 참가자 미리 보기 빌드에서 크게 개선되어 아래의 수동 단계를 단일 명령으로 대체합니다.The installation process for Windows Subsystem for Linux has been significantly improved in the latest Windows Insiders preview builds of Windows 10, replacing the manual steps below with a single command.

wsl --install 단순화된 설치 명령을 사용하려면 다음을 수행해야 합니다.In order to use the wsl --install simplified install command, you must:

  • Windows 참가자 프로그램에 참여Join the Windows Insiders Program
  • Windows 10의 미리 보기 빌드(OS 빌드 20262 이상)를 설치합니다.Install a preview build of Windows 10 (OS build 20262 or higher).
  • 관리자 권한으로 명령줄 창을 엽니다.Open a command line windows with Administrator privileges

이러한 요구 사항이 충족되면 WSL을 설치합니다.Once those requirements are met, to install WSL:

  • 관리자 모드에서 연 명령줄에서 다음 명령을 입력합니다. wsl.exe --installEnter this command in the command line you've opened in Admin mode: wsl.exe --install
  • 머신 다시 시작Restart your machine

새로 설치된 Linux 배포를 처음 시작하면 콘솔 창이 열리고 파일의 압축이 풀리고 PC에 저장될 때까지 기다리라는 메시지가 표시됩니다.The first time you launch a newly installed Linux distribution, a console window will open and you'll be asked to wait for files to de-compress and be stored on your PC. 이후의 모든 시작은 1초도 걸리지 않습니다.All future launches should take less than a second.

새 Linux 배포를 위한 사용자 계정 및 암호를 만들어야 합니다.You will then need to create a user account and password for your new Linux distribution.

축하합니다! Windows 운영 체제와 완전히 통합된 Linux 배포를 성공적으로 설치하고 설정했습니다.CONGRATULATIONS! You've successfully installed and set up a Linux distribution that is completely integrated with your Windows operating system!

--install 명령은 다음 작업을 수행됩니다.The --install command performs the following actions:

  • 선택 사항인 WSL 및 Virtual Machine 플랫폼 구성 요소를 사용하도록 설정합니다.Enables the optional WSL and Virtual Machine Platform components
  • 최신 Linux 커널을 다운로드하여 설치합니다.Downloads and installs the latest Linux kernel
  • WSL 2를 기본값으로 설정합니다.Sets WSL 2 as the default
  • Linux 배포 (재부팅이 필요할 수 있음) 를 다운로드하여 설치합니다.Downloads and installs a Linux distribution (reboot may be required)

기본적으로 설치된 Linux 배포는 Ubuntu입니다.By default, the installed Linux distribution will be Ubuntu. 이 값은 wsl --install -d <Distribution Name>을 사용하여 변경할 수 있습니다.This can be changed using wsl --install -d <Distribution Name>. (<Distribution Name>을 원하는 배포 이름으로 바꿉니다.) wsl --install -d <Distribution Name> 명령을 사용하여 초기 설치 후 머신에 Linux 배포를 추가할 수 있습니다.(Replacing <Distribution Name> with the name of your desired distribution.) Additional Linux distributions may be added to your machine after the initial install using the wsl --install -d <Distribution Name> command.

사용 가능한 Linux 배포 목록을 보려면 wsl --list --online을 입력합니다.To see a list of available Linux distributions, enter wsl --list --online.

수동 설치 단계Manual Installation Steps

Windows 참가자 빌드를 사용하지 않는 경우 WSL에 필요한 기능을 아래 단계에 따라 수동으로 활성화해야 합니다.If you are not on a Windows Insiders build, the features required for WSL will need to be enabled manually following the steps below.

1단계 - Linux용 Windows 하위 시스템 사용Step 1 - Enable the Windows Subsystem for Linux

Windows에서 Linux 배포를 설치하려면 먼저 "Linux용 Windows 하위 시스템" 옵션 기능을 사용하도록 설정합니다.You must first enable the "Windows Subsystem for Linux" optional feature before installing any Linux distributions on Windows.

PowerShell을 관리자 권한으로 열어 실행합니다.Open PowerShell as Administrator and run:

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

이제 2단계로 이동하여 WSL 2로 업데이트하는 것이 좋습니다. 그러나 WSL 1만 설치하려면 이제 머신을 다시 시작 하여 6단계 - 선택한 Linux 배포 설치로 이동할 수 있습니다.We recommend now moving on to step #2, updating to WSL 2, but if you wish to only install WSL 1, you can now restart your machine and move on to Step 6 - Install your Linux distribution of choice. WSL 2로 업데이트하려면 머신이 다시 시작될 때까지 기다린 후 다음 단계로 이동합니다.To update to WSL 2, wait to restart your machine and move on to the next step.

2단계 - WSL 2 실행을 위한 요구 사항 확인Step 2 - Check requirements for running WSL 2

WSL 2로 업데이트하려면 Windows 10을 실행해야 합니다.To update to WSL 2, you must be running Windows 10.

  • x64 시스템의 경우: 버전 1903 이상, 빌드 18362 이상For x64 systems: Version 1903 or higher, with Build 18362 or higher.
  • ARM64 시스템의 경우: 버전 2004 이상, 빌드 19041 이상For ARM64 systems: Version 2004 or higher, with Build 19041 or higher.
  • 18362보다 낮은 빌드는 WSL 2를 지원하지 않습니다.Builds lower than 18362 do not support WSL 2. Windows Update Assistant를 사용하여 Windows 버전을 업데이트합니다.Use the Windows Update Assistant to update your version of Windows.

버전 및 빌드 번호를 확인하려면 Windows 로고 키 + R 을 선택하고, winver 를 입력하고, 확인 을 선택합니다.To check your version and build number, select Windows logo key + R, type winver, select OK. [설정] 메뉴에서 최신 Windows 버전으로 업데이트합니다.Update to the latest Windows version in the Settings menu.

참고

Windows 10 버전 1903 또는 1909를 실행하고 있는 경우 Windows 메뉴에서 "설정"을 열고, "업데이트 및 보안"으로 이동한 다음, "업데이트 확인"을 선택합니다.If you are running Windows 10 version 1903 or 1909, open "Settings" from your Windows menu, navigate to "Update & Security" and select "Check for Updates". 빌드 번호는 18362.1049 이상 또는 18363.1049 이상이고, 부 빌드 번호는 .1049 이상이어야 합니다.Your Build number must be 18362.1049+ or 18363.1049+, with the minor build # over .1049. 자세한 정보: WSL 2 지원이 Windows 10 버전 1903 및 1909에 제공됨.Read more: WSL 2 Support is coming to Windows 10 Versions 1903 and 1909. 문제 해결 지침을 참조하세요.See the troubleshooting instructions.

3단계 - Virtual Machine 기능 사용Step 3 - Enable Virtual Machine feature

WSL 2를 설치하려면 먼저 Virtual Machine 플랫폼 옵션 기능을 사용하도록 설정해야 합니다.Before installing WSL 2, you must enable the Virtual Machine Platform optional feature. 이 기능을 사용하려면 머신에 가상화 기능이 필요합니다.Your machine will require virtualization capabilities to use this feature.

PowerShell을 관리자 권한으로 열어 실행합니다.Open PowerShell as Administrator and run:

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

머신을 다시 시작하여 WSL 설치를 완료하고 WSL 2로 업데이트합니다.Restart your machine to complete the WSL install and update to WSL 2.

4단계 - Linux 커널 업데이트 패키지 다운로드Step 4 - Download the Linux kernel update package

  1. 최신 패키지를 다운로드합니다.Download the latest package:

    참고

    ARM64 머신을 사용하는 경우 ARM64 패키지를 대신 다운로드하세요.If you're using an ARM64 machine, please download the ARM64 package instead. 사용하고 있는 머신의 종류를 잘 모르는 경우 명령 프롬프트 또는 PowerShell을 열고 systeminfo | find "System Type"을 입력합니다.If you're not sure what kind of machine you have, open Command Prompt or PowerShell and enter: systeminfo | find "System Type". 주의: 비 영어 Windows 버전에서는 검색 텍스트를 수정해야 할 수 있습니다(예: 독일어의 경우 systeminfo | find "Systemtyp").Caveat: On non-English Windows versions, you might have to modify the search text, for example, in German it would be systeminfo | find "Systemtyp".

  2. 이전 단계에서 다운로드한 업데이트 패키지를 실행합니다.Run the update package downloaded in the previous step. (실행하려면 두 번 클릭 - 관리자 권한을 요구하는 메시지가 표시되면 '예'를 선택하여 이 설치를 승인합니다.)(Double-click to run - you will be prompted for elevated permissions, select ‘yes’ to approve this installation.)

설치가 완료되면 새 Linux 배포를 설치할 때 WSL 2를 기본 버전으로 설정하는 다음 단계로 이동합니다.Once the installation is complete, move on to the next step - setting WSL 2 as your default version when installing new Linux distributions. (새 Linux 설치를 WSL 1로 설정하려면 이 단계를 건너뜁니다.)(Skip this step if you want your new Linux installs to be set to WSL 1).

참고

자세한 내용은 Windows 명령줄 블로그에서 사용할 수 있는 WSL2 Linux 커널업데이트 변경 문서를 참조하세요.For more information, read the article changes to updating the WSL2 Linux kernel, available on the Windows Command Line Blog.

5단계 - WSL 2를 기본 버전으로 설정Step 5 - Set WSL 2 as your default version

PowerShell을 열고 이 명령을 실행하여 새 Linux 배포를 설치할 때 WSL 2를 기본 버전으로 설정합니다.Open PowerShell and run this command to set WSL 2 as the default version when installing a new Linux distribution:

wsl --set-default-version 2

6단계 - 선택한 Linux 배포 설치Step 6 - Install your Linux distribution of choice

  1. Microsoft Store를 열고 즐겨 찾는 Linux 배포를 선택합니다.Open the Microsoft Store and select your favorite Linux distribution.

    Microsoft Store의 Linux 배포 보기

    각 배포에 대한 Microsoft Store 페이지를 여는 링크는 다음과 같습니다.The following links will open the Microsoft store page for each distribution:

  2. 배포 페이지에서 "가져오기"를 선택합니다.From the distribution's page, select "Get".

    Microsoft Store의 Linux 배포

새로 설치된 Linux 배포를 처음 시작하면 콘솔 창이 열리고 파일이 압축 해제되어 PC에 저장될 때까지 1~2분 정도 기다려야 합니다.The first time you launch a newly installed Linux distribution, a console window will open and you'll be asked to wait for a minute or two for files to de-compress and be stored on your PC. 이후의 모든 시작은 1초도 걸리지 않습니다.All future launches should take less than a second.

새 Linux 배포를 위한 사용자 계정 및 암호를 만들어야 합니다.You will then need to create a user account and password for your new Linux distribution.

Windows 콘솔에서 Ubuntu 압축 풀기

축하합니다! Windows 운영 체제와 완전히 통합된 Linux 배포를 성공적으로 설치하고 설정했습니다.CONGRATULATIONS! You've successfully installed and set up a Linux distribution that is completely integrated with your Windows operating system!

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

Windows 터미널을 사용하면 여러 탭(여러 Linux 명령 프롬프트, Windows 명령 프롬프트, PowerShell, Azure CLI 등 간에 빠르게 전환)을 사용하도록 설정하고, 사용자 지정 키(탭 열기 또는 닫기, 복사 + 붙여넣기 등에 대한 바로 가기 키) 바인딩을 만들고, 검색 기능을 사용하고, 테마(색 구성표, 글꼴 스타일 및 크기, 배경 이미지/흐림/투명도)를 사용자 지정할 수 있습니다.Windows Terminal enables multiple tabs (quickly switch between multiple Linux command lines, Windows Command Prompt, PowerShell, Azure CLI, etc), create custom key bindings (shortcut keys for opening or closing tabs, copy+paste, etc.), use the search feature, and custom themes (color schemes, font styles and sizes, background image/blur/transparency). 자세한 정보Learn more.

Windows 터미널을 설치합니다.Install Windows Terminal.

Windows 터미널

배포 버전을 WSL 1 또는 WSL 2로 설정Set your distribution version to WSL 1 or WSL 2

PowerShell 명령줄을 열고 wsl -l -v 명령을 입력(Windows 빌드 18362 이상에서만 사용 가능)하면 설치한 각 Linux 배포에 할당된 WSL 버전을 확인할 수 있습니다.You can check the WSL version assigned to each of the Linux distributions you have installed by opening the PowerShell command line and entering the command (only available in Windows Build 18362 or higher): wsl -l -v

wsl --list --verbose

두 버전의 WSL에 의해 지원되도록 배포를 설정하려면 다음을 실행합니다.To set a distribution to be backed by either version of WSL please run:

wsl --set-version <distribution name> <versionNumber>

<distribution name>을(를) 배포의 실제 이름으로, <versionNumber>을(를) 숫자 '1' 또는 '2'로 대체해야 합니다.Make sure to replace <distribution name> with the actual name of your distribution and <versionNumber> with the number '1' or '2'. 위와 동일한 명령을 실행하되 '2'를 '1'로 바꾸면 언제든지 WSL 1로 다시 변경할 수 있습니다.You can change back to WSL 1 at anytime by running the same command as above but replacing the '2' with a '1'.

참고

WSL 1에서 WSL 2로 업데이트는 대상 배포 크기에 따라 완료하는 데 몇 분이 걸릴 수 있습니다.The update from WSL 1 to WSL 2 may take several minutes to complete depending on the size of your targeted distribution. Windows 10 1주년 업데이트 또는 Creators Update에서 이전 버전(레거시)의 WSL 1을 실행하는 경우 업데이트 오류가 발생할 수 있습니다.If you are running an older (legacy) installation of WSL 1 from Windows 10 Anniversary Update or Creators Update, you may encounter an update error. 다음 지침에 따라 레거시 배포판을 제거하세요.Follow these instructions to uninstall and remove any legacy distributions.

wsl --set-default-version 결과가 잘못된 명령이면 wsl --help를 입력하세요.If wsl --set-default-version results as an invalid command, enter wsl --help. --set-default-version이 나열되지 않은 경우 OS에서 해당 기능을 지원하지 않으며 버전 1903, 빌드 18362 이상으로 업데이트해야 함을 의미합니다.If the --set-default-version is not listed, it means that your OS doesn't support it and you need to update to version 1903, Build 18362 or higher. ARM64용 빌드 19041을 사용 중인 경우 PowerShell을 사용할 때 이 명령이 실패할 수 있습니다. 이 경우 명령 프롬프트 를 대신 사용하여 wsl.exe 명령을 실행할 수 있습니다.If you are on Build 19041 for ARM64, this command may fail when using PowerShell in which case you can use a Command Prompt instead to issue the wsl.exe command.

명령을 실행한 후 WSL 2 requires an update to its kernel component. For information please visit https://aka.ms/wsl2kernel이라는 메시지가 표시되는 경우가 있습니다.If you see this message after running the command: WSL 2 requires an update to its kernel component. For information please visit https://aka.ms/wsl2kernel. 이 경우에도 MSI Linux 커널 업데이트 패키지를 설치해야 합니다.You still need to install the MSI Linux kernel update package.

또한 WSL 2를 기본 아키텍처로 설정하려는 경우 이 명령을 사용하여 수행할 수 있습니다.Additionally, if you want to make WSL 2 your default architecture you can do so with this command:

wsl --set-default-version 2

이렇게 하면 WSL 2에 설치된 모든 새 배포 버전이 설정됩니다.This will set the version of any new distribution installed to WSL 2.

설치 문제 해결Troubleshooting installation

관련 오류 및 제안된 수정 사항은 다음과 같습니다.Below are related errors and suggested fixes. 다른 일반적인 오류 및 해결 방법에 대해서는 WSL 문제 해결 페이지를 참조하세요.Refer to the WSL troubleshooting page for other common errors and their solutions.

  • 0x80070003 오류로 인한 설치 실패Installation failed with error 0x80070003

    • Linux용 Windows 하위 시스템은 시스템 드라이브(일반적으로 C: 드라이브)에서만 실행됩니다.The Windows Subsystem for Linux only runs on your system drive (usually this is your C: drive). 배포가 시스템 드라이브에 저장되어 있는지 확인합니다.Make sure that distributions are stored on your system drive:
    • 설정 -> **시스템 -->**스토리지** -> 더 많은 스토리지 설정을 차례로 엽니다. 새 콘텐츠가 저장된 위치를 변경합니다. C: 드라이브에 앱을 설치하기 위한 시스템 설정에 대한 그림Open Settings -> **System --> Storage -> More Storage Settings: Change where new content is saved Picture of system settings to install apps on C: drive
  • 0x8007019e 오류로 인한 WslRegisterDistribution 실패WslRegisterDistribution failed with error 0x8007019e

    • 선택적인 Linux용 Windows 하위 시스템 구성 요소가 실행되지 않습니다.The Windows Subsystem for Linux optional component is not enabled:
    • 제어판 -> 프로그램 및 기능 -> Windows 기능 사용/사용 안 함 을 차례로 열어 Linux용 Windows 하위 시스템 을 선택하거나 이 문서의 시작 부분에서 설명한 PowerShell cmdlet을 사용합니다.Open Control Panel -> Programs and Features -> Turn Windows Feature on or off -> Check Windows Subsystem for Linux or using the PowerShell cmdlet mentioned at the beginning of this article.
  • 0x80070003 오류 또는 0x80370102 오류로 인해 설치하지 못했습니다.Installation failed with error 0x80070003 or error 0x80370102

    • 컴퓨터 BIOS 내에서 가상화를 사용하도록 설정했는지 확인합니다.Please make sure that virtualization is enabled inside of your computer's BIOS. 이 방법에 대한 지침은 컴퓨터마다 다르며, CPU 관련 옵션에 있을 가능성이 높습니다.The instructions on how to do this will vary from computer to computer, and will most likely be under CPU related options.
    • WSL2를 사용하려면 CPU가 Intel Nehalem 프로세서(Intel Core 1세대) 및 AMD Opteron에 도입된 SLAT(두 번째 수준 주소 변환) 기능을 지원해야 합니다.WSL2 requires that your CPU supports the Second Level Address Translation (SLAT) feature, which was introduced in Intel Nehalem processors (Intel Core 1st Generation) and AMD Opteron. 이전 CPU(예: Intel Core 2 Duo)는 Virtual Machine 플랫폼을 성공적으로 설치하더라도 WSL2를 실행할 수 없습니다.Older CPUs (such as the Intel Core 2 Duo) will not be able to run WSL2, even if the Virtual Machine Platform is successfully installed.
  • 업그레이드 시도 중 오류: Invalid command line option: wsl --set-version Ubuntu 2Error when trying to upgrade: Invalid command line option: wsl --set-version Ubuntu 2

    • Linux용 Windows 하위 시스템을 사용하도록 설정했고 Windows 빌드 버전 18362 이상을 사용하고 있는지 확인합니다.Enure that you have the Windows Subsystem for Linux enabled, and that you're using Windows Build version 18362 or higher. WSL을 실행하도록 하려면 관리자 권한(Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux)으로 PowerShell 프롬프트에서 이 명령을 실행합니다.To enable WSL run this command in a PowerShell prompt with admin privileges: Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux.
  • 가상 디스크 시스템 제한으로 인해 요청한 작업을 완료할 수 없습니다. 가상 하드 디스크 파일은 압축이 풀려 있는 상태이고 암호화되지 않아야 하며 스파스가 아니어야 합니다.The requested operation could not be completed due to a virtual disk system limitation. Virtual hard disk files must be uncompressed and unencrypted and must not be sparse.

    • Linux 배포판의 프로필 폴더를 열어서 "내용 압축"과 "내용 암호화"를 선택 취소합니다.Deselect “Compress contents” (as well as “Encrypt contents” if that’s checked) by opening the profile folder for your Linux distribution. 이는 Windows 파일 시스템의 USERPROFILE%\AppData\Local\Packages\CanonicalGroupLimited... 같은 폴더에 있을 것입니다.It should be located in a folder on your Windows file system, something like: USERPROFILE%\AppData\Local\Packages\CanonicalGroupLimited...
    • 이 Linux 배포판 프로필에는 LocalState 폴더가 있을 것입니다.In this Linux distro profile, there should be a LocalState folder. 이 폴더를 마우스 오른쪽 단추로 클릭하여 옵션 메뉴를 표시합니다.Right-click this folder to display a menu of options. 속성 > 고급을 선택하고 "내용을 압축하여 디스크 공간 절약" 및 "데이터 보호를 위해 내용을 암호화" 확인란이 선택 취소되어 있는지 확인합니다(선택하지 않음).Select Properties > Advanced and then ensure that the “Compress contents to save disk space” and “Encrypt contents to secure data” checkboxes are unselected (not checked). 이를 현재 폴더 또는 모든 하위 폴더와 파일에만 적용할지 묻는 메시지가 표시되면 압축 플래그만 지우도록 "이 폴더만"을 선택합니다.If you are asked whether to apply this to just to the current folder or to all subfolders and files, select “just this folder” because you are only clearing the compress flag. 그러면 wsl --set-version 명령이 작동할 것입니다.After this, the wsl --set-version command should work.

WSL 배포판 속성 설정의 스크린샷

참고

이 예에서는 Ubuntu 18.04 배포판의 LocalState 폴더가 C:\Users<my-user-name>\AppData\Local\Packages\CanonicalGroupLimited.Ubuntu18.04onWindows_79rhkp1fndgsc에 있습니다.In my case, the LocalState folder for my Ubuntu 18.04 distribution was located at C:\Users<my-user-name>\AppData\Local\Packages\CanonicalGroupLimited.Ubuntu18.04onWindows_79rhkp1fndgsc

이 문제에 대한 업데이트된 정보를 추적할 수 있는 WSL Docs GitHub 스레드 #4103을 확인하세요.Check WSL Docs GitHub thread #4103 where this issue is being tracked for updated information.

  • cmdlet, 함수, 스크립트 파일 또는 실행 프로그램의 이름에는 'wsl'이라는 단어가 들어갈 수 없습니다.The term 'wsl' is not recognized as the name of a cmdlet, function, script file, or operable program.

  • 오류: 이 업데이트는 Linux용 Windows 하위 시스템을 사용하는 머신에만 적용됩니다.Error: This update only applies to machines with the Windows Subsystem for Linux.

    • Linux 커널 업데이트 MSI 패키지를 설치하려면 WSL이 필요하며, 먼저 이를 사용하도록 설정해야 합니다.To install the Linux kernel update MSI package, WSL is required and should be enabled first. 실패하면 This update only applies to machines with the Windows Subsystem for Linux 메시지가 표시됩니다.If it fails, it you will see the message: This update only applies to machines with the Windows Subsystem for Linux.
    • 이 메시지가 표시되는 세 가지 가능한 원인은 다음과 같습니다.There are three possible reason you see this message:
    1. WSL 2를 지원하지 않는 이전 버전의 Windows를 아직 사용하고 있습니다.You are still in old version of Windows which doesn't support WSL 2. 버전 요구 사항 및 업데이트에 대한 링크는 2단계를 참조하세요.See step #2 for version requirements and links to update.

    2. WSL을 사용하도록 설정되지 않았습니다.WSL is not enabled. 1단계로 돌아가서 머신에서 선택적 WSL 기능을 사용하도록 설정되어 있는지 확인해야 합니다.You will need to return to step #1 and ensure that the optional WSL feature is enabled on your machine.

    3. WSL을 사용하도록 설정한 후에는 다시 부팅해야 적용됩니다. 머신을 다시 부팅하고 다시 시도하세요.After you enabled WSL, a reboot is required for it to take effect, reboot your machine and try again.

  • 오류: WSL 2에는 커널 구성 요소에 대한 업데이트가 필요합니다. 자세한 내용은 https://aka.ms/wsl2kernel 을 방문하세요.Error: WSL 2 requires an update to its kernel component. For information please visit https://aka.ms/wsl2kernel .

    • Linux 커널 패키지가 %SystemRoot%\system32\lxss\tools 폴더에 없는 경우 이 오류가 발생합니다.If the Linux kernel package is missing in the %SystemRoot%\system32\lxss\tools folder, you will encounter this error. 이러한 설치 지침의 4단계에서 Linux 커널 업데이트 MSI 패키지를 설치하여 이 문제를 해결하세요.Resolve it by installing the Linux kernel update MSI package in step #4 of these installation instructions. '프로그램 추가/제거'에서 MSI를 제거하고 다시 설치해야 할 수 있습니다.You may need to uninstall the MSI from 'Add or Remove Programs', and install it again.