리눅스 환경에서 개발을 진행하다 보면 프로젝트마다 요구하는 Node.js 버전이 달라 난감한 상황이 발생하곤 합니다. 시스템 전체에 하나의 버전만 설치해서 사용할 경우 권한 문제(Permission Issue)나 호환성 충돌이 빈번하게 일어납니다. 이러한 문제를 해결하기 위해 가장 널리 사용되는 도구가 바로 NVM(Node Version Manager)입니다. 2025년 12월 현재, NVM은 v0.40.3 버전까지 업데이트되었으며 더욱 안정적인 환경 관리 기능을 제공하고 있습니다. 이번 글에서는 리눅스(Ubuntu/CentOS) 환경에서 NVM을 설치하고 다양한 노드 버전을 자유자재로 다루는 방법을 상세히 알아보겠습니다.
📚 함께 읽으면 좋은 글
1. 리눅스 NVM 설치 준비 및 필수 패키지 확인하기
NVM을 설치하기에 앞서, 설치 스크립트를 다운로드하고 실행할 수 있는 기본 도구들이 리눅스 서버에 설치되어 있는지 확인해야 합니다. 우분투(Ubuntu)나 데비안(Debian) 계열을 사용 중이라면 apt 패키지 매니저를, CentOS나 RHEL 계열이라면 yum 또는 dnf를 사용하게 됩니다. 터미널을 열고 curl 또는 wget이 설치되어 있는지 확인 후, 없다면 설치를 진행해 주세요. 안정적인 설치를 위해 시스템 패키지 목록을 최신 상태로 업데이트하는 과정을 먼저 수행하는 것이 좋습니다.
2. 터미널 명령어를 통한 NVM 다운로드 및 설정 적용하기
필수 패키지가 준비되었다면, 공식 설치 스크립트를 통해 NVM을 설치할 차례입니다. 2025년 기준 최신 안정 버전인 v0.40.3을 설치하는 명령어는 아래와 같습니다. 이 명령어는 NVM 저장소를 복제하고 셸 설정 파일(.bashrc 또는 .zshrc)에 환경 변수를 자동으로 추가해 줍니다. 명령어를 입력한 후에는 반드시 터미널을 재시작하거나 설정 파일을 다시 로드(source)해야 NVM 명령어를 인식할 수 있습니다.
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash설치가 완료되었다면 아래 명령어로 환경 설정 파일을 적용하고 정상 설치 여부를 확인합니다.
source ~/.bashrc nvm --version버전 번호(예: 0.40.3)가 정상적으로 출력된다면 NVM이 시스템에 올바르게 설치된 것입니다.
3. Node.js 버전별 설치 및 사용 방법 상세 보기
NVM이 설치되었다면 이제 원하는 버전의 Node.js를 마음껏 설치할 수 있습니다. 개발 환경에서는 최신 기능이 포함된 ‘Current’ 버전보다는, 보안 업데이트와 안정성이 보장되는 ‘LTS(Long Term Support)’ 버전을 사용하는 것이 일반적입니다. 2025년 12월 기준 Node.js v24.x 버전이 LTS로 제공되고 있으며, v25.x 버전이 최신 기능을 담은 Current 버전입니다. 특정 버전을 콕 집어 설치하거나 가장 최신 LTS 버전을 자동으로 찾아 설치하는 명령어를 익혀두면 매우 유용합니다.
- 최신 LTS 버전 설치:
nvm install --lts - 가장 최신 버전 설치:
nvm install node - 특정 버전(예: 20.10.0) 설치:
nvm install 20.10.0
설치가 완료되면 해당 버전이 자동으로 현재 사용 중인 버전으로 설정됩니다.
4. 개발 환경에 맞는 노드 버전 변경 및 관리하기
여러 프로젝트를 동시에 진행하다 보면 A 프로젝트는 Node.js 18 버전을, B 프로젝트는 Node.js 24 버전을 써야 할 때가 있습니다. NVM을 사용하면 터미널 세션마다 다른 버전을 활성화할 수 있어 이러한 상황에 완벽하게 대응할 수 있습니다. 설치된 노드 버전 목록을 확인하고, 필요에 따라 즉시 버전을 교체하는 방법을 알아보겠습니다. 또한, 터미널을 새로 열 때마다 기본으로 적용될 디폴트(default) 버전을 설정해두면 매번 버전을 변경하는 번거로움을 줄일 수 있습니다.
- 설치된 버전 목록 확인:
nvm ls - 설치 가능한 원격 버전 목록 확인:
nvm ls-remote - 특정 버전으로 전환:
nvm use 24 - 기본(Default) 버전 설정:
nvm alias default 24
프로젝트 루트 폴더에 .nvmrc 파일을 생성하고 버전만 적어두면 nvm use 명령어만으로 해당 프로젝트 버전을 자동으로 인식시킬 수도 있습니다.
5. 설치 오류 해결 및 환경 변수 점검하기
설치 과정에서 가장 흔하게 겪는 문제는 nvm: command not found 오류입니다. 이는 대부분 셸 설정 파일(profile)이 제대로 로드되지 않았거나 경로(PATH) 설정이 꼬였을 때 발생합니다. 우분투 사용자는 .bashrc, 맥이나 Zsh 사용자는 .zshrc 파일 하단에 NVM 초기화 스크립트가 제대로 포함되어 있는지 확인해야 합니다. 만약 스크립트가 없다면 수동으로 추가해 주어야 하며, 권한 문제(EACCES)가 발생할 경우에는 sudo를 사용하지 말고 NVM을 통해 재설치하는 것이 원칙입니다.
시스템의 패키지 매니저(apt, yum)로 설치된 기존 Node.js와 충돌이 날 수 있으니, 가급적 기존 노드는 삭제하고 NVM으로만 버전을 관리하는 것을 권장합니다.
📌 추가로 참고할 만한 글
FAQ: 자주 묻는 질문
Q1. NVM 설치 시 sudo 명령어를 써야 하나요?
아니요, NVM은 사용자 홈 디렉터리에 설치되도록 설계되었으므로 sudo 권한이 필요 없습니다. 오히려 sudo를 사용하면 권한 꼬임 현상이 발생할 수 있습니다.
Q2. 터미널을 껐다 켜면 nvm 명령어가 안 먹힙니다.
셸 설정 파일(.bashrc 또는 .zshrc)에 NVM 초기화 코드가 저장되지 않아서 그렇습니다. 설치 스크립트 실행 후 해당 파일 끝부분에 export NVM_DIR… 로 시작하는 코드가 있는지 확인하고 없다면 수동으로 추가해 주세요.
Q3. 2025년 현재 가장 추천하는 Node.js 버전은 무엇인가요?
프로덕션(실무) 환경이라면 LTS 버전인 v24.x(또는 최신 LTS)를 사용하는 것이 가장 안정적입니다. 최신 학습 목적이라면 v25.x 이상을 설치하셔도 무방합니다.
How to Install Node.js with npm on Ubuntu (Linux) (2025)
This video is relevant because it provides a visual walkthrough of installing Node.js on Ubuntu using NVM, specifically tailored for the 2025 context and covering troubleshooting steps discussed in the post.
How to Install Node.js with npm on Ubuntu (Linux) (2025) – YouTube
ProgrammingKnowledge · 888 조회수