WSL 설치

필수 구성 요소

Windows 10 버전 2004 이상(빌드 19041 이상) 또는 Windows 11을 실행해야 합니다.

참고

Windows 버전 및 빌드 번호를 확인하려면 Windows 로고 키 + R을 선택하고, winver를 입력하고, 확인을 선택합니다. 시작설정 **Windows 업데이트 **>>을 선택하여 최신 Windows 버전으로 업데이트할 수 있습니다.

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

설치

이제 관리자 PowerShell 또는 Windows 명령 프롬프트에서 이 명령을 입력한 다음, 머신을 다시 시작하여 WSL(Linux용 Windows 하위 시스템)을 실행하는 데 필요한 모든 것을 설치할 수 있습니다.

wsl --install

이 명령은 자동으로 필요한 선택적 구성 요소를 사용하도록 설정하고, 최신 Linux 커널을 다운로드하고, WSL 2를 기본값으로 설정하고, Linux 배포판 (기본적으로 Ubuntu이며, 변경 방법은 아래 참조) 을 설치합니다

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

설치된 기본 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 사용자 정보 설정

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

설정 및 모범 사례

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

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

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

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

추가 자료