Skip to content

fnm install 명령어 가이드

fnm install 명령어는 새 Node.js 버전을 설치하는 데 사용됩니다.

명령어 구문

bash
fnm install [OPTIONS] [VERSION]

매개변수

VERSION

설치할 Node.js 버전을 지정합니다:

bash
# 주요 버전 설치 (자동으로 최신 마이너 버전 선택)
fnm install 20

# 특정 버전 설치
fnm install 20.10.0

# LTS 버전 설치
fnm install lts/iron

# 버전 지정 안 함, 버전 파일에서 읽기
fnm install

옵션

--lts

최신 LTS (Long Term Support) 버전을 설치합니다:

bash
fnm install --lts

--latest

최신 버전을 설치합니다 (비 LTS 포함):

bash
fnm install --latest

--use

설치 후 즉시 버전으로 전환합니다:

bash
fnm install 20 --use

--progress

다운로드 진행률 표시줄 표시를 제어합니다:

bash
# 자동 표시 (기본값)
fnm install 20 --progress=auto

# 항상 표시
fnm install 20 --progress=always

# 표시 안 함
fnm install 20 --progress=never

--node-dist-mirror

Node.js 다운로드 미러를 지정합니다:

bash
fnm install 20 --node-dist-mirror=https://npmmirror.com/mirrors/node

--arch

설치 아키텍처를 지정합니다:

bash
# x64 버전 설치
fnm install 20 --arch=x64

# ARM64 버전 설치
fnm install 20 --arch=arm64

--fnm-dir

fnm 설치 디렉토리를 지정합니다:

bash
fnm install 20 --fnm-dir=/custom/path

--log-level

로그 레벨을 설정합니다:

bash
fnm install 20 --log-level=quiet
fnm install 20 --log-level=error
fnm install 20 --log-level=info

--corepack-enabled

Corepack 지원을 활성화합니다:

bash
fnm install 20 --corepack-enabled

사용 예제

LTS 버전 설치

bash
# 최신 LTS 설치
fnm install --lts

# 특정 LTS 버전 설치
fnm install lts/iron    # Node.js 20.x
fnm install lts/hydrogen # Node.js 18.x

특정 버전 설치

bash
# 주요 버전 설치
fnm install 20

# 마이너 버전 설치
fnm install 20.10

# 정확한 버전 설치
fnm install 20.10.0

설치 후 사용

bash
# 설치 후 즉시 전환
fnm install 20 --use

# 설치 후 기본값으로 설정
fnm install 20 --use && fnm default 20

미러를 사용하여 빠른 다운로드

bash
# 미러 사용
fnm install 20 --node-dist-mirror=https://npmmirror.com/mirrors/node

특정 아키텍처 설치

bash
# Apple Silicon Mac 에서 x64 버전 설치
fnm install 20 --arch=x64

버전 형식

fnm 은 여러 버전 형식을 지원합니다:

형식예제설명
주요 버전20최신 20.x.x
마이너 버전20.10최신 20.10.x
정확한 버전20.10.0정확한 버전
LTS 이름lts/ironLTS 버전 코드명
latest--latest최신 버전

LTS 버전 코드명

코드명버전릴리스 날짜
Iron20.x2023-10
Hydrogen18.x2022-10
Gallium16.x2021-10
Erbium14.x2020-10
Dubnium12.x2019-10

환경 변수

환경 변수를 통해 기본 동작을 구성할 수 있습니다:

bash
# 미러 설정
export FNM_NODE_DIST_MIRROR=https://npmmirror.com/mirrors/node

# Corepack 활성화
export FNM_COREPACK_ENABLED=true

# 설치 디렉토리 설정
export FNM_DIR=~/.fnm

일반적인 문제

설치 실패

bash
# 미러 사용 시도
fnm install 20 --node-dist-mirror=https://npmmirror.com/mirrors/node

# 자세한 로그 보기
fnm install 20 --log-level=info

버전이 이미 존재함

bash
# 설치된 버전 보기
fnm list

# 설치된 버전 사용
fnm use 20

느린 다운로드

bash
# 미러 구성
export FNM_NODE_DIST_MIRROR=https://npmmirror.com/mirrors/node
fnm install 20

관련 링크