fnm 下載管理
fnm 提供了靈活的下載配置選項，幫助你快速獲取 Node.js 版本。
基本下載
| 名稱 | 說明 | 版本 | 下載鏈接 |
|---|---|---|---|
| fnm-windows.zip | windows | 1.38.1 | https://github.com/Schniz/fnm/releases/download/v1.38.1/fnm-windows.zip |
| fnm-linux.zip | linux | 1.38.1 | https://github.com/Schniz/fnm/releases/download/v1.38.1/fnm-linux.zip |
| fnm-macos.zip | macos | 1.38.1 | https://github.com/Schniz/fnm/releases/download/v1.38.1/fnm-macos.zip |
| fnm-macos-arm64.zip | macos arm64 | 1.38.1 | https://github.com/Schniz/fnm/releases/download/v1.38.1/fnm-arm64.zip |
| fnm-macos-arm23.zip | macos arm23 | 1.38.1 | https://github.com/Schniz/fnm/releases/download/v1.38.1/fnm-arm32.zip |
安裝命令
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)"常用鏡像源
| 鏡像源 | 地址 | 說明 |
|---|---|---|
| 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 - 安裝指南
- 版本管理 - 版本管理
- 命令參考 - 所有命令詳解