Node.js는 JavaScript를 서버 사이드에서 실행하기 위한 플랫폼으로, 웹 애플리케이션 및 도구 개발에 널리 사용됩니다. 한편, Ubuntu는 많은 개발자와 서버 관리자가 선호하는 Linux 배포판입니다. 이 두 가지를 결합함으로써 안정성·유연성·속도에 뛰어난 개발 환경을 구축할 수 있습니다. Ubuntu에 Node.js를 도입하면, 예를 들어 다음과 같은 장점을 얻을 수 있습니다。
OS가 가볍고 불필요한 기능이 적어, 리소스를 효율적으로 활용할 수 있다
개발·검증·운영 환경까지 Linux 기반으로 통일할 수 있다
Node.js와의 친화성이 높아, 다양한 도구(npm, nvm 등)와의 연동도 원활하다
따라서 Ubuntu와 Node.js의 조합은 프론트엔드·백엔드에 관계없이 개발 환경으로서 매우 매력적이라고 할 수 있습니다。
이 글의 대상 독자와 목적
본 글은 다음과 같은 분들을 대상으로 작성되었습니다：
Ubuntu에서 처음으로 Node.js를 사용하고 싶은 사람
어떤 설치 방법이 최적인지 알고 싶은 사람
Node.js를 최신 버전으로 사용하고 싶지만 설정에 불안이 있는 사람
이 글을 읽음으로써 Ubuntu에서 Node.js 설치 방법을 3가지 관점으로 비교하고, 목적과 스킬에 맞는 최적의 도입 방법을 선택할 수 있게 됩니다. 또한 npm 및 yarn과 같은 주변 도구의 도입, 흔히 발생하는 오류에 대한 대처법까지 다룸으로써 Node.js 환경을 안심하고 활용할 수 있도록 하는 것을 목표로 합니다。
2. Ubuntu에서 Node.js 설치 방법 비교 개요
설치 방법은 3가지이며, 각각 특징이 있습니다
Ubuntu에서 Node.js를 설치하는 방법은 주로 다음의 3가지로 구분됩니다：
APT(Advanced Package Tool)를 이용한 표준 패키지 설치
NodeSource가 제공하는 PPA(개인 패키지 아카이브)를 이용한 설치
nvm(Node Version Manager)를 사용한 유연한 버전 관리 설치
각 방법마다 장단점이 있으며, 사용 목적이나 시스템 구성에 따라 최적의 선택이 달라집니다. 아래는 각각의 특징을 정리한 비교표입니다。
Node.js 설치 방법 비교표
설치 방법
주요 특징
장점
단점
추천 대상
APT(표준)
Ubuntu 공식 저장소 사용
간단·안전
버전이 오래될 수 있음
가장 빠르게 시도하고 싶은 초보자
NodeSource PPA
APT로 최신 Node.js 관리 가능
비교적 최신 버전 지원
PPA 추가 필요
안정 버전을 사용하고 싶은 개발자
nvm
여러 버전 전환 가능
유연·전역에 최적
셸 설정 등이 필요
학습·개발 전반에 추천
왜 비교가 중요한가?
Ubuntu는 안정성이 높은 OS이지만, 그만큼 APT 저장소에 포함된 소프트웨어 버전이 다소 오래된 경향이 있습니다. 따라서 최신 Node.js 기능을 사용하고 싶거나 여러 버전을 시험해 보고 싶은 사람은 APT 외의 방법을 선택하는 것이 바람직합니다. 반대로, “그냥 바로 시도하고 싶다”, “운영 서버에 과도한 설정을 추가하고 싶지 않다”는 경우에는 APT 설치만으로도 충분한 경우가 있습니다.
어떤 것을 선택해야 할까?
결론적으로, 개발자나 중장기적으로 Node.js를 활용할 계획이 있는 분에게는 nvm을 통한 설치가 가장 권장됩니다. 이유는 다음과 같습니다：
쉽게 최신 버전 및 이전 버전 전환 가능
npm과 함께 설치됨
권한 문제에 고민할 일이 적음(sudo 불필요)
3. 방법①：APT 패키지로 Node.js를 간편하게 설치（Ubuntu 공식）
APT란？Ubuntu에서의 표준 패키지 관리 방식
APT(Advanced Package Tool)는 Ubuntu를 비롯한 Debian 계열 Linux 배포판에서 표준 패키지 관리 시스템입니다. APT를 사용하면 소프트웨어의 설치·업데이트·삭제를 한 명령어로 간단히 수행할 수 있습니다. Ubuntu 공식 리포지토리에는 Node.js 패키지도 등록되어 있습니다. 따라서 특별한 준비 없이도 Node.js를 바로 설치할 수 있는 것이 이 방법의 매력입니다.
설치 절차
먼저 APT 패키지 목록을 최신으로 업데이트합니다。
sudo apt update
Node.js와 npm을 설치합니다。
sudo apt install nodejs npm
설치되었는지 확인합니다。
node -v
npm -v
각 명령을 실행한 후 버전 정보가 표시되면 설치가 성공한 것입니다.
장점：무엇보다 간단하고 안전
Ubuntu 공식 리포지토리를 통해서이므로, 신뢰성이 높다
명령이 간단해서, 초보자도 헷갈리기 쉽지 않다
관리 대상이 APT이기 때문에, 시스템 업데이트와 연동하기 쉽다
특히, 「Node.js를 시험적으로 사용해 보고 싶다」「업무 서버에 과도한 설정을 추가하고 싶지 않다」와 같은 경우에 유효합니다.
단점：버전이 오래될 가능성이 있다
APT 패키지는 안정성을 중시하기 때문에, 제공되는 Node.js 버전이 몇 세대 전일 수도 있습니다。 예를 들어, Ubuntu 22.04에서는 APT를 통해 설치되는 Node.js가 버전 12나 14인 경우가 있으며, 최신 기능이나 보안 개선이 반영되지 않을 수 있습니다。 또한, 버전 관리가 어려워서 여러 프로젝트에서 서로 다른 Node.js 버전을 사용하고 싶을 경우에는 적합하지 않습니다.
이 방법이 적합한 사람
무엇보다 바로 Node.js를 시험해 보고 싶은 초보자
안정 버전으로 충분한 업무 환경
여러 버전을 구분해서 사용할 필요가 없는 경우
4. 방법②: NodeSource의 PPA로 최신 버전 도입
NodeSource란?
NodeSource는 Node.js 공식 팀과는 별도로, Node.js의 안정 버전 및 최신 버전을 신속하게 제공하는 신뢰성 높은 소스입니다. 특히 Ubuntu와 Debian에서, APT를 사용하면서도 최신 Node.js를 도입하고자 하는 사용자에게 강력한 수단이 됩니다. Node.js 공식 웹사이트에서도 권장되고 있으며, 기업 수준의 운영에도 많이 사용됩니다.
보안상, 신뢰할 수 있는 소스인지 판단이 요구된다（NodeSource는 기본적으로 문제 없음）
이 방법이 적합한 사람
최신 Node.js를 안정적으로 사용하고 싶은 개발자
Ubuntu 표준 저장소로는 부족하지만, nvm까지는 사용하고 싶지 않은 사용자
APT로 일괄 패키지 관리를 유지하고 싶은 사람
5. 방법③: nvm으로 유연하게 버전 관리하기 (권장)
nvm이란? Node.js 버전을 자유롭게 전환할 수 있는 편리한 도구
nvm（Node Version Manager）은 Node.js 버전을 여러 개 관리·전환할 수 있는 커맨드라인 도구입니다. 프로젝트마다 다른 버전을 사용하고 싶은 개발자나 최신 버전과 LTS 버전을 시험해 보고 싶은 사용자에게 매우 편리한 존재입니다.
nvm을 사용하면 Ubuntu 시스템에 직접 Node.js를 설치하지 않고도, 사용자 환경에서 완결된 유연한 개발 환경을 만들 수 있습니다.
npm（Node Package Manager）은 Node.js의 패키지 관리 도구로, 전 세계 개발자들이 공개한 라이브러리와 툴을 쉽게 도입·관리할 수 있습니다. Node.js를 사용한 개발에서는 npm의 존재가 필수적입니다.
APT나 NodeSource로 Node.js를 설치한 경우에도 보통 npm이 함께 설치됩니다. nvm을 통해서도, nvm install 시점에 npm이 자동으로 포함됩니다.
버전 확인 명령:
npm -v
npm 기본 사용법
작업 내용
명령 예시
패키지 설치
npm install <패키지명>
전역 설치
npm install -g <패키지명>
제거
npm uninstall <패키지명>
프로젝트 초기화
npm init 또는 npm init -y
패키지 목록 표시
npm list 또는 npm list -g
npm은 프로젝트 단위로 의존 라이브러리를 관리할 때 중요한 역할을 합니다.
yarn이란? npm의 대안으로 인기 있는 선택지
yarn은 Facebook이 개발한 npm 대체 도구로, 보다 빠르고 안정적인 패키지 관리를 목표로 만들어졌습니다. npm과 명령이 거의 호환되며, npm에서 할 수 있는 일은 기본적으로 yarn에서도 가능합니다.
yarn 설치 절차 (npm 경유)
npm install -g yarn
설치가 완료되면, 다음 명령으로 확인합니다：
yarn -v
yarn 기본 사용법
작업 내용
명령 예시
패키지 설치
yarn add <패키지명>
전역 설치
yarn global add <패키지명>
제거
yarn remove <패키지명>
프로젝트 초기화
yarn init
패키지 목록 표시
yarn list 또는 yarn global list
npm과 yarn, 어느 것을 사용해야 할까?
비교 항목
npm
yarn
표준성
Node.js에 표준 포함
별도 설치 필요
처리 속도
보통
캐시 활용으로 고속
잠금 파일
package-lock.json
yarn.lock
명령 호환성
–
거의 호환(주의 필요)
최근 npm(v7 이상)은 크게 개선되었기 때문에, 어느 것을 선택해도 큰 차이는 없습니다. 프로젝트나 팀에서 이미 사용 중인 쪽에 맞추는 것이 무난합니다.
7. 자주 발생하는 오류와 트러블 대처
자주 발생하는 오류와 그 해결 방법
■ node: command not found
원인： Node.js가 올바르게 설치되지 않았거나 경로가 설정되지 않은 상태입니다. 특히 nvm을 설치한 후 쉘 설정이 반영되지 않은 경우에 많이 발생합니다. 대처 방법：
.bashrc와 .zshrc를 다시 읽어들여 nvm을 활성화
source ~/.bashrc
그래도 안 될 경우, 재로그인 또는 재시작
■ E: Unable to locate package nodejs
원인： APT 패키지 리스트가 오래되었거나 올바른 PPA가 추가되지 않은 상태입니다. 대처 방법：
APT 리스트를 업데이트
sudo apt update
NodeSource 등을 이용하고 있는 경우, 설정 스크립트를 다시 실행
■ npm ERR! permission denied
원인： npm으로 전역 설치를 시도할 때 일반 사용자에게 파일 접근 권한이 부족한 것이 원인입니다. 대처 방법：
Ubuntu 버전과 Node.js 조합에 주의 (구버전 LTS인 경우 리포지토리가 업데이트되지 않을 수 있음)
8. 자주 묻는 질문(FAQ)
Q1. Node.js 버전을 확인하려면 어떻게 해야 하나요?
A. 터미널에서 아래 명령을 실행하면 확인할 수 있습니다。
node -v
또한, npm 버전도 함께 확인하려면 아래와 같습니다。
npm -v
Q2. Ubuntu에서 여러 Node.js 버전을 사용하고 싶다면 어떻게 해야 하나요?
A. nvm(Node Version Manager)를 사용하는 것이 가장 쉽고 안전한 방법입니다. 설치 후에는 다음과 같은 명령으로 버전을 전환할 수 있습니다。
nvm install 16
nvm use 16
이처럼 프로젝트마다 다른 버전을 사용하고 싶어도, nvm이면 유연하게 대응할 수 있습니다。
Q3. nvm으로 설치한 Node.js가 적용되지 않습니다. 왜인가요?
A. 대부분의 경우, 쉘 설정 파일이 로드되지 않은 것이 원인입니다. 설치 직후 아래를 실행해 주세요。
source ~/.bashrc
또는 사용 중인 쉘이 zsh라면 source ~/.zshrc 를 실행해 주세요。
Q4. yarn과 npm의 차이는 무엇인가요? 어느 것을 사용하면 좋을까요?
A. 기본적인 기능은 거의 동일하지만, yarn은 캐시를 활용한 빠른 설치와 명시적인 의존 관리(yarn.lock)에 강점이 있습니다. 최근 npm(v7 이상)도 크게 개선되어 어느 쪽을 사용해도 문제 없습니다。 프로젝트나 팀에서 이미 사용 중인 쪽에 맞추는 것이 무난입니다。
Q5. Node.js와 Deno 및 Bun은 어떻게 다른가요?
A. Deno와 Bun은 Node.js의 과제를 개선하기 위해 개발된 별도의 실행 환경입니다。
Deno：TypeScript 지원, 보안 강화, 표준 라이브러리 포함
Bun：Node.js보다 빠른 실행 성능과 내장 패키지 관리 기능을 가짐
하지만 현재로서는 npm 패키지의 압도적인 자산을 활용할 수 있는 Node.js가가장 실용적인 선택입니다。
9. 요약: 목적에 맞는 설치 방법을 선택하자
Ubuntu에서 Node.js를 도입하는 방법은 여러 가지가 있지만, 각각 명확한 특징과 사용처가 있습니다. 이 기사에서는 대표적인 3가지 설치 방법을 소개하고, 그 비교와 적절한 선택 방법을 설명했습니다。아래에 각각의 방법에 대한 포인트를 다시 정리해 두었습니다。
APT（Ubuntu 공식）
장점：가장 간편하고 안전함
단점：버전이 오래될 가능성이 있음
추천：바로 시도해 보고 싶은 초보자
NodeSource PPA
장점：비교적 최신 Node.js를 APT 감각으로 도입할 수 있음
단점：PPA 추가가 필요함
추천：안정적인 최신 버전을 사용하고 싶은 개발자
nvm（Node Version Manager）
장점：여러 버전 전환이 가능하고 유연성이 높음
단점：초기 설정이 다소 복잡함
추천：중급 이상 개발자나 여러 프로젝트를 다루는 사람에게 최적
또한, npm이나 yarn과 같은 패키지 관리 도구 활용 및 흔히 발생하는 오류에 대한 대처법도 소개했습니다. Node.js 도입은 겉보기엔 어려워 보일 수 있지만, 적절한 방법을 선택하면 Ubuntu에서도 안정적으로 활용할 수 있는 개발 환경을 쉽게 구축할 수 있습니다。앞으로 더 프로젝트를 확장하고 싶은 분은 nvm을 이용한 관리를 기본으로 삼고, 팀 개발이나 CI/CD 적용에도 도전해 보면 좋습니다。
