Переменные окружения

Volta следует нескольким переменным окружения, которые контролируют её поведение. Эта страница служит справочником по всем доступным переменным окружения и их эффектам.

Основные переменные окружения

VOLTA_HOME

Устанавливает директорию, где Volta хранит свои данные, включая загруженные инструменты и конфигурацию.

• Значение по умолчанию:
  • Unix: $HOME/.volta
  • Windows: %LOCALAPPDATA%\Volta
• Пример: VOLTA_HOME=/opt/volta

VOLTA_LOGLEVEL

Контролирует уровень детализации вывода журнала Volta.

• Допустимые значения: error, warn, info, verbose, debug
• Значение по умолчанию: info
• Пример: VOLTA_LOGLEVEL=debug volta install node

VOLTA_SKIP_SETUP

Когда установлена в 1, предотвращает изменение Volta файлов конфигурации shell во время установки.

• Допустимые значения: 0, 1
• Значение по умолчанию: 0
• Пример: VOLTA_SKIP_SETUP=1 bash -c "$(curl https://get.volta.sh)"

Флаги функций

VOLTA_FEATURE_PNPM

Включает поддержку pnpm в Volta.

• Допустимые значения: 0, 1
• Значение по умолчанию: 0
• Пример: VOLTA_FEATURE_PNPM=1 volta install pnpm

Конфигурация сети

VOLTA_NETWORK_TIMEOUT_SECS

Устанавливает таймаут для сетевых операций в секундах.

• Значение по умолчанию: 60
• Пример: VOLTA_NETWORK_TIMEOUT_SECS=120 volta install node

HTTP_PROXY / HTTPS_PROXY

Стандартные переменные окружения для прокси, используемые Volta для сетевых запросов.

• Пример:
  • HTTP_PROXY=http://proxy.example.com:8080
  • HTTPS_PROXY=http://proxy.example.com:8080

NO_PROXY

Список хостов через запятую, которые должны обходить прокси.

• Пример: NO_PROXY=localhost,127.0.0.1,.example.com

Переменные установки

VOLTA_LATEST_VERSION

Принуждает установщик Volta использовать конкретную версию вместо последней.

• Пример: VOLTA_LATEST_VERSION=1.0.5 bash -c "$(curl https://get.volta.sh)"

VOLTA_TARGET_PROFILE

Указывает, какой файл конфигурации shell должен изменить установщик.

• Значение по умолчанию: Автоматическое обнаружение на основе текущего shell
• Пример: VOLTA_TARGET_PROFILE=$HOME/.bashrc

Платформо-специфичные переменные

VOLTA_MIN_COMPATIBLE_VERSION_UPDATE_CHECK

Минимальная версия Volta для проверки совместимости в уведомлениях об обновлениях.

• Пример: VOLTA_MIN_COMPATIBLE_VERSION_UPDATE_CHECK=1.0.5

Windows-специфичные переменные

Эти переменные используются только в Windows системах:

VOLTA_REDIRECT_STDERR

Когда установлена в 1, перенаправляет вывод stderr в stdout в Windows.

• Допустимые значения: 0, 1
• Значение по умолчанию: 0

Продвинутое использование

VOLTA_UNSAFE_DIAGNOSTIC

Используется для отладки; включает продвинутую диагностику, которая может быть нестабильной.

• Допустимые значения: Любая строка
• Пример: VOLTA_UNSAFE_DIAGNOSTIC=timing volta install node

VOLTA_STDIN_FILE_PASSTHROUGH

Когда установлена, Volta будет использовать этот путь к файлу вместо stdin для выполнения скриптов.

• Пример: VOLTA_STDIN_FILE_PASSTHROUGH=/tmp/script.js volta run node

Примеры конфигурации

Среда разработки

Для настройки разработки с подробным журналированием:

export VOLTA_HOME=$HOME/.volta
export VOLTA_LOGLEVEL=verbose
export PATH=$VOLTA_HOME/bin:$PATH

CI/CD пайплайн

Для среды непрерывной интеграции:

export VOLTA_HOME=$HOME/.volta
export VOLTA_LOGLEVEL=error
export VOLTA_NETWORK_TIMEOUT_SECS=300
export PATH=$VOLTA_HOME/bin:$PATH

Корпоративная сеть

Для среды с прокси-сервером:

export VOLTA_HOME=$HOME/.volta
export HTTP_PROXY=http://proxy.example.com:8080
export HTTPS_PROXY=http://proxy.example.com:8080
export NO_PROXY=localhost,127.0.0.1,.internal.example.com
export PATH=$VOLTA_HOME/bin:$PATH