Базовая конфигурация
Пользовательские настройки хранятся в реестре Windows. Управляйте ими через nvm config (псевдоним: nvm cfg).
nvm config list
nvm config get mode auto_use
nvm config set auto_install=true
nvm config reset auto_install
nvm config docs
На certified-флотах политика машины может переопределять эти значения. См. Административные шаблоны и справочник политик реестра.
Структурированная документация
Используйте nvm config docs --json для машиночитаемых метаданных.
Режим и каталог установки
| Параметр | По умолчанию | Значения | Описание |
|---|---|---|---|
mode | shim | shim, link | Определяет, как управляются команды и версии Node.js: через маршрутизацию shim или прямые junction/symlink. То же, что nvm use shim/nvm use link. См. Режимы работы. |
root | %LOCALAPPDATA%\Author Software\nvm\installs | Путь к каталогу | Корневой каталог установки версий Node.js. Изменение не переносит существующие установки — перенесите файлы вручную или переустановите версии. |
Загрузки и зеркала
| Параметр | По умолчанию | Значения | Описание |
|---|---|---|---|
node_mirror | https://nodejs.org/dist | Один или несколько URL | URL зеркала(зеркал) для загрузки Node.js. В nvm config передайте список через запятую. В реестре (MirrorNode) храните как REG_MULTI_SZ (один URL на запись) — не как одну строку REG_SZ с запятыми. См. Зеркала загрузки. |
npm_mirror | https://registry.npmjs.org | Один или несколько URL | URL зеркала(зеркал) реестра npm. Те же правила: через запятую в nvm config; REG_MULTI_SZ (MirrorNpm) в реестре. См. Зеркала загрузки. |
cache_downloads | false | Boolean | Кэшировать загруженные файлы для офлайн-использования. |
allow_download_cache_removal | true | Boolean | Разрешить удаление кэшированных загрузок. |
allow_insecure_downloads | false | Boolean | Разрешить загрузки при просроченных или недействительных SSL-сертификатах. |
auto_installed_modules | (нет) | Имена npm-пакетов через запятую | Список глобальных npm-модулей для автоматической установки с каждой новой версией Node.js. (REG_MULTI_SZ как AutoInstallModuleList в политике.) |
nvm config set node_mirror=https://npmmirror.com/mirrors/node
nvm config set node_mirror=https://mirror.author.io/runtime/nodejs,https://nodejs.org/dist
nvm config set cache_downloads=true
nvm config set auto_installed_modules=typescript,prettier
Прокси
Прокси автоматически определяются и применяются из переменных окружения HTTP_PROXY, HTTPS_PROXY или NO_PROXY.
| Параметр | По умолчанию | Значения | Описание |
|---|---|---|---|
proxy | (нет) | URL | URL прокси в открытом виде. Скрыт из обычного вывода cfg docs, так как обычно определяется автоматически. |
На certified-сборках прокси обычно задаются политикой (см. справочник реестра).
Корпоративные прокси
Community-сборка поддерживает базовые прокси. IWA, WPAD и PAC-прокси поддерживаются в Certified Builds, доступных с сентября 2026.
Обнаружение проекта и автоматическое поведение
Эти параметры применяются в основном в режиме shim (и связанных сценариях nvm pin).
| Параметр | По умолчанию | Значения | Описание |
|---|---|---|---|
auto_detect | .nvmrc, .node-version, package.json | Имена файлов через запятую | Файлы проекта для определения версии (только shim). |
default_detect_file | .nvmrc | Имя файла | Файл по умолчанию при сохранении/закреплении версии в проекте. |
auto_use | true | Boolean | Автоматически переключаться на обнаруженную версию для запуска скриптов без изменения системной версии (только shim). |
auto_install | false | Boolean | Автоматически устанавливать отсутствующую обнаруженную версию (shim node + proxy: npm/npx/yarn/pnpm/globals; также nvm pin). |
auto_install_prompt | true | Boolean | Запрашивать подтверждение перед автоматической установкой отсутствующей обнаруженной версии (shim node + proxy; также nvm pin). |
nvm config set auto_install=true auto_install_prompt=false
nvm config set auto_detect=.nvmrc,.node-version
Менеджеры пакетов
| Параметр | По умолчанию | Значения | Описание |
|---|---|---|---|
pm_mismatch_action | error | ignore, warn, error | Действие при несовпадении версий npm/pnpm/yarn и Node.js во время install или use:
|
Журналирование и объявления
| Параметр | По умолчанию | Значения | Описание |
|---|---|---|---|
log_executions | false | Boolean | Журналировать каждый вызов Node.js (например, node file.js). (только shim) |
disable_announcements | false | Boolean | Отключить объявления проекта и релизов. Предупреждения об истечении лицензии всё равно показываются. |
nvm config set log_executions=true
nvm config set disable_announcements=true
Связанные настройки
(не перечислены в cfg docs)
| Тема | Где |
|---|---|
Псевдонимы версий (stable=24.x и т. д.) | Предпочтительно nvm alias; значения хранятся как aliases |
| Включение/отключение управления версиями | nvm on/nvm off (записывает enabled) |
| Активная/последняя версия | Управляется nvm use (active_version, last_version) |
| Безопасность shim / флаги V8 | Справочник реестра (EnforcePermissionModel, FreezeV8GlobalObjects, DisableEvalAndStringExecution) |
| Корпоративные блокировки (зеркала, списки разрешённых/заблокированных версий, прокси) | Административные шаблоны и политики реестра |
nvm config docs
nvm config docs --json