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/nodeWindows 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ダウンロードが遅い
- 国内ミラーを設定
- ネットワークプロキシ設定を確認
- オフラインインストール方式を使用
チェックサムに失敗
bash
# キャッシュをクリアして再ダウンロード
rm -rf ~/.fnm/node-versions/v20.10.0
fnm install 20関連リンク
- Node.js をインストール - インストールガイド
- バージョン管理 - バージョン管理
- コマンドリファレンス - すべてのコマンドの詳細