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 - 安装指南
- 版本管理 - 版本管理
- 命令参考 - 所有命令详解