사전 확인 사항

• Windows 10 2004 이상 또는 Windows 11
• BIOS에서 가상화 기술 활성화 (Intel VT-x 또는 AMD-V)

설치 절차

1단계: 관리자 권한으로 터미널 실행

• Windows + X 키를 누른 후 "터미널(관리자)" 또는 "Windows PowerShell(관리자)" 선택

2단계: WSL 설치 명령어 실행

wsl --install --web-download

이 명령어가 자동으로 처리하는 작업:

• WSL 기능 활성화
• 가상 머신 플랫폼 활성화
• WSL2 커널 설치
• Ubuntu 이미지 다운로드

3단계: 시스템 재부팅

설치를 완료하려면 반드시 재부팅이 필요합니다.

Ubuntu 초기 설정

재부팅 후 "Ubuntu" 애플리케이션을 실행하면 설정 마법사가 나타납니다.

사용자 계정 생성

• 사용자 이름: 영문 소문자로 시작, 소문자/숫자/하이픈만 사용 가능
• 비밀번호: 입력 시 화면에 표시되지 않음
• 비밀번호 확인: 동일한 비밀번호 재입력

설정 예시:

Enter new UNIX username: devuser
New password:
Retype new password:

설치 확인

PowerShell 또는 명령 프롬프트에서 다음 명령어 실행:

wsl -l -v

출력 결과:

  NAME      STATE           VERSION
* Ubuntu    Running         2

VERSION이 2로 표시되면 WSL2가 정상적으로 설치된 것입니다.

국내 환경 최적화 (apt 저장소 변경)

저장소 변경

# 기존 저장소 백업
sudo cp /etc/apt/sources.list /etc/apt/sources.list.backup

#清华大学 apt 저장소로 교체
echo "deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ noble main restricted universe multiverse
deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ noble-updates main restricted universe multiverse
deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ noble-security main restricted universe multiverse
deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ noble-backports main restricted universe multiverse" | sudo tee /etc/apt/sources.list

패키지 업데이트

sudo apt update
sudo apt upgrade -y

자주 발생하는 문제 해결

문제 1: 오류 코드 0x800701bc

원인: WSL2 커널이 누락된 경우

해결 방법:

wsl --update

또는 수동으로 커널 설치: https://aka.ms/wsl2kernel

문제 2: 다운로드 속도가 느리거나 진행이 멈춤

해결 방법 1: Windows Store 캐시 재설정

wsreset.exe

해결 방법 2: 오프라인 패키지 사용 (국내 환경에 적합)

문제 3: 사용자 이름 생성 시 NAME_REGEX 오류

사용자 이름은 반드시 영문 소문자로 시작해야 하며, 소문자와 숫자, 하이픈(-)만 사용할 수 있습니다.

문제 4: 특정 Ubuntu 버전 설치

원하는 버전 지정 설치:

wsl --install -d Ubuntu-22.04

설치 가능한 버전 목록 확인:

wsl --list --online

WSL 제거 방법

wsl --unregister Ubuntu

위 명령어를 실행하면 Ubuntu 환경이 완전히 삭제됩니다.