우분투에서 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