Windows10에서 WSL(Windows Subsystem for Linux) 설치 방법 및 패키지매니저(apt-get)을 사용하여 node.js 설치하기

매번 맥북을 꺼내기 귀찮아서, 집에 있는 Windows10에도 개발환경을 설정하기로 했다. 그런데, 마이크로소프트 스토어에서 Ubuntu를 설치한 뒤 실행했더니 Virtual Machine 기능을 사용하라는 게 아닌가. 어찌어찌 마이크로 소프트의 WSL 설치 가이드 페이지를 참조해서 설치까지는 했는데, 이번엔 apt-get이 실행되지 않았다. 아무리 생각해봐도 컴퓨터를 포멧하거나 하면, 같은 문제때문에 골머리를 앓을 것 같아 이번 기회에 정리하고자 한다.

Windows10에 Linux용 Windows 하위 시스템 설치 가이드

별 생각없이 마이크로소프트 스토어에서 Ubuntu를 찾아서 설치하고 실행했다면, Virtual Machine 기능을 사용해야 한다거나 혹은 WSL의 사용 설정을 해야한다는 에러 문구가 뜰 가능성이 높다. 에러 메시지와 함께 에러를 해결하려면 이 페이지가 참조 링크로 뜰텐데, 그대로 따라하면 된다.

페이지에는 윈도우즈 인사이더 가입자용을 위한 단순화된 설치(wsl --install)도 기재되어있지만, 알다시피 윈도우즈 인사이더를 설치하게되면 블루스크린이 뻥뻥 터지는 경우가 많아서 추천하지 않는다. 수동 설치단계를 하나하나 진행하면, WSL을 사용 가능해진다.

1. Linux용 Windows 하위 시스템 사용

파워쉘을 관리자 권한으로 열어, 아래의 명령어를 입력한다.

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

실행이 완료되면, 재시작한다.

2. WSL2로 업데이트 (윈도우 버전 확인)

페이지의 요구사항 항목을 참조하여, 자신의 환경이 요구사항을 만족하는지 확인한다.

3. Virtual Machine 기능 사용

파워쉘을 관리자 권한으로 열어, 아래의 명령어를 입력한다.

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

실행이 완료되면, 재시작한다.

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

x64용 WSL2 Linux 커널 업데이트 패키지를 받아서 설치한다. ARM64의 경우에는 ARM64 패키지를 다운받아야한다.

5. WSL2를 기본 버전으로 설정

파워쉘을 관리자 권한으로 열어, 아래의 명령어를 입력한다.

wsl --set-default-version 2

6. Microsoft Store에서 Linux 배포 설치

아직 설치하지 않았다면 Ubuntu를 설치하도록하자. 앞서 설치했다면, 건너뛰어도 된다.

7. Windows Terminal 설치 (옵션)

Windows Terminal을 설치하도록하자. 아무래도 편하다.

8. sudo apt-get install nodejs을 실행하면 에러가 발생하는 경우

sudo apt-get install npm을 실행하면 E: Unable to locate package npm메시지가 출력된다. 대충 저장소를 못 찾는다는 소리다. Installing Node.js via package manager - Debian and Ubuntu based Linux distributions 페이지를 참조하면 Ubuntu/Debian에서도 패키지매니저를 통해 nodejs를 설치하는게 가능하다는 얘기가 나와있다. 단, 이 경우 node.js 바이너리만 딸랑 설치되니 주의하도록하자. npm등을 사용하기 위해서는, 별도로 설치해줘야한다.

Node.js Binary Distributions를 참조하여 node.js의 저장소 위치를 추가한 뒤, node.js를 설치하도록하자. 아래는 현재 버전(2020-12-31 기준으로 v15.x)의 node.js의 저장소 위치를 추가한 뒤, 설치하는 명령어다.

# Using Ubuntu
curl -sL https://deb.nodesource.com/setup_current.x | sudo -E bash -
sudo apt-get install -y nodejs

이제 나머지 필요한 것들을 설치하면 끝이다. 필요한 경우에는 아래의 커맨드를 입력하여, 기본적인 빌드 툴을 설치하도록하자.

sudo apt-get install -y build-essential

끝! 이제 다시 코딩하도록 하자.