WSL 및 Linux의 기본 Ubuntu 배포판을 설치합니다. 자세히 알아보기. 이 명령을 사용하여 wsl --install <Distribution Name>을(를) 실행하여 추가 Linux 배포를 설치할 수도 있습니다. 유효한 배포 이름 목록을 보려면 wsl --list --online을(를) 실행합니다.
표시되는 옵션은 다음과 같습니다.
--distribution: 설치할 Linux 배포를 지정합니다. wsl --list --online을(를) 실행하여 사용 가능한 배포를 찾을 수 있습니다.
--no-launch: Linux 배포를 설치하지만 자동으로 시작하지는 않습니다.
--web-download: Microsoft Store를 사용하는 대신 온라인 원본에서 설치합니다.
WSL이 설치되지 않은 경우 옵션은 다음과 같습니다.
--inbox: Microsoft Store를 사용하는 대신 Windows 구성 요소를 사용하여 WSL을 설치합니다. (WSL 업데이트는 스토어를 통해 사용 가능으로 푸시되는 대신 Windows 업데이트를 통해 수신됩니다.)
--enable-wsl1: Microsoft Store 버전의 WSL을 설치하는 동안 "Linux용 Windows 하위 시스템" 선택적 구성 요소를 사용하도록 설정하여 WSL 1을 사용하도록 합니다.
--no-distribution: WSL을 설치할 때 배포를 설치하지 마세요.
참고
Windows 10 또는 이전 버전에서 WSL을 실행하는 경우 배포wsl --install -d <distribution name>를 지정하는 명령에 플래그를 --install 포함 -d 해야 할 수 있습니다.
사용 가능한 Linux 배포판 나열
wsl --list --online
온라인 스토어를 통해 받을 수 있는 Linux 배포판 목록을 참조하세요. 이 명령은 wsl -l -o으로 입력할 수도 있습니다.
설치된 Linux 배포판 나열
wsl --list --verbose
상태(배포판이 실행 중인지 또는 중지되었는지 여부) 및 배포판을 실행하는 WSL 버전(WSL 1 또는 WSL 2)을 포함하여 Windows 머신에 설치된 Linux 배포 목록을 참조하세요. WSL 1과 WSL 2를 비교해 보세요. 이 명령은 wsl -l -v으로 입력할 수도 있습니다. list 명령과 함께 사용할 수 있는 추가 옵션으로는 모든 배포판을 나열하는 --all, 현재 실행 중인 배포판만 나열하는 --running, 배포판 이름만 표시하는 --quiet가 있습니다.
Linux 배포판이 실행 중인 WSL 버전(1 또는 2)을 지정하려면 <distribution name>을 배포판 이름으로 바꾸고 <versionNumber>를 1 또는 2로 바꿉니다. WSL 1과 WSL 2를 비교해 보세요. WSL 2는 Windows 11 또는 Windows 10, 버전 1903, 빌드 18362 이상에서만 사용할 수 있습니다.
경고
WSL 1과 WSL 2 간의 전환은 시간이 오래 걸릴 수 있으며 두 아키텍처 간의 차이로 인해 오류가 발생할 수 있습니다. 대규모 프로젝트가 있는 배포의 경우 변환을 시도하기 전에 파일을 백업하는 것이 좋습니다.
기본 WSL 버전 설정
wsl --set-default-version <Version>
WSL 1 또는 WSL 2의 기본 버전을 설정하려면 숫자 1 또는 2로 바꿉 <Version> 니다. 예들 들어 wsl --set-default-version 2입니다. 숫자는 새 Linux 배포 설치에 대해 기본적으로 WSL 버전을 나타냅니다. WSL 1과 WSL 2를 비교해 보세요. WSL 2는 Windows 11 또는 Windows 10, 버전 1903, 빌드 18362 이상에서만 사용할 수 있습니다.
기본 Linux 배포판 설정
wsl --set-default <Distribution Name>
WSL 명령에서 실행에 사용할 기본 Linux 배포판을 설정하려면 <Distribution Name>을 기본 Linux 배포판의 이름으로 바꿉니다.
디렉터리를 홈으로 변경
wsl ~
~는 wsl과 함께 사용하여 사용자의 홈 디렉터리에서 시작할 수 있습니다. WSL 명령 프롬프트 내 디렉터리에서 홈으로 다시 이동하기 위해 cd ~ 명령을 사용할 수 있습니다.
특정 사용자로 특정 Linux 배포판을 실행하려면 <Distribution Name>을 기본 Linux 배포판의 이름(즉, Debian)으로 바꾸고 <User Name>을 기존 사용자의 이름(예: 루트)으로 바꿉니다. 해당 사용자가 WSL 배포판에 없는 경우 오류가 발생합니다. 현재 사용자 이름을 출력하려면 whoami 명령을 사용합니다.
WSL 업데이트
wsl --update
WSL 버전을 최신 버전으로 업데이트합니다. 표시되는 옵션은 다음과 같습니다.
--web-download: Microsoft Store가 아닌 GitHub에서 최신 업데이트를 다운로드합니다.
WSL 상태 확인
wsl --status
기본 배포판 유형, 기본 배포판 및 커널 버전과 같은 WSL 구성에 대한 일반 정보를 참조하세요.
WSL 버전 확인
wsl --version
WSL 및 해당 구성 요소에 대한 버전 정보를 확인합니다.
Help 명령
wsl --help
WSL에서 사용할 수 있는 옵션 및 명령 목록을 참조하세요.
특정 사용자로 실행
wsl --user <Username>
WSL을 지정된 사용자로 실행하려면 <Username>를 WSL 배포에 있는 사용자의 이름으로 바꿉니다.
지정된 .vhdx 파일을 새 배포로 가져옵니다. 가상 하드 디스크는 ext4 파일 시스템 형식으로 포맷되어야 합니다.
Linux 배포판 등록 취소 또는 제거
Linux 배포는 Microsoft Store를 통해 설치할 수 있지만 이를 통해 제거할 수는 없습니다.
WSL 배포를 등록 취소하고 제거하려면 다음을 수행합니다.
wsl --unregister <DistributionName>
<DistributionName>를 대상 Linux 배포의 이름으로 바꾸면 WSL에서 해당 배포를 등록 취소하여 다시 설치하거나 정리할 수 있습니다. 주의: 등록이 취소되면 해당 배포와 관련된 모든 데이터, 설정 및 소프트웨어가 영구적으로 손실됩니다. 스토어에서 다시 설치하면 배포의 새 복사본이 설치됩니다. 예를 들어 wsl --unregister Ubuntu는 WSL에서 사용할 수 있는 배포에서 Ubuntu를 제거합니다. wsl --list를 실행하면 더 이상 나열되지 않습니다.
다른 스토어 애플리케이션과 마찬가지로 Windows 머신에서 Linux 배포판 앱을 제거할 수도 있습니다. 다시 설치하려면 Microsoft Store에서 해당 배포를 찾아 "시작"을 선택합니다.
디스크 또는 디바이스 탑재
wsl --mount <DiskPath>
<DiskPath>를 디스크가 있는 디렉터리\파일 경로로 바꿔서 모든 WSL2 배포판에 물리적 디스크를 연결하고 탑재합니다. WSL 2에 Linux 디스크 탑재를 참조하세요. 표시되는 옵션은 다음과 같습니다.
--vhd: <Disk>(이)가 가상 하드 디스크를 참조하도록 지정합니다.
--name: 탑재 지점에 대한 사용자 지정 이름을 사용하여 디스크를 탑재합니다.
--bare: WSL2에 디스크를 연결하지만 탑재하지는 않습니다.
--type <Filesystem>: 디스크를 탑재할 때 사용되는 파일 시스템 유형입니다. 지정하지 않으면 기본값은 ext4입니다. 이 명령은 wsl --mount -t <Filesystem>으로 입력할 수도 있습니다. blkid <BlockDevice> 명령을 사용하여 파일 시스템 형식을 검색할 수 있습니다(예: blkid <dev/sdb1>).
--partition <Partition Number>: 탑재할 파티션의 인덱스 번호입니다. 지정하지 않으면 전체 디스크가 기본값입니다.
--options <MountOptions>: 디스크를 탑재할 때 포함할 수 있는 몇 가지 파일 시스템 관련 옵션이 있습니다. wsl --mount -o "data-ordered" 또는 wsl --mount -o "data=writeback 같은 ext4 탑재 옵션을 예로 들 수 있습니다. 그러나 현재는 파일 시스템 관련 옵션만 지원됩니다. ro, rw 또는 noatime과 같은 일반 옵션은 지원되지 않습니다.
참고
wsl.exe(64비트 도구)에 액세스하기 위해 32비트 프로세스를 실행하는 경우 C:\Windows\Sysnative\wsl.exe --command와 같은 방식으로 이 명령을 실행해야 할 수도 있습니다.
디스크 탑재 해제
wsl --unmount <DiskPath>
디스크 경로에 지정된 디스크를 분리합니다. 디스크 경로가 지정되지 않은 경우, 이 명령은 탑재된 모든 디스크를 장착 해제하여 분리합니다.
사용되지 않은 WSL 명령
wslconfig.exe [Argument] [Options]
bash [Options]
lxrun /[Argument]
이러한 명령은 WSL과 함께 설치된 Linux 배포판을 구성하는 원래 wsl 구문이지만 wsl 또는 wsl.exe 명령 구문으로 대체되었습니다.
GitHub에서 Microsoft와 공동 작업
이 콘텐츠의 원본은 GitHub에서 찾을 수 있으며, 여기서 문제와 끌어오기 요청을 만들고 검토할 수도 있습니다. 자세한 내용은 참여자 가이드를 참조하세요.
Windows Subsystem for Linux 피드백
Windows Subsystem for Linux은(는) 오픈 소스 프로젝트입니다. 다음 링크를 선택하여 피드백을 제공해 주세요.
이 모듈에서는 VS Code(Visual Studio Code)와 함께 WSL(Linux용 Windows 하위 시스템)을 사용하는 방법을 알아봅니다. 설치 프로세스와 WSL 사용의 기본 사항을 살펴봅니다. 또한 Visual Studio Code WSL 확장을 설치하고 활용합니다. 마지막으로 WSL 환경 내 VS Code에서 Python 코드를 디버깅하고 실행하는 방법을 보여 줍니다.