fnm 다운로드 관리

fnm 은 빠른 Node.js 버전 획득을 위한 유연한 다운로드 구성 옵션을 제공합니다.

기본 다운로드

설치 명령어

bash

# 최신 LTS 설치
fnm install --lts

# 특정 버전 설치
fnm install 20

# 최신 버전 설치
fnm install --latest

다운로드 진행률

fnm 은 기본적으로 다운로드 진행률 표시줄을 표시합니다:

bash

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

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

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

미러 구성

미러가 필요한 이유

공식 Node.js 다운로드 소스는 해외에 위치해 있어 중국 본토에서는 다운로드가 느릴 수 있습니다. 미러를 구성하면 다운로드 속도를 크게 향상시킬 수 있습니다.

구성 방법

방법 1: 환경 변수

bash

export FNM_NODE_DIST_MIRROR=https://npmmirror.com/mirrors/node

방법 2: 명령줄 매개변수

bash

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

방법 3: Shell 구성

bash

# Shell 구성 파일에 추가
eval "$(fnm env --use-on-cd --node-dist-mirror=https://npmmirror.com/mirrors/node)"

일반적인 미러 소스

미러 소스	URL	설명
Node.js 공식	`https://nodejs.org/dist`	기본 소스
npmmirror	`https://npmmirror.com/mirrors/node`	권장
칭화대학교	`https://mirrors.tuna.tsinghua.edu.cn/nodejs-release`	교육망 최적화
화웨이 클라우드	`https://mirrors.huaweicloud.com/nodejs`	엔터프라이즈 등급

플랫폼별 구성

Linux / macOS

bash

# ~/.bashrc 또는 ~/.zshrc 에 추가
export FNM_NODE_DIST_MIRROR=https://npmmirror.com/mirrors/node

Windows PowerShell

powershell

# 사용자 환경 변수 설정
[Environment]::SetEnvironmentVariable("FNM_NODE_DIST_MIRROR", "https://npmmirror.com/mirrors/node", "User")

Windows CMD

cmd

setx FNM_NODE_DIST_MIRROR "https://npmmirror.com/mirrors/node"

다운로드 디렉토리

기본 디렉토리

fnm 은 Node.js 를 다음 위치에 다운로드하고 설치합니다:

~/.fnm/
├── fnm                 # fnm 바이너리
├── node-versions/      # Node.js 버전 디렉토리
│   ├── v20.10.0/
│   │   └── installation/
│   └── v18.19.0/
│       └── installation/
└── aliases/            # 별칭 구성

사용자 정의 디렉토리

FNM_DIR 환경 변수를 통해 사용자 정의:

bash

export FNM_DIR=/custom/path/.fnm

오프라인 설치

버전 미리 다운로드

네트워크가 있는 환경에서 미리 다운로드:

bash

fnm install 20
fnm install 18
fnm install 16

오프라인 환경으로 복사

~/.fnm 디렉토리를 오프라인 환경으로 복사:

bash

# 패키징
tar -czvf fnm-backup.tar.gz ~/.fnm

# 오프라인 환경에서 압축 해제
tar -xzvf fnm-backup.tar.gz -C ~/

수동 설치

미러에서 Node.js 아카이브 다운로드
fnm 디렉토리에 압축 해제:

bash

# 다운로드
wget https://npmmirror.com/mirrors/node/v20.10.0/node-v20.10.0-linux-x64.tar.gz

# fnm 디렉토리에 압축 해제
mkdir -p ~/.fnm/node-versions/v20.10.0/installation
tar -xzf node-v20.10.0-linux-x64.tar.gz -C ~/.fnm/node-versions/v20.10.0/installation --strip-components=1

아키텍처 선택

현재 아키텍처 보기

bash

fnm current
# 출력에 아키텍처 정보 포함

다른 아키텍처 설치

bash

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

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

환경 변수 설정

bash

export FNM_ARCH=x64
fnm install 20

다운로드 문제 해결

다운로드 실패

bash

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

# 네트워크 연결 확인
curl -I https://nodejs.org/dist/

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

느린 다운로드

국내 미러 구성
네트워크 프록시 설정 확인
오프라인 설치 방법 사용

Checksum 실패

bash

# 캐시 삭제 후 다시 다운로드
rm -rf ~/.fnm/node-versions/v20.10.0
fnm install 20

fnm 다운로드 관리 ​

기본 다운로드 ​

설치 명령어 ​

다운로드 진행률 ​

미러 구성 ​

미러가 필요한 이유 ​

구성 방법 ​

방법 1: 환경 변수 ​

방법 2: 명령줄 매개변수 ​

방법 3: Shell 구성 ​

일반적인 미러 소스 ​

플랫폼별 구성 ​

Linux / macOS ​

Windows PowerShell ​

Windows CMD ​

다운로드 디렉토리 ​

기본 디렉토리 ​

사용자 정의 디렉토리 ​

오프라인 설치 ​

버전 미리 다운로드 ​

오프라인 환경으로 복사 ​

수동 설치 ​

아키텍처 선택 ​

현재 아키텍처 보기 ​

다른 아키텍처 설치 ​

환경 변수 설정 ​

다운로드 문제 해결 ​

다운로드 실패 ​

느린 다운로드 ​

Checksum 실패 ​

관련 링크 ​

fnm 다운로드 관리

기본 다운로드

설치 명령어

다운로드 진행률

미러 구성

미러가 필요한 이유

구성 방법

방법 1: 환경 변수

방법 2: 명령줄 매개변수

방법 3: Shell 구성

일반적인 미러 소스

플랫폼별 구성

Linux / macOS

Windows PowerShell

Windows CMD

다운로드 디렉토리

기본 디렉토리

사용자 정의 디렉토리

오프라인 설치

버전 미리 다운로드

오프라인 환경으로 복사

수동 설치

아키텍처 선택

현재 아키텍처 보기

다른 아키텍처 설치

환경 변수 설정

다운로드 문제 해결

다운로드 실패

느린 다운로드

Checksum 실패

관련 링크