WSL을 사용하여 Windows에 Linux를 설치하는 방법

개발자는 Windows 컴퓨터에서 동시에 Windows와 Linux의 기능에 액세스할 수 있습니다. WSL(Linux용 Windows 하위 시스템)을 사용하면 개발자가 Linux 배포판(예: Ubuntu, OpenSUSE, Kali, Debian, Arch Linux)을 설치하고 기존 가상 머신 또는 이중 부팅 설정의 오버헤드 없이 Windows에서 직접 Linux 애플리케이션, 유틸리티 및 Bash 명령줄 도구를 사용할 수 있습니다.

필수 조건

아래 명령을 사용하려면 Windows 10 버전 2004 이상(빌드 19041 이상) 또는 Windows 11을 실행해야 합니다. 이전 버전을 사용 중인 경우 수동 설치 페이지를 참조하세요.

WSL 설치 명령

이제 단일 명령으로 WSL을 실행하는 데 필요한 모든 항목을 설치할 수 있습니다. 관리자 모드에서 PowerShell 또는 Windows 명령 프롬프트를 마우스 오른쪽 단추로 클릭하고 "관리자 권한으로 실행"을 선택하여 열고 wsl --install 명령을 입력한 다음 컴퓨터를 다시 시작합니다.

wsl --install

이 명령은 WSL을 실행하고 Linux의 Ubuntu 배포를 설치하는 데 필요한 기능을 사용하도록 설정합니다. (이 기본 분포는 변경할 수 있습니다).

이전 빌드를 실행 중이거나, 설치 명령을 사용하지 않고 단계별 지침을 원하는 경우 이전 버전의 WSL 수동 설치 단계를 참조하세요.

새로 설치된 Linux 배포판을 처음 시작하면 콘솔 창이 열리고 파일의 압축이 풀리고 머신에 저장될 때까지 기다리라는 메시지가 표시됩니다. 이후의 모든 시작은 1초도 걸리지 않습니다.

참고 항목

위의 명령은 WSL이 전혀 설치되지 않은 경우에만 작동합니다. WSL 도움말 텍스트를 실행하고 wsl --install 보는 경우 실행 wsl --list --online 하여 사용 가능한 배포판 목록을 확인하고 실행 wsl --install -d <DistroName> 하여 배포판 설치를 시도하세요. WSL을 제거하려면 WSL의 레거시 버전 제거 또는 Linux 배포판 등록 취소 또는 제거를 참조하세요.

설치된 기본 Linux 배포판 변경

기본적으로 설치된 Linux 배포는 Ubuntu입니다. -d 플래그를 사용하여 변경할 수 있습니다.

  • 설치된 배포판을 변경하려면 wsl --install -d <Distribution Name>을 입력합니다. <Distribution Name>을 설치하려는 배포판의 이름으로 바꿉니다.
  • 온라인 스토어를 통해 다운로드할 수 있는 Linux 배포판 목록을 보려면 wsl --list --online 또는 wsl -l -o를 입력합니다.
  • 초기 설치 후 추가 Linux 배포판을 설치하려면 wsl --install -d <Distribution Name> 명령을 사용합니다.

PowerShell 또는 명령 프롬프트가 아닌 Linux/Bash 명령줄 내에서 추가 배포판을 설치하려면 wsl.exe --install -d <Distribution Name> 명령 또는 wsl.exe -l -o 명령(사용 가능한 배포판을 나열하려는 경우)에서 .exe를 사용해야 합니다.

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

사용 가능한 것으로 나열되지 않은 Linux 배포를 설치하려면 TAR 파일을 사용하여 Linux 배포를 가져올 수 있습니다. 또는 경우에 따라 Arch Linux와 마찬가지로 .appx 파일을 사용하여 설치할 수 있습니다. WSL과 함께 사용할 사용자 지정 Linux 배포를 만들 수도 있습니다.

Linux 사용자 정보 설정

WSL을 설치한 후에는 새로 설치된 Linux 배포판의 사용자 계정 및 암호를 만들어야 합니다. 자세한 내용은 WSL 개발 환경 설정에 대한 모범 사례를 참조하세요.

설정 및 모범 사례

설치된 Linux 배포판의 사용자 이름 및 암호를 설정하는 방법, 기본 WSL 명령 사용, Windows 터미널 설치 및 사용자 지정, Git 버전 제어 설정, VS Code 원격 서버를 사용하여 코드 편집 및 디버깅, 파일 스토리지 모범 사례, 데이터베이스 설정, 외부 드라이브 탑재, GPU 가속 설정 방법을 안내하는 단계별 연습에 대한 WSL 개발 환경 설정에 대한 모범 사례 가이드를 따르는 것이 좋습니다

실행 중인 WSL 버전 확인

PowerShell 또는 Windows 명령 프롬프트에서 wsl -l -v 명령을 입력하여 설치된 Linux 배포판을 나열하고 각각 설정된 WSL 버전을 확인할 수 있습니다.

새 Linux 배포판이 설치될 때 기본 버전을 WSL 1 또는 WSL 2로 설정하려면 wsl --set-default-version <Version#> 명령을 사용하여 <Version#>를 1 또는 2로 바꿉니다.

wsl 명령과 함께 사용되는 기본 Linux 배포판을 설정하려면 wsl -s <DistributionName> 또는 wsl --set-default <DistributionName>를 입력하고 <DistributionName>를 사용하려는 Linux 배포판의 이름으로 바꿉니다. 예를 들어 PowerShell/CMD에서 wsl -s Debian를 입력하여 기본 배포를 Debian으로 설정합니다. 이제 Powershell에서 wsl npm init를 실행하면 Debian에서 npm init 명령이 실행됩니다.

기본 배포를 변경하지 않고 PowerShell 또는 Windows 명령 프롬프트 내에서 특정 wsl 배포를 실행하려면 wsl -d <DistributionName> 명령을 사용하여 <DistributionName>를 사용하려는 배포 이름으로 바꿉니다.

WSL의 기본 명령 가이드에서 자세히 알아봅니다.

WSL 1에서 WSL 2로 버전 업그레이드

wsl --install 명령을 사용하여 설치된 새 Linux 설치는 기본적으로 WSL 2로 설정됩니다.

wsl --set-version 명령을 사용하면 WSL 2에서 WSL 1로 다운그레이드하거나 이전에 설치된 Linux 배포를 WSL 1에서 WSL 2로 업데이트할 수 있습니다.

Linux 배포판이 WSL 1 또는 WSL 2로 설정되어 있는지 확인하려면 wsl -l -v 명령을 사용합니다.

버전을 변경하려면 wsl --set-version <distro name> 2 명령을 사용하여 <distro name>을 업데이트하려는 Linux 배포판의 이름으로 바꿉니다. 예를 들어 wsl --set-version Ubuntu-20.04 2는 WSL 2를 사용하도록 Ubuntu 20.04 배포를 설정합니다.

wsl --install 명령을 사용하기 전에 WSL을 수동으로 설치한 경우 WSL 2에서 사용하는 가상 머신 선택적 구성 요소를 사용하도록 설정하고 아직 설치하지 않은 경우 커널 패키지를 설치해야 할 수도 있습니다.

자세히 알아보려면 WSL 명령 목록은 WSL 명령 참조, 작업 시나리오에 사용할 지침은 WSL 1 및 WSL 2 비교 또는 WSL을 사용하는 우수한 개발 워크플로를 설정하기 위한 일반적인 지침은 WSL 개발 환경 설정 모범 사례를 참조하세요.

WSL을 사용하여 여러 Linux 배포판을 실행하는 방법

WSL은 설치하려는 만큼의 다양한 Linux 배포판의 실행을 지원합니다. 여기에는 Microsoft Store에서 배포판 선택, 사용자 지정 배포판 가져오기 또는 고유한 사용자 지정 배포 빌드가 포함될 수 있습니다.

설치 후 Linux 배포판을 실행할 수 있는 여러 가지 방법은 다음과 같습니다.

  • Windows 터미널 설치(권장) Windows 터미널을 사용하여 설치하려는 만큼의 명령줄을 지원하고, 여러 탭 또는 창에서 명령줄을 열고, 여러 Linux 배포판 또는 다른 명령줄(PowerShell, 명령 프롬프트, Azure CLI 등) 간에 빠르게 전환할 수 있습니다. 고유한 색 구성표, 글꼴 스타일, 크기, 배경 이미지 및 사용자 지정 바로 가기 키를 사용하여 터미널을 원하는 대로 사용자 지정할 수 있습니다. 자세히 알아보기.
  • Windows 시작 메뉴를 방문해 설치된 배포의 이름을 입력하여 Linux 배포판을 직접 열 수 있습니다. 예: "Ubuntu". 그러면 자체 콘솔 창에서 Ubuntu가 열립니다.
  • Windows 명령 프롬프트 또는 PowerShell에서 설치된 배포의 이름을 입력할 수 있습니다. 예: ubuntu
  • Windows 명령 프롬프트 또는 PowerShell에서 wsl.exe를 입력하여 현재 명령줄 내에서 기본 Linux 배포판을 열 수 있습니다.
  • Windows 명령 프롬프트 또는 PowerShell에서 wsl [command]를 입력하여 새 배포를 입력하지 않고 현재 명령줄 내에서 기본 Linux 배포판을 열 수 있습니다. [command]를 WSL 명령(예: wsl -l -v)으로 대체하여 설치된 배포를 나열하거나 wsl pwd를 통해 현재 디렉터리 경로가 wsl에 탑재된 위치를 확인합니다. PowerShell에서 명령 get-date는 Windows 파일 시스템의 날짜를 제공하고 wsl date는 Linux 파일 시스템의 날짜를 제공합니다.

선택하는 방법은 수행하는 작업에 따라 달라집니다. Windows 프롬프트 또는 PowerShell 창 내에서 WSL 명령줄을 열고 종료하려면 exit 명령을 입력합니다.

최신 WSL 미리 보기 기능 사용해 보기

WSL의 최신 기능이나 업데이트를 사용해 보려면 Windows 참가자 프로그램에 참여하세요. Windows 참가자 프로그램에 참여하면 Windows 설정 메뉴 내에서 미리 보기 빌드를 받을 채널을 선택하여 해당 빌드와 연결된 WSL 업데이트 또는 미리 보기 기능을 자동으로 받을 수 있습니다. 다음 중 하나를 선택할 수 있습니다.

  • 개발 채널: 가장 최근의 업데이트이지만 안정성은 낮습니다.
  • 베타 채널: 개발 채널보다 더 안정적인 빌드인 얼리 어답터에게 이상적입니다.
  • 릴리스 미리 보기 채널: 일반 대중에게 제공되기 직전에 다음 버전의 Windows 수정 사항 및 주요 기능을 미리 봅니다.

추가 리소스