cmaven

작업노트

:bulb: Windows 11에서 WSL(Windows Subsystem for Linux)을 사용하여 Ubuntu를 설치하고 초기 설정하는 방법을 작성한다.

[01] 요약

항목 내용
WSL 버전 WSL2 (권장)
설치 대상 Ubuntu (최신 LTS)
필요 환경 Windows 11 (빌드 22000 이상)
소요 시간 약 10~15분

[02] WSL 설치

2-1. 한 줄 설치 (WSL 미설치 환경)

PowerShell을 관리자 권한으로 실행한 후 아래 명령어를 입력한다.



1



wsl --install

이 명령어 하나로 아래 항목이 자동 처리된다.

항목 설명
Virtual Machine Platform 가상화 플랫폼 기능 활성화
Windows Subsystem for Linux WSL 기능 활성화
WSL2 커널 Linux 커널 업데이트 설치
Ubuntu (기본) 기본 배포판 설치

WSL 기능을 처음 활성화하는 경우 시스템 구성 요소가 변경되므로 PC 재부팅이 필요하다. 재부팅 후 Ubuntu 설정이 자동으로 이어진다.

2-2. 배포판 선택 설치 (WSL이 이미 설치된 경우)

WSL이 이미 활성화된 환경에서 Ubuntu를 추가 설치할 때 사용한다. 재부팅은 필요하지 않다.



1
2



# 설치 가능한 배포판 목록 확인
wsl --list --online

출력 예시:



1
2
3
4
5
6



NAME                   FRIENDLY NAME
Ubuntu                 Ubuntu
Ubuntu-24.04           Ubuntu 24.04 LTS
Ubuntu-22.04           Ubuntu 22.04 LTS
Debian                 Debian GNU/Linux
...

최신 stable 버전을 설치한다.



1
2



# Ubuntu 최신 LTS 설치
wsl --install -d Ubuntu

wsl --install -d Ubuntu는 최신 LTS 버전을 자동으로 설치한다. 특정 버전이 필요한 경우 Ubuntu-24.04처럼 버전을 지정할 수 있다.

[03] WSL 버전 확인 및 설정

3-1. WSL 버전 확인



1



wsl -l -v

출력 예시:



1
2



  NAME            STATE           VERSION
* Ubuntu          Running         2

VERSION이 2이면 WSL2로 정상 설정된 것이다.

3-2. 기본 버전을 WSL2로 설정



1
2
3
4
5



# 기본 WSL 버전을 2로 설정
wsl --set-default-version 2

# 특정 배포판의 버전 변경
wsl --set-version Ubuntu 2

[04] Ubuntu 초기 설정

설치 완료 후 Ubuntu를 처음 실행하면 사용자 계정 설정을 요구한다.



1
2
3



Enter new UNIX username: 사용자이름
New password: 비밀번호 입력
Retype new password: 비밀번호 재입력

4-1. 패키지 업데이트



1



sudo apt update && sudo apt upgrade -y

4-2. 한국어 로케일 설정 (선택)



1
2



sudo apt install -y language-pack-ko
sudo update-locale LANG=ko_KR.UTF-8

설정 후 WSL을 재시작하면 적용된다.

[05] WSL 기본 명령어

명령어 설명
wsl 기본 배포판 실행
wsl -d Ubuntu 특정 배포판 실행
wsl -l -v 설치된 배포판 목록 및 상태 확인
wsl --shutdown 모든 WSL 인스턴스 종료
wsl --terminate Ubuntu 특정 배포판 종료
wsl --update WSL 커널 업데이트
wsl --unregister Ubuntu 배포판 삭제 (데이터 포함)

[06] Windows ↔ WSL 파일 접근

6-1. WSL에서 Windows 파일 접근

Windows의 C 드라이브는 /mnt/c에 마운트된다.



1
2
3
4
5



# Windows 사용자 폴더 접근
cd /mnt/c/Users/사용자이름

# Windows 바탕화면 접근
cd /mnt/c/Users/사용자이름/Desktop

6-2. Windows에서 WSL 파일 접근

Windows 탐색기 주소창에 아래 경로를 입력한다.



1



\\wsl$\Ubuntu

또는 WSL 터미널에서 아래 명령어로 탐색기를 열 수 있다.



1



explorer.exe .

[07] Windows Terminal 연동

Windows 11에는 Windows Terminal이 기본 포함되어 있다. Ubuntu 설치 후 자동으로 프로필이 추가된다.

  • Windows Terminal 실행 → 탭 옆 드롭다운(∨) → Ubuntu 선택

7-1. 기본 프로필 변경 (선택)

  1. Windows Terminal → 설정(Ctrl + ,)
  2. 시작 → 기본 프로필 → Ubuntu 선택
  3. 저장

[08] WSL 삭제



1
2



# 배포판 삭제 (모든 데이터 포함)
wsl --unregister Ubuntu

--unregister는 배포판과 내부 데이터를 모두 삭제한다. 필요한 데이터는 미리 백업한다.

참고