리눅스(Ubuntu) 환경에서 Node.js와 npm 최신 버전 설치 및 환경 설정 완벽 가이드

리눅스 환경, 특히 가장 널리 사용되는 Ubuntu에서 Node.js와 패키지 관리자인 npm(Node Package Manager)을 설치하는 것은 웹 개발을 시작하는 데 있어 가장 기본적인 단계입니다. npm은 수많은 자바스크립트 라이브러리와 프레임워크를 손쉽게 관리할 수 있게 해주는 핵심 도구입니다. 이 가이드에서는 2025년 최신 기준으로 가장 안정적이고 권장되는 방법들을 상세히 설명하여, 초보자도 쉽게 Node.js 개발 환경을 구축할 수 있도록 돕겠습니다.

Node.js와 npm은 웹 백엔드 개발, 프론트엔드 빌드 도구 사용, 그리고 다양한 개발 환경에서 필수적으로 요구됩니다. 특히 최신 버전을 유지하는 것은 보안 및 성능 최적화에 매우 중요합니다.

🚀 리눅스 npm 설치를 위한 준비 사항 확인하기

Node.js와 npm을 설치하기 전에 몇 가지 기본적인 준비 사항을 확인해야 합니다. 이 가이드는 Ubuntu 환경을 기준으로 작성되었으며, 다른 Debian 기반 리눅스 배포판에서도 유사하게 적용될 수 있습니다.

• 운영체제: Ubuntu 20.04 LTS 이상 권장 (현재 2025년 기준)
• 터미널 접근 권한: 설치 명령을 실행할 수 있는 사용자 권한 (sudo 명령어 사용 가능)
• 기존 버전 확인 및 제거 (선택 사항): 혹시 모를 충돌을 방지하기 위해, 이전에 설치된 Node.js 및 npm 버전이 있다면 이를 확인하고 제거하는 것이 좋습니다.

가장 먼저 터미널을 열어 시스템 패키지 목록을 최신 상태로 업데이트해야 합니다. 이 과정을 통해 모든 종속성이 올바르게 해결될 수 있습니다.

sudo apt update sudo apt upgrade -y

이제 본격적인 설치를 위한 환경이 준비되었습니다. Node.js와 npm을 설치하는 방법은 여러 가지가 있지만, 공식 NodeSource 저장소를 이용하는 것이 최신 버전을 안전하고 효율적으로 설치할 수 있는 가장 좋은 방법으로 권장됩니다.

⚙️ NodeSource 저장소를 이용한 최신 Node.js 및 npm 설치 방법 상세 더보기

NodeSource는 Node.js 최신 버전을 쉽게 설치할 수 있도록 공식적으로 지원하는 외부 저장소입니다. 이 방법을 사용하면 Ubuntu 기본 저장소보다 더 최신의 안정적인 버전을 설치할 수 있습니다. 2025년 현재 LTS(Long Term Support) 버전 또는 최신 Current 버전 중 하나를 선택하여 설치할 수 있습니다.

Node.js LTS 버전 설치 명령어 확인하기

LTS 버전은 장기간 안정적으로 지원되는 버전으로, 대부분의 프로덕션 환경에서 권장됩니다. 아래는 LTS 버전(예: Node.js 20.x 기준)을 설치하는 단계입니다.

# NodeSource 저장소 설정 (LTS 버전) curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
Node.js 및 npm 설치
sudo apt install -y nodejs

설치 확인 및 버전 확인 상세 더보기

설치가 완료되면, 터미널에서 다음 명령어를 입력하여 Node.js와 npm이 올바르게 설치되었는지, 그리고 어떤 버전이 설치되었는지 확인합니다.

node -v npm -v

만약 버전 정보가 정상적으로 출력된다면, 설치가 성공적으로 완료된 것입니다. npm은 Node.js를 설치할 때 자동으로 함께 설치됩니다.

🔧 npm 권한 문제 해결 및 전역 패키지 환경 설정 보기

npm을 사용하여 전역 패키지(global package, 예: npm install -g )를 설치할 때, EACCES와 같은 권한 오류가 발생하는 경우가 많습니다. 이는 npm이 기본적으로 시스템 디렉토리에 설치를 시도하지만, 일반 사용자에게는 해당 디렉토리에 쓰기 권한이 없기 때문입니다.

가장 안전하고 권장되는 방법은 npm의 기본 디렉토리를 사용자 홈 디렉토리 내의 다른 위치로 변경하는 것입니다.

npm 기본 디렉토리 변경 상세 더보기

아래 단계를 따라 사용자의 홈 디렉토리에 전역 패키지 설치 경로를 설정하고, 환경 변수를 수정하여 권한 문제를 해결할 수 있습니다.

1. 새로운 디렉토리 생성:

mkdir ~/.npm-global

2. npm의 기본 설치 경로를 새 디렉토리로 설정:

npm config set prefix '~/.npm-global'

3. 새로운 경로를 환경 변수(PATH)에 추가:

echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.profile source ~/.profile

위 설정 후에는 sudo 없이도 전역 패키지를 설치할 수 있으며, 시스템의 보안과 안정성을 유지할 수 있습니다. 이는 리눅스 환경에서 npm을 사용할 때 가장 중요하게 적용해야 할 환경 설정 중 하나입니다.

🔄 Node.js와 npm 버전 관리 및 업데이트 확인하기

개발 환경의 유연성과 안정성을 위해 여러 버전의 Node.js를 사용해야 하는 경우가 있습니다. 이럴 때는 NVM(Node Version Manager)을 사용하여 Node.js 버전을 손쉽게 전환하고 관리하는 것이 매우 효율적입니다.

NVM(Node Version Manager) 설치 방법 확인하기

NVM을 사용하면 여러 Node.js 버전을 설치하고, 프로젝트별로 필요한 버전을 선택할 수 있습니다. 현재(2025년) 기준으로 가장 최신 스크립트를 사용하여 설치합니다.

# NVM 설치 curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
설치 후, 환경 변수 적용을 위해 터미널 재시작 또는 아래 명령 실행
source ~/.bashrc # 또는 ~/.zshrc 등 사용 중인 쉘 환경에 따라 nvm --version

NVM을 이용한 버전 설치 및 전환 보기

NVM이 설치되었다면, 아래 명령어를 사용하여 원하는 Node.js 버전을 설치하고 사용할 수 있습니다.

• 특정 버전 설치 (예: 20 LTS): nvm install 20
• 설치된 버전 목록 보기: nvm ls
• 사용할 버전 선택: nvm use 20
• LTS 버전 설치: nvm install --lts
• 기본 버전 설정: nvm alias default 20

🛑 리눅스 npm 설치 시 흔한 에러 해결 방법 상세 더보기

리눅스 환경에서 Node.js와 npm을 설치하고 사용할 때 발생할 수 있는 몇 가지 흔한 에러와 그 해결책을 정리했습니다.

apt install 오류 해결

E: Unable to locate package nodejs와 같은 오류가 발생한다면, 이는 시스템이 NodeSource와 같은 외부 저장소를 인식하지 못했거나 저장소 설정에 문제가 있을 때 발생합니다. NodeSource 저장소를 올바르게 추가했는지 다시 확인하고, sudo apt update를 실행했는지 확인합니다.

npm 캐시 문제 해결

패키지 설치 중 예상치 못한 문제가 발생하거나 종속성 오류가 반복될 경우, npm 캐시를 정리해주는 것이 좋습니다.

npm cache clean --force

symbolic link 오류 해결

NVM 등을 사용하여 버전을 전환한 후에도 이전 버전이 사용되거나 명령을 찾지 못하는 경우, 환경 변수(PATH)가 올바르게 설정되었는지 확인하고, source ~/.bashrc 또는 nvm use 을 다시 실행해야 합니다.

🎉 Node.js와 npm을 활용한 리눅스 개발 환경 마무리 확인하기

이제 리눅스 환경에서 Node.js와 npm 설치를 성공적으로 완료했습니다. 성공적으로 설치를 마친 후에는 npm을 통해 다양한 개발 도구들을 설치하고 활용할 수 있습니다.

예를 들어, 리액트(React) 개발에 필수적인 create-react-app과 같은 도구를 전역으로 설치하는 경우, 앞에서 설정한 권한 설정을 통해 sudo 없이 안전하게 설치할 수 있습니다.

# React 개발 도구 설치 예시 npm install -g create-react-app
Next.js 프로젝트 생성 예시
npm create next-app my-app

이 가이드에서 설명한 NodeSource를 이용한 설치 및 NVM을 통한 버전 관리는 2025년 현재 가장 모범적인 Node.js 개발 환경 구축 방법입니다. 안정적인 개발 환경을 기반으로 효율적인 개발을 진행하시길 바랍니다.