Windows Subsystem for Linux 2 (WSL2) 설치 방법

전제 조건

1. 최신 Windows 버전:
   • Windows 10 Home, Pro, Enterprise 또는 Education 버전 (버전 호환성 확인)
   • 특정 기능을 사용하려면 Insider Program 가입 권장
2. 하드웨어 요구 사항:
   • 적어도 4GB RAM (추천: 8GB 이상)
   • Hyper-V 지원하는 CPU (최근 AMD 프로세서 및 일부 인텔 프로세서에서 가능)

1단계: 기능 업데이트 확인

# 최신 Windows Update 설치 여부 확인 Set-ExecutionPolicy RemoteSigned -Scope CurrentUser 

주의: PowerShell 명령어 실행 시 관리자 권한 필요

2단계: WSL 및 Virtual Machine Platform 활성화방법 1 (GUI):

1. 설정 > 응용 프로그램 > Windows 애드온s
2. WSL 2, Virtual Machine Platform 기능 선택

방법 2 (PowerShell 명령어):

# Windows 10버전: 대화형으로 진행 wsl --install -d Ubuntu-20.04 # 또는 직접 설정: OptionalFeature -Online -FeatureName Microsoft-WSL2Kernel 

3단계: 그래픽 드라이버 설치

# WSL용 NVIDIA 드라이버 설치 (필요 시) sudo apt install nvidia-driver-470 

참고: GPU 사용자는 Entitlement Portal 등록 필요

4단계: 외부 앱 연결

# SSH 서버로 설정 ssh-keygen -t ed25519 -C "This email address is being protected from spambots. You need JavaScript enabled to view it." # 또는 Windows 앱 연결: echo 'Subsystem sftp /usr/lib/openssh/sftpd/sbin/sftp-server' >> ~/.ssh/config 

5단계: 시작 메뉴에서 실행

WSL 설치 후:

# WSL 셸 열기 (시작 메뉴 검색) wsl --cd ~/ 

팁: WSL 프로젝트 폴더 연결 방법 알아보기

6단계: 기본 설정 확인

# 현재 버전 확인: wsl --version # 또는 업데이트 명령어: sudo apt update && sudo apt upgrade -y 

고급 설정:

• /etc/wsl.conf 편집 (네트워크, 파일 시스템 등)

# 예시: WSL2에서 그래픽 애플리케이션 실행 방지 echo "[boot] systemd=true [network] generateHosts=false" > ~/.config/wsl.conf 

7단계: 문제 해결

일반 오류 메시지 처리 방법:

# WSL 초기화 오류 시: wsl --reset && wsl --unregister Ubuntu-20.04 # 또는 업데이트 후 다시 설치: wsl --update 

**WSL 콘솔에서 실행할 수 없는 애픈:

# Windows Terminal 설치 (선택적 단계): Invoke-WebRequest -Uri https://aka.ms/wsl-setup-cli -OutFile WSL2_Setup.zip Expand-Archive -Path .\WSL2Setup.zip -DestinationPath "C:\temp" -Force # 또는 설정 변경: Set-ItemProperty -Path HKLM:\SYSTEM\CurrentControlSet\Control\Virtualization\Containers\features -Name "MicrosoftSubsystem for LinuxEnabled" -Value 1 

추가 리ソース:

공식 문서

참고8단계: 추가 기능 활용

# 커널 확장 모듈 설치: sudo apt install linux-tools-common 

WSL과 VSCode 통합 방법:

1. Linux終端 세션 익스텐션 설치
2. 설정에서 리눅스 커맨드 출력 브라우징 활성화

9단계: 최신 버전 업데이트

# WSL 셸 내부에서: sudo apt update && sudo apt dist-upgrade -y # 또는 PowerShell에서 직접: wsl --distribution Ubuntu-20.04 --update 

참고: 설치된 모든 배포판 초기화 방법 알아보기

WSL 확장 기능 사용하기

# WSL용 Linux 디스플레이 서버 설치 (X11, Wayland 등): sudo apt install xrdp # 그래픽 애플리케이션 호스트에 불편함 있음 # 또는 GUI 모드로 실행: start /wait explorer.exe C:\Windows\SystemApps\Microsoft.WindowsTerminal_8wekyb3d8bbwe 

주의: WSL2는 CPU 기반 가상화를 사용하므로 일부 프로그램은 별도 설정 필요

10단계: 최적화 및 성능 조정

# 메모리 할당량 변경 (예시): echo "[memory] kernelMemory=4GB" >> $env:LOCALAPPDATA\Microsoft\WSL\wsl.conf 

최대 성능 모드 설정:

bcdedit /set {current} hypervisorlaunchtype auto # 또는 GUI에서 검색해 설정 변경 

설치 확인

WSL 설치 후 반드시 실행 가능한지 테스트하기:

1. WSL 셸에서 ping -c 4 google.com 명령어로 네트워크 연결 확인
2. 기본 디렉토리와 파일 시스템 마운팅 확인:

# 예시: Windows 폴더 마운트 방지 설정 wsl --mount C:\Users\YourUser\ --volume /home/youruser/host_shared_folder # 또는 재정의 방법 알아보기 (WSL 셸 내부에서) 

최종 확인:

• 모든 애플리케이션 실행 시 속도 테스트

wsl -l --all # 설치된 WSL 인스턴스 목룍