Skip to content

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デフォルトソース
npmmirrorhttps://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 ~/

手動インストール

  1. ミラーから Node.js アーカイブをダウンロード
  2. 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

ダウンロードが遅い

  1. 国内ミラーを設定
  2. ネットワークプロキシ設定を確認
  3. オフラインインストール方式を使用

チェックサムに失敗

bash
# キャッシュをクリアして再ダウンロード
rm -rf ~/.fnm/node-versions/v20.10.0
fnm install 20

関連リンク