Перейти к основному содержимому

Кэш загрузок

NVM for Windows может хранить скачанные архивы Node.js на диске, чтобы последующие установки не обращались к сети, если подходящий архив уже есть. Управляйте хранилищем через nvm cache или включите автосохранение через cache_downloads.

Кэш полезен, когда:

  • Частые переустановки: удаляете и снова ставите ту же версию Node без повторной загрузки.
  • Нестабильная или лимитированная сеть: локальная копия позволяет установить Node при сбое зеркала или офлайне
  • Подготовка парка/лаборатории: один раз nvm cache add, затем копируете архивы (или общий local_dir) на другие машины
  • Изолированные установки: предзагрузка на подключённом хосте, затем установка офлайн (Изолированные установки)
Локальные установки

Кэш покрывает простой офлайн-ноутбук. Для команд и общих архивов лучше Локальные установки и руководство Изолированные установки.

По умолчанию cache_downloads = false: обычный nvm install переиспользует кэшированный архив, если он есть, но не записывает новый, пока не передан --cache или не включена настройка.

nvm install 24 --cache
nvm install 24.11.0   # переиспользует кэшированный архив, если он есть

Где лежат файлы​

Под корнем данных NVM (родитель каталога установки; по умолчанию %LOCALAPPDATA%\Author Software\nvm):

ХранилищеПутьСодержимое
Версии.cache/versionsАрхивы Node.js .7z (node-v{version}-win-{x64|arm64}.7z)
Метаданные.cache/metadataМетаданные индекса sync/release (не архивы установки)
HTTP.cache/httpКратковременные HTTP-тела (например, загрузки SHASUM)

Если задан local_dir (см. политику реестра), этот каталог заменяет .cache/versions как источник архивов для установки.

Поведение при установке​

Флаг/настройкаЭффект
nvm install --cacheСкачать (при необходимости) и сохранить архив
nvm install --no-cacheНе использовать и не писать кэш версий по умолчанию
cache_downloads=trueВсегда сохранять успешные загрузки (если нет --no-cache)
nvm cache addСкачать и закэшировать без установки
local_install_onlyБез сети: установка только из local_dir/попадания в кэш

При попадании в кэш целостность проверяется до переиспользования (локальный SHASUM рядом с архивом, verify-cache при загрузке или живой SHASUM зеркала онлайн). Плохой архив удаляется, установка продолжается как промах, если сеть разрешена.

Управление кэшем​

nvm cache                  # список (алиас: nvm cache list/ls)
nvm cache add 24 lts       # предзагрузка архивов
nvm cache remove version 24.1.0
nvm cache remove metadata
nvm cache remove all
nvm list cached            # список версий из кэшированных архивов

allow_download_cache_removal (по умолчанию true) разрешает удаление из кэша. Политика может установить false; тогда удаление сообщает, что заблокировано.

При удалении с --purge может также удаляться соответствующий кэшированный архив этой версии.

См. также​