Windows에서 시작하는 WSL : 설치부터 문제 해결까지

WSL 설치 전 필수 확인사항

WSL을 설치하기 전에 반드시 확인해야 할 시스템 요구사항과 준비사항이 있습니다. WSL 설치는 집을 짓는 것과 같습니다. 튼튼한 기초가 없다면 나중에 문제가 발생할 수 있습니다. 시작하기 전에 모든 준비사항을 꼼꼼히 확인하는 것이 중요합니다.

단계별 WSL 설치 가이드

WSL 설치는 다음과 같은 순서로 진행됩니다.

1단계: Windows 기능 활성화

먼저 관리자 권한으로 PowerShell을 실행하고 다음 명령을 입력합니다:

# WSL 설치 명령 실행
wsl --install

# 위 명령이 실패할 경우 아래 명령어를 순서대로 실행
# Windows Subsystem for Linux 기능 활성화
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
# Virtual Machine Platform 기능 활성화
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

2단계: 시스템 재시작

설치 명령을 실행한 후에는 반드시 시스템을 재시작해야 합니다. 재시작하지 않으면 다음 단계로 진행할 수 없습니다.

3단계: Ubuntu 설치 및 초기 설정

시스템 재시작 후 자동으로 Ubuntu 설치가 시작됩니다. 설치가 완료되면 새로운 UNIX 사용자 계정을 생성해야 합니다.

만약
Ubuntu이(가) 이미 설치되어 있습니다.
Ubuntu을(를) 시작하는 중...
Installing, this may take a few minutes...
가 계속 이어지고 우분투 실행이 안될 경우 아래 2가지를 확인해야 합니다.

제어판 -> 프로그램 및 기능 -> Windows 기능 켜기/끄기

Windows 기능 창에서 ‘Hyper-V’와 ‘Linux용 Windows 하위 시스템’을 체크하여 활성화 한 후 ‘확인 버튼을 클릭하고 윈도우를 재부팅한 후 다시 우분투를 실행해보세요.

flowchart TB
    A[시작] --> B[PowerShell 관리자 실행]
    B --> C[WSL 설치 명령 실행]
    C --> D{설치 성공?}
    D -->|Yes| E[시스템 재시작]
    D -->|No| F[수동 기능 활성화]
    F --> E
    E --> G[Ubuntu 초기 설정]
    G --> H[사용자 계정 생성]
    H --> I[완료]

초기 설정과 주의사항

Ubuntu가 처음 실행되면 다음과 같은 초기 설정이 필요합니다.

UNIX 사용자 계정 설정

# 사용자 이름 입력 (소문자만 사용 가능)
Enter new UNIX username: your_username
# 비밀번호 입력 (화면에 표시되지 않음)
New password: your_password
# 비밀번호 확인
Retype new password: your_password

시스템 업데이트

Ubuntu 시스템을 최신 상태로 업데이트하기 위해 다음 명령어를 실행합니다:

# 패키지 목록 업데이트
sudo apt update

# 설치된 패키지 업그레이드
sudo apt upgrade -y

일반적인 문제 해결

WSL 설치와 사용 과정에서 발생할 수 있는 일반적인 문제들과 그 해결 방법을 알아보겠습니다.

Sudo 관련 오류 해결

“Sudo가 이 컴퓨터에서 사용하지 않도록 설정되어 있습니다”라는 메시지가 나타날 경우 다음과 같이 해결할 수 있습니다:

1. Windows 설정 앱을 실행합니다.
2. ‘개발자용’ 섹션으로 이동합니다.
3. ‘Developer Mode’를 활성화합니다.
4. WSL을 재시작합니다.

# PowerShell 관리자 권한으로 실행
wsl --shutdown
wsl

설치 과정 문제 해결

WSL 설치 과정에서 발생할 수 있는 문제들과 해결 방법입니다:

성능 최적화를 위한 .wslconfig 설정

WSL의 성능을 최적화하기 위해 다음과 같은 설정 파일을 생성할 수 있습니다:

# %UserProfile%\.wslconfig 파일 생성
[wsl2]
# WSL에 할당할 메모리
memory=8GB
# 사용할 CPU 코어 수
processors=4
# 스왑 공간 크기
swap=2GB
# 네트워크 최적화
networkingMode=mirrored

다음 단계: WSL 환경의 효율적인 활용

WSL 설치와 기본 설정이 완료되었다면, 이제 개발 환경을 더욱 효율적으로 구성해보겠습니다.

개발 도구 설치

# 필수 개발 도구 설치
sudo apt install -y build-essential git curl wget

# Node.js 설치
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt install -y nodejs

# Python 개발 도구 설치
sudo apt install -y python3-pip python3-venv

VS Code 통합

Visual Studio Code를 WSL과 통합하여 사용하면 더욱 효율적인 개발이 가능합니다:

1. VS Code에서 ‘Remote – WSL’ 확장을 설치합니다.
2. WSL 터미널에서 다음 명령으로 VS Code를 실행합니다:

# 현재 디렉토리에서 VS Code 실행
code .

효율적인 작업을 위한 팁

일상적인 개발 작업을 더욱 효율적으로 만들기 위한 유용한 설정들을 알아보겠습니다.

# ~/.bashrc 파일에 유용한 별칭 추가
# 시스템 업데이트 명령어 단축
alias update='sudo apt update && sudo apt upgrade -y'
# 자세한 파일 목록 보기
alias ll='ls -la'
# 프로젝트 디렉토리로 빠른 이동
alias projects='cd ~/projects'

# Git 설정
git config --global user.name "여러분의 이름"
git config --global user.email "이메일@도메인.com"

WSL과 Windows 간의 파일 시스템 접근 방법:

• Windows에서 WSL 파일 접근: \\wsl$\Ubuntu\home\username
• WSL에서 Windows 파일 접근: /mnt/c/Users/username

네트워크 설정 최적화

# WSL의 네트워크 설정을 위한 포트 포워딩
# PowerShell 관리자 권한으로 실행
netsh interface portproxy add v4tov4 listenport=3000 listenaddress=0.0.0.0 connectport=3000 connectaddress=$(wsl hostname -I)

# Windows Defender 방화벽 규칙 추가
New-NetFirewallRule -DisplayName "WSL" -Direction Inbound -InterfaceAlias "vEthernet (WSL)" -Action Allow

flowchart LR
    A[Windows] -->|포트 포워딩| B[WSL]
    B -->|네트워크 통신| C[외부 네트워크]
    B -->|파일 시스템| D[Windows 파일]
    A -->|파일 시스템| E[WSL 파일]

마무리: WSL의 효율적인 활용

WSL은 Windows에서 Linux 개발 환경을 제공하는 강력한 도구입니다. 초기 설정에 시간을 투자하면 나중에 그만큼의 생산성 향상을 경험할 수 있습니다. 위에서 설명한 설정들을 차근차근 따라하면서 여러분만의 개발 환경을 구축해보세요.

특히 다음 사항들을 기억하시면 좋습니다:

• 정기적인 시스템 업데이트 실행
• 작업 특성에 맞는 리소스 할당
• 필요한 개발 도구의 적절한 설치와 구성
• 효율적인 파일 시스템 사용 전략 수립