우분투에서 Node.js 22 설치 방법 (NodeSource + apt로 npm까지 한 번에)

Ubuntu에서 NodeSource 저장소로 Node.js 22와 npm을 apt로 설치하는 방법 정리. 설치 확인, 버전 체크, 흔한 이슈까지 포함.

우분투에서 Node.js 22 설치 방법 (NodeSource + apt)

Ubuntu 기본 저장소 말고, NodeSource 레포지토리 붙여서 Node.js 22랑 npm까지 깔끔하게 설치하는 방법임. 서버/개발머신에서 자주 쓰는 흐름 그대로 정리함.

설치 전 체크

  • apt 패키지 목록 최신화 필요함
  • NodeSource 설치 스크립트는 curl로 받아서 root 권한으로 실행하는 구조라, 명령어 오타/URL 잘못 넣으면 위험할 수 있음(복붙 주의)

NodeSource로 Node.js 22 설치

아래 순서대로 실행하면 됨.

sudo apt update

sudo apt install -y curl

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -

sudo apt install -y nodejs

포인트는 3번째 줄임. setup_22.x 스크립트가 NodeSource 레포지토리를 시스템에 등록해주고, 그 다음 apt install nodejs로 설치가 진행됨.

참고로 다른 버전 깔고 싶으면 이렇게 바꾸면 됨.

  • Node.js 24로 가고 싶음 → setup_24.x
  • Node.js 20으로 내리고 싶음 → setup_20.x

설치 확인 (버전 체크)

설치 끝나면 버전 확인으로 마무리하면 됨.

node -v
npm -v
  • node -v에서 v22.x.x 형태 나오면 정상
  • npm -v도 숫자 버전 나오면 정상

자주 겪는 이슈 / 팁

  • node는 설치됐는데 npm이 없음 → 보통 NodeSource로 설치하면 같이 오는데, 꼬였으면 sudo apt install -y nodejs 재설치 권장함
  • 권한 문제(EACCES)로 npm global 설치가 막힘 → 서버면 nvm 쓰거나, npm global prefix를 사용자 홈으로 바꾸는 방식이 일반적임
  • native 모듈 빌드 에러(node-gyp)build-essential 같은 빌드 도구 필요할 수 있음: sudo apt install -y build-essential

이대로 해두면 Ubuntu에서 Node.js 런타임 환경 바로 세팅 끝임. 이후에는 PM2, NestJS, Express 등 원하는 스택 얹으면 됨.

Was this helpful?

0 / 0