윈도우10에서 리눅스(Linux) 설치하기 (Ubuntu on WSL2)

이 글은 2022년 당시 WSL2(Windows 10 21H2) 기준으로 작성된 설치/사용 기록이다. 최신 버전에서는 명령이 다를 수 있다.

• Update(20220714)
  • 윈도우 11 또는 윈도우 10 21H2 이상에서는 wsl --install 한 줄로 설치할 수 있다. 아래처럼 수동으로 설치하는 방식은 윈도우 10 1903(빌드 18362) 이상이면 동작한다. ¹
• AWS에서 가상의 환경을 작업하던 중, 내 PC에서 구동해 보았으면 싶어서 설치를 진행해 보았다.

1. Linux용 Windows 하위 시스템

• 제어판 -> 프로그램 및 기능 -> Windows 기능 켜기/끄기 -> Linux용 Windows 하위 시스템 선택 -> 확인

2. 개발자 모드

• 설정 -> 업데이트 및 보안 -> 개발자용 -> 개발자 모드 켬 -> 그 후 컴퓨터 재시작

3. Windows 10 최신 업데이트하기

• 추가(20220717)
  • 설정 -> Windows 업데이트 -> 고급 옵션 -> “Window를 업데이트할 때 다른 Microsoft 제품에 대한 업데이트 받기” 활성화

4. powershell 관리자 실행

• powershell 검색 -> 관리자 권한으로 실행

5. 코드 복사 -> 붙여넣기

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

• 이 코드는 WSL 시스템을 활성화하는 단계이다.

6. 코드 복사 -> 붙여넣기

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

• 이 코드는 Virtual Machine 기능을 활성화하는 단계이다.

7. Linux 커널 업데이트 패키지 다운로드

• x64 머신용 최신 WSL2 Linux 커널 업데이트 패키지

• 링크를 누르면 자동으로 다운받아지고 설치를 진행하면 된다.

8. WSL 2 기본 버전 세팅

• wsl --set-default-version 2

• 이 코드는 WSL 2를 기본 버전으로 세팅하는 단계이다.

만약 위와 같이 에러가 난다면 bcdedit /set hypervisorlaunchtype auto 를 친 후 재부팅을 한다.

9. Ubuntu 설치

• Microsoft Store에서 Ubuntu를 검색해 다운받는다.
• 새로 설치된 Linux 배포를 처음 시작하면 콘솔 창이 열리고 파일이 압축 해제되어 PC에 저장될 때까지 1~2분 정도 기다려야 한다.

• 새 Linux 배포를 위한 사용자 계정 및 암호를 만들어야 하는데 계정 이름은 소문자로 생성한다.

WslRegisterDistribution failed with error: 0x800701bc Error: 0x800701bc WSL 2? ?? ?? ?? ????? ?????. ??? ??? https://aka.ms/wsl2kernel? ??????. 에러가 난다면

• https://docs.microsoft.com/ko-kr/windows/wsl/install-manual로 가서 ARM64 패키지를 다운받는다.

10. 최종

• Windows Terminal을 설치해주면 커스텀마이징을 할 수 있다.

• 초기에 sudo apt update, sudo apt upgrade 명령어 실행한다.
  • alsa 오류가 난다면 sudo apt-get install alsa-utils 명령어 실행한다.

Appendix A

• 만약 wsl를 vscode와 연동시키려면, command에 code . 명령어를 실행해주면 된다.

• 또는 vscode에 ctrl+shift+p를 눌러 Remote-WSL: New WSL Window를 실행해주면 된다.

한계 및 주의사항

• WSL2는 가상 머신(Hyper-V VM) 환경에서 독립적인 Linux 커널로 동작하므로, Windows 호스트 드라이브(/mnt/c/)에 위치한 프로젝트 파일에 교차 접근할 때 파일 시스템 I/O 성능이 저하된다. 빠른 파일 처리가 필요한 프로젝트 소스와 개발 환경은 WSL Linux 내부 파일 시스템(~/)에 보관해야 한다. ^{2 3}
• WSL2 가상 하드 디스크(ext4.vhdx)는 사용량에 따라 자동으로 커지지만, Linux 내부에서 파일을 지우더라도 Windows 호스트의 가상 디스크 파일 용량은 자동으로 줄어들지 않는다. 용량을 회수하려면 wsl --shutdown 후 Windows diskpart 유틸리티의 compact vdisk 작업을 수행해야 한다. ⁴
• WSL2는 가상화된 전용 네트워크 어댑터를 통해 별도의 가상 IP 주소를 할당받으므로, Windows 호스트와 포트 포워딩이나 로컬 서버 통신을 구성할 때 WSL 1과 다른 네트워킹 설정(localhost 바인딩 특성)을 고려해야 한다. ³

References

1. Microsoft Learn - 이전 버전의 WSL 수동 설치 단계 ↩

2. Microsoft Learn - WSL 개발 환경 설정 모범 사례 ↩

3. Microsoft Learn - WSL 버전 비교 (WSL 1과 WSL 2) ↩ ↩²

4. Microsoft Learn - WSL 가상 하드 디스크(VHD) 공간 관리 ↩