Управление загрузкой fnm

fnm предоставляет гибкие опции конфигурации загрузки, чтобы помочь вам быстро получить версии Node.js.

Базовая загрузка

Команда install

# Установить последнюю LTS
fnm install --lts

# Установить конкретную версию
fnm install 20

# Установить последнюю версию
fnm install --latest

Прогресс загрузки

fnm отображает прогресс-бар загрузки по умолчанию:

# Автоматическое отображение (по умолчанию)
fnm install 20 --progress=auto

# Всегда отображать
fnm install 20 --progress=always

# Никогда не отображать
fnm install 20 --progress=never

Конфигурация зеркала

Зачем нужно зеркало

Официальный источник загрузки Node.js расположен за рубежом, и загрузка может быть медленной в некоторых регионах. Настройка зеркала может значительно увеличить скорость загрузки.

Способы конфигурации

Способ 1: Переменная окружения

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

Способ 2: Параметр командной строки

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

Способ 3: Конфигурация Shell

# Добавить в файл конфигурации Shell
eval "$(fnm env --use-on-cd --node-dist-mirror=https://npmmirror.com/mirrors/node)"

Общие источники зеркал

Зеркало	URL	Описание
Node.js Official	https://nodejs.org/dist	По умолчанию
npmmirror	https://npmmirror.com/mirrors/node	Рекомендуется
Tsinghua University	https://mirrors.tuna.tsinghua.edu.cn/nodejs-release	Оптимизировано для образовательной сети
Huawei Cloud	https://mirrors.huaweicloud.com/nodejs	Корпоративный уровень

Конфигурация для платформы

Linux / macOS

# Добавить в ~/.bashrc или ~/.zshrc
export FNM_NODE_DIST_MIRROR=https://npmmirror.com/mirrors/node

Windows PowerShell

# Установить переменную окружения пользователя
[Environment]::SetEnvironmentVariable("FNM_NODE_DIST_MIRROR", "https://npmmirror.com/mirrors/node", "User")

Windows 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:

export FNM_DIR=/custom/path/.fnm

Автономная установка

Предварительная загрузка версий

Предварительная загрузка в сетевой среде:

fnm install 20
fnm install 18
fnm install 16

Копирование в автономную среду

Копирование директории ~/.fnm в автономную среду:

# Упаковать
tar -czvf fnm-backup.tar.gz ~/.fnm

# Распаковать в автономной среде
tar -xzvf fnm-backup.tar.gz -C ~/

Ручная установка

1. Загрузить архив Node.js из зеркала
2. Распаковать в директорию fnm:

# Загрузить
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

Выбор архитектуры

Просмотр текущей архитектуры

fnm current
# Вывод включает информацию об архитектуре

Установка другой архитектуры

# Установить x64 версию
fnm install 20 --arch=x64

# Установить ARM64 версию
fnm install 20 --arch=arm64

Настройка переменной окружения

export FNM_ARCH=x64
fnm install 20

Устранение проблем с загрузкой

Загрузка не удалась

# Попробовать использовать зеркало
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. Использовать метод автономной установки

Checksum Failed

# Очистить кэш и загрузить повторно
rm -rf ~/.fnm/node-versions/v20.10.0
fnm install 20

Связанные ссылки

• Установка Node.js - Руководство по установке
• Управление версиями - Управление версиями
• Справочник команд - Все подробности о командах