Установщики

NVM for Windows доступен в community- и certified-сборках для устройств amd64 (x64) и arm64. См. Выбор сборки, чтобы понять, какая подходит вам.

Community Build

Установщик

Скачайте и запустите установщик setup.exe (лицензия MIT).

Рекомендуемый способ

Этот способ установки открывает нативный мастер с GUI для настройки сценариев работы с Node.js.

Winget

  winget install nvm-windows # MIT License

Проверка версий.

Запускается с /VERYSILENT /SUPPRESSMSGBOXES /NORESTART.

Дополнительные параметры установщика передавайте через --custom. См. Тихая установка.

Обновление с v1

Если v1 ставили через winget, один раз выполните winget install nvm-windows при первом обновлении. Эта команда сбрасывает ID пакета winget с CoreyButler.NVMforWindows на AuthorSoftware.NVMWindows. Дальнейшие обновления: winget upgrade nvm-windows. Подробности: Обновление с v1.

Обновление с v1

См. Обновление с v1.

Для одного компьютера:

1. Скачайте установщик setup.exe (лицензия MIT).
2. Запустите его от имени обычного пользователя.

Установщик переносит поддерживаемые установки v1 (v1.1.7 и новее) и объединяет версии Node.js в v2.

Устаревший updater

Updater v1 рассчитан на минорные и patch-обновления в линейке v1.x.x. С v2 он не работает.

Тихая установка

Community-установщик — Inno Setup. Эти ключи работают для nvm-<version>-x64-setup.exe и nvm-<version>-arm64-setup.exe:

Ключ	Что делает
/VERYSILENT	Без мастера и без окна прогресса.
/SILENT	Только окно прогресса. Без страниц мастера.
/SUPPRESSMSGBOXES	Пропускает окна сообщений. Используйте с /SILENT или /VERYSILENT.
/NORESTART	Не перезагружает компьютер после установки.

.\nvm-<version>-x64-setup.exe /VERYSILENT /SUPPRESSMSGBOXES /NORESTART
.\nvm-<version>-x64-setup.exe /SILENT /SUPPRESSMSGBOXES /NORESTART

Корень программы остаётся %LOCALAPPDATA%\Author Software\nvm. Тихий /DIR в другое место останавливает установку с NVM4100. Хранилище версий Node — InstallRoot (мастер или nvm config после установки), не /DIR.

Каталоги runtime (.shim, .nodejs, .sync, .cache, .verify, proxy.exe) всегда живут в корне программы. Пользовательский InstallRoot хранит только деревья версий — NVM никогда не создаёт эти runtime-каталоги рядом с пользовательским хранилищем (например, выбор D:\nvm не должен создавать D:\.shim).

Тихая установка пропускает страницу прав хранилища. Если текущий InstallRoot небезопасен и проверка ACL не проходит, установщик переносит хранилище в AppData. Если ремонт ACL всё равно не проходит, тихая установка останавливается, пока не передадите /ALLOWDEGRADEDACLS.

Параметр	Допустимые значения	Что делает
/ALLOWDEGRADEDACLS	1, true, yes	Завершает тихую установку, когда ACL хранилища Node нельзя усилить. Ставит RuntimeACLDegraded. Позже восстановите через nvm doctor --autofix.
/OFFICIALNODE	adopt (по умолчанию), drop	Что делать с официальной установкой Node.js (не NVM). adopt копирует эту версию и глобальные модули %APPDATA%\npm в хранилище NVM, затем удаляет официальную Node.js. drop удаляет официальную Node.js. Не копирует эту установку.

Если официальная Node.js есть, мастер показывает строку вроде Node.js 22.20.0 detected with 14 global modules (128 MB). Дальше только Adopt и Drop. Тихая установка и winget пропускают эту страницу. Они используют /OFFICIALNODE. Для community значение по умолчанию — adopt. Любое другое значение, включая copy, keep и ignore, обрабатывается как adopt.

Community-установщик не может оставить официальную Node.js. Каталог Node.js в system PATH перекрывает user PATH NVM. copy и keep есть только у certified MSI.

Если установщик не может удалить официальную Node.js, тихая установка останавливается. Код выхода не 0. Удалите эту установку Node.js и запустите установщик снова.

.\nvm-<version>-x64-setup.exe /VERYSILENT /SUPPRESSMSGBOXES /NORESTART /ALLOWDEGRADEDACLS=1
.\nvm-<version>-x64-setup.exe /VERYSILENT /SUPPRESSMSGBOXES /NORESTART /OFFICIALNODE=adopt
.\nvm-<version>-x64-setup.exe /VERYSILENT /SUPPRESSMSGBOXES /NORESTART /OFFICIALNODE=drop

Списка задач нет. /TASKS не влияет на поведение.

Winget

Когда пакет опубликован, winget install nvm использует ключи very-silent выше. Пользовательский параметр передайте через --custom (добавляется к этим ключам):

winget install nvm --custom "/ALLOWDEGRADEDACLS=1"
winget install nvm --custom "/OFFICIALNODE=adopt"

--override заменяет стандартные ключи. Если используете его, добавьте /VERYSILENT /SUPPRESSMSGBOXES /NORESTART вручную.

Certified Build

Community-установщик использует Inno Setup. Эти ключи работают для nvm-<version>-x64-setup.exe и nvm-<version>-arm64-setup.exe.

Ключ	Что делает
/VERYSILENT	Без мастера и без окна прогресса.
/SILENT	Только окно прогресса. Без страниц мастера.
/SUPPRESSMSGBOXES	Пропускает диалоговые окна. Используйте вместе с /SILENT или /VERYSILENT.
/NORESTART	Не перезагружать компьютер после завершения установки.
/DIR	⚠️ Игнорируется. Путь, отличный от корня программы по умолчанию, останавливает тихую установку с NVM4100.

/DIR игнорируется

Не передавайте /DIR, чтобы выбрать каталог установки. Корень community-программы остаётся %LOCALAPPDATA%\Author Software\nvm. Другое значение /DIR игнорируется, и тихая установка останавливается с ошибкой NVM4100. Хранилище Node.js задаётся через InstallRoot в мастере или через nvm config после установки.

.\nvm-<version>-x64-setup.exe /VERYSILENT /SUPPRESSMSGBOXES /NORESTART
.\nvm-<version>-x64-setup.exe /SILENT /SUPPRESSMSGBOXES /NORESTART

Тихая установка пропускает страницу разрешений для хранилища. Если InstallRoot не относится к безопасным управляемым путям и проверка ACL завершается ошибкой, установщик переносит хранилище в AppData. Если восстановить ACL всё равно не удаётся, тихая установка останавливается. Передайте /ALLOWDEGRADEDACLS, чтобы продолжить.

Параметр	Допустимые значения	Что делает
/ALLOWDEGRADEDACLS	1 true yes	Завершает тихую установку, когда ACL хранилища Node нельзя усилить. Устанавливает RuntimeACLDegraded. Позже восстановите через nvm doctor --autofix.
/OFFICIALNODE	adopt (по умолчанию) drop	Что делать с официальной установкой Node.js (не NVM). adopt копирует эту версию и глобальные модули %APPDATA%\npm в хранилище NVM. Затем удаляет официальную Node.js. drop удаляет официальную Node.js. Не копирует эту установку. Любое другое значение, включая ignore, обрабатывается как adopt.

ignore только в Certified Builds

Community-установщик не принимает /OFFICIALNODE=ignore. Если передать, это adopt. ignore-keep и ignore-drop есть только у certified MSI.

Если обнаружена официальная Node.js, мастер показывает строку вроде Node.js 22.20.0 detected with 14 global modules (128 MB). Дальше только Adopt и Drop. Тихая установка и winget пропускают эту страницу. Они используют /OFFICIALNODE. Для community значение по умолчанию — adopt. Если установщик не может удалить официальную Node.js, тихая установка останавливается. Код выхода не 0. Удалите эту установку Node.js и запустите установщик снова.

.\nvm-<version>-x64-setup.exe /VERYSILENT /SUPPRESSMSGBOXES /NORESTART /ALLOWDEGRADEDACLS=1
.\nvm-<version>-x64-setup.exe /VERYSILENT /SUPPRESSMSGBOXES /NORESTART /OFFICIALNODE=adopt
.\nvm-<version>-x64-setup.exe /VERYSILENT /SUPPRESSMSGBOXES /NORESTART /OFFICIALNODE=drop

Списка задач нет. /TASKS не влияет на поведение.

Winget

winget install nvm-windows использует перечисленные выше ключи very-silent. Передайте пользовательский параметр через --custom. Winget добавляет --custom к этим ключам.

winget install nvm-windows --custom "/ALLOWDEGRADEDACLS=1"
winget install nvm-windows --custom "/OFFICIALNODE=adopt"

--override заменяет стандартные ключи. Если используете его, добавьте /VERYSILENT /SUPPRESSMSGBOXES /NORESTART вручную.

Certified Build

Доступно сейчас

Подписанные certified-сборки доступны в клиентском портале.

Используйте Certified Build для установки MSI на компьютер в %ProgramFiles%\Author Software\nvm. Установщик подписан кодом Author Software Inc.

Certified Build поддерживает удалённую установку через Active Directory и Microsoft Entra / Intune. MSI также можно установить на один компьютер. См. корпоративное развёртывание, чтобы установить NVM for Windows на многих компьютерах.

Тихая установка требует повышения прав. Свойства MSI передавайте после пути к пакету.

Свойство	Допустимые значения	Что делает
ACCEPT_EULA	1	Принять EULA без мастера. Нужно для /qn и /qb.
OFFICIALNODE	copy (по умолчанию), adopt, keep, drop	Что делать с официальной установкой Node.js (не NVM). copy копирует эту версию и глобальные модули %APPDATA%\npm в NVM. Оставляет официальную установку на диске. Ставит NVM первым в system PATH. adopt копирует те же файлы, затем удаляет официальную Node.js. keep не копирует официальную Node.js. Оставляет её на диске. Ставит NVM первым в system PATH. drop удаляет официальную Node.js. Не копирует эту установку.

adopt-keep значит copy. adopt-drop значит adopt. ignore-keep и ignore значат keep. ignore-drop значит drop. Любое другое значение становится copy. Голый adopt удаляет официальную Node.js после копирования. Это не синоним copy.

msiexec /i "C:\path\to\nvm-windows-<version>-certified-x64.msi" ACCEPT_EULA=1 /qn /norestart
msiexec /i "C:\path\to\nvm-windows-<version>-certified-x64.msi" ACCEPT_EULA=1 OFFICIALNODE=copy /qn /norestart
msiexec /i "C:\path\to\nvm-windows-<version>-certified-x64.msi" ACCEPT_EULA=1 OFFICIALNODE=adopt /qn /norestart
msiexec /i "C:\path\to\nvm-windows-<version>-certified-x64.msi" ACCEPT_EULA=1 OFFICIALNODE=keep /qn /norestart
msiexec /i "C:\path\to\nvm-windows-<version>-certified-x64.msi" ACCEPT_EULA=1 OFFICIALNODE=drop /qn /norestart

NVM первым значит %LOCALAPPDATA%\Author Software\nvm\.nodejs, затем C:\Program Files\Author Software\nvm, затем официальная Node.js. Если копирование или удаление не удалось, установка останавливается. Удалите существующую установку Node.js и запустите установщик снова.

Мастер показывает Copy, Adopt, Keep и Drop. По умолчанию Copy.

Файл	Сценарий
Ручное развёртывание	Установка MSI (или скриптом) на один компьютер.
Intune	Развёртывание в организации Microsoft Entra.
Active Directory	Развёртывание на сайте через GPO Software Installation.

Установка Node.js

После установки NVM for Windows используйте его, чтобы установить одну или несколько версий Node.js.

Пример: установка последней поддерживаемой версии Node.js

nvm install lts

Предупреждения

Не устанавливайте Community Build от имени администратора!

Не устанавливайте Community Build от имени администратора. В этом случае NVM for Windows настроится для учётной записи администратора. Она не настроится для пользователя, который будет запускать Node.js. См. регистрацию источника событий.

UAC для журналирования

Community-установщик пытается зарегистрировать NVM for Windows как системный источник событий, из‑за чего появляется запрос UAC. Если у учётной записи нет прав на это, в Windows Event Viewer в качестве источника события будет «Unknown», а не «NVM for Windows», но нативное журналирование продолжит работать.