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

Linux용 Windows 하위 시스템 설치Install the Windows Subsystem for Linux

Windows에서 Linux 배포를 실행하기 전에 "Linux용 Windows 하위 시스템" 옵션 기능을 사용해야 합니다.Before installing any Linux distributions on Windows, you must enable the "Windows Subsystem for Linux" optional feature.

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

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

WSL 1만 설치하려면 지금 머신을 다시 시작하여 선택한 Linux 배포 설치로 이동해야 합니다. 그렇지 않으면 다시 시작될 때까지 기다렸다가 WSL 2로 업데이트로 이동합니다.To only install WSL 1, you should now restart your machine and move on to Install your Linux distribution of choice, otherwise wait to restart and move on to update to WSL 2. WSL 2와 WSL 1비교에 대해 자세히 알아보세요.Read more about Comparing WSL 2 and WSL 1.

WSL 2로 업데이트Update to WSL 2

WSL 2로 업데이트하려면 다음 조건을 충족해야 합니다.To update to WSL 2, you must meet the following criteria:

'가상 머신 플랫폼' 옵션 구성 요소 사용Enable the 'Virtual Machine Platform' optional component

WSL 2를 설치하기 전에 "가상 머신 플랫폼" 옵션 기능을 사용하도록 설정해야 합니다.Before installing WSL 2, you must enable the "Virtual Machine Platform" optional 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.

WSL 2를 기본 버전으로 설정Set WSL 2 as your default version

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

wsl --set-default-version 2

WSL 2 requires an update to its kernel component. For information please visit https://aka.ms/wsl2kernel 명령을 실행한 후 이 메시지가 표시될 수 있습니다.You might see this message after running that command: WSL 2 requires an update to its kernel component. For information please visit https://aka.ms/wsl2kernel. 링크(https://aka.ms/wsl2kernel)를 따라 이동한 다음, 설명서의 해당 페이지에서 MSI를 설치하여 머신에 WSL 2에서 사용할 Linux 커널을 설치합니다.Please follow the link (https://aka.ms/wsl2kernel) and install the MSI from that page on our documentation to install a Linux kernel on your machine for WSL 2 to use. 커널을 설치한 후 명령을 다시 실행합니다. 그러면 메시지가 표시되지 않고 성공적으로 완료될 것입니다.Once you have the kernel installed, please run the command again and it should complete successfully without showing the message.

참고

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에서 해당 기능을 지원하지 않으며 버전 2004, 빌드 19041 이상으로 업데이트해야 함을 의미합니다.If the --set-default-version is not listed, it means that your OS doesn't support it and you need to update to version 2004, Build 19041 or higher.

선택한 Linux 배포 설치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 배포

새 배포 설정Set up a new distribution

새로 설치된 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 압축 풀기

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

PowerShell 명령줄을 열고 wsl -l -v 명령을 입력(Windows 빌드 19041 이상에서만 사용 가능)하면 설치한 각 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 19041 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 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 -> 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.
  • 업그레이드 시도 중 오류: 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 Build 버전 19041 이상을 사용하고 있는지 확인합니다.Please make sure that you have the Windows Subsystem for Linux enabled, and that you're using Windows Build version 19041 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. 전체 WSL 설치 지침은 여기에서 찾을 수 있습니다.You can find the full WSL install instructions here.
  • 가상 디스크 시스템 제한으로 인해 요청한 작업을 완료할 수 없습니다. 가상 하드 디스크 파일은 압축이 풀려 있는 상태이고 암호화되지 않아야 하며 스파스가 아니어야 합니다.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.

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