Node.js / npm / pnpm

이 기사에서는 Node.js 런타임을 설치하고 Ubuntu 26.04에서 널리 사용되는 패키지 관리자를 사용하는 방법을 다룹니다.

옵션 1: nvm을 통해 설치(권장)

nvm(Node Version Manager)을 사용하면 여러 Node.js 버전을 설치하고 전환할 수 있습니다. 가장 유연한 접근 방식은 다음과 같습니다.

nvm 설치


curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

셸 구성을 다시 로드합니다.


source ~/.bashrc

nvm 사용


# List available LTS versions
nvm ls-remote --lts
 
# Install the latest LTS version
nvm install --lts
 
# Install a specific version
nvm install 24
nvm install 22
 
# Switch versions
nvm use 24
 
# Set default version
nvm alias default 24
 
# List installed versions
nvm ls
 
# Uninstall a version
nvm uninstall 20

옵션 2: fnm을 통해 설치

fnm(Fast Node Manager)는 더 빠른 Rust 기반 Node.js 버전 관리자입니다.


# Install fnm
curl -fsSL https://fnm.vercel.app/install | bash
source ~/.bashrc
 
# Install Node.js
fnm install --lts
fnm install 24
 
# Switch versions
fnm use 24
fnm default 24
 
# List installed versions
fnm list

~/.bashrc 또는 ~/.zshrc에 자동 전환 지원을 추가합니다.


eval "$(fnm env --use-on-cd)"

.node-version 파일이 있는 디렉터리에 들어갈 때 버전이 자동으로 전환됩니다.

옵션 3: apt를 통해 설치

단일 버전만 필요한 경우 NodeSource 공식 저장소를 사용할 수 있습니다.


# Add the NodeSource repository (current LTS Node.js 24 example)
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
 
# Install Node.js (includes npm)
sudo apt install nodejs -y
 
# Verify
node --version
npm --version

npm 패키지 관리자

npm은 Node.js과 함께 설치되며 기본 패키지 관리자입니다.

기본 사용법


# Initialize a project
npm init -y
 
# Install a dependency
npm install express
 
# Install a dev dependency
npm install --save-dev typescript
 
# Install a tool globally
npm install -g nodemon
 
# Run scripts
npm run dev
npm start
 
# Update dependencies
npm update
npm outdated

중국 미러 구성


npm config set registry https://registry.npmmirror.com

구성을 확인합니다.


npm config get registry

pnpm

pnpm은 하드 링크와 콘텐츠 주소 지정이 가능한 스토리지를 사용하여 디스크 공간을 절약하고 더 빠른 설치를 제공합니다.

pnpm 설치


# Install via npm
npm install -g pnpm
 
# Or standalone installation
curl -fsSL https://get.pnpm.io/install.sh | sh -

pnpm 사용


# Initialize a project
pnpm init
 
# Install dependencies
pnpm add express
pnpm add -D typescript
 
# Install all dependencies
pnpm install
 
# Run scripts
pnpm dev
pnpm start
 
# Update dependencies
pnpm update
 
# Manage global packages
pnpm add -g nodemon

미러 구성


pnpm config set registry https://registry.npmmirror.com

pnpm 작업공간(Monorepo)

프로젝트 루트에 pnpm-workspace.yaml을 생성합니다.


packages:
  - 'packages/*'
  - 'apps/*'


# Install a dependency in a specific package
pnpm --filter @myapp/web add react
 
# Run a command across all packages
pnpm -r run build

방사

Yarn은 또 다른 인기 있는 패키지 관리자입니다.

원사 설치


# Enable via corepack
# Note: as of Node.js 25, corepack is no longer bundled with official distributions and must be installed separately
# (Node.js 24 LTS and earlier still bundle corepack, so you can skip the next line)
npm install -g corepack
corepack enable
corepack prepare yarn@stable --activate
 
# Or install via npm
npm install -g yarn

원사 사용


# Initialize a project
yarn init -2
 
# Install dependencies
yarn add express
yarn add --dev typescript
 
# Install all dependencies
yarn install
 
# Run scripts
yarn dev

코어팩

Corepack은 패키지 관리자를 관리하기 위한 Node.js 도구로, 프로젝트에서 지정된 버전의 pnpm 또는 Yarn을 사용하도록 보장합니다. Node.js 25부터 더 이상 공식 배포판과 함께 번들로 제공되지 않으며 npm install -g corepack과 함께 먼저 설치해야 합니다. Node.js 24 LTS 및 이전 버전은 여전히 번들로 제공됩니다.


# Node.js 25+ needs corepack installed first (skip on 24 LTS and earlier)
npm install -g corepack
 
# Enable corepack
corepack enable
 
# Specify the package manager in package.json
# "packageManager": "pnpm@9.15.0"

이렇게 하면 팀 구성원이 프로젝트를 복제한 후 자동으로 올바른 패키지 관리자 버전을 사용할 수 있습니다.

FAQ

전역 설치 권한 문제

nvm 또는 fnm을 통해 설치된 Node.js에는 sudo 권한이 필요하지 않습니다. apt를 통해 설치한 경우 권한 문제가 발생할 수 있습니다.


# Change the npm global install directory
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

.nvmrc 파일

Node.js 버전을 지정하려면 프로젝트 루트에 .nvmrc 파일을 생성합니다.


echo "24" > .nvmrc
nvm use  # Automatically reads .nvmrc

올바른 Node.js 버전 관리자 및 패키지 관리자를 선택하면 프런트엔드 및 백엔드 JavaScript 개발 환경이 크게 향상될 수 있습니다.