Skip to content

Biến Môi trường

Volta tôn trọng một số biến môi trường kiểm soát hành vi của nó. Trang này đóng vai trò là tham chiếu cho tất cả các biến môi trường khả dĩ và ảnh hưởng của chúng.

Biến Môi trường Cốt lõi

VOLTA_HOME

Đặt thư mục nơi Volta lưu trữ dữ liệu của nó, bao gồm các công cụ đã tải và cấu hình.

  • Mặc định:
    • Unix: $HOME/.volta
    • Windows: %LOCALAPPDATA%\Volta
  • Ví dụ: VOLTA_HOME=/opt/volta

VOLTA_LOGLEVEL

Kiểm soát mức độ chi tiết của đầu ra nhật ký Volta.

  • Giá trị hợp lệ: error, warn, info, verbose, debug
  • Mặc định: info
  • Ví dụ: VOLTA_LOGLEVEL=debug volta install node

VOLTA_SKIP_SETUP

Khi được đặt thành 1, ngăn Volta sửa đổi hồ sơ shell trong khi cài đặt.

  • Giá trị hợp lệ: 0, 1
  • Mặc định: 0
  • Ví dụ: VOLTA_SKIP_SETUP=1 bash -c "$(curl https://get.volta.sh)"

Cờ Tính năng

VOLTA_FEATURE_PNPM

Bật hỗ trợ pnpm trong Volta.

  • Giá trị hợp lệ: 0, 1
  • Mặc định: 0
  • Ví dụ: VOLTA_FEATURE_PNPM=1 volta install pnpm

Cấu hình Mạng

VOLTA_NETWORK_TIMEOUT_SECS

Đặt thời gian chờ tính bằng giây cho các hoạt động mạng.

  • Mặc định: 60
  • Ví dụ: VOLTA_NETWORK_TIMEOUT_SECS=120 volta install node

HTTP_PROXY / HTTPS_PROXY

Các biến môi trường proxy tiêu chuẩn được Volta sử dụng cho các yêu cầu mạng.

  • Ví dụ:
    • HTTP_PROXY=http://proxy.example.com:8080
    • HTTPS_PROXY=http://proxy.example.com:8080

NO_PROXY

Danh sách các host được phân tách bằng dấu phẩy sẽ bỏ qua proxy.

  • Ví dụ: NO_PROXY=localhost,127.0.0.1,.example.com

Biến Cài đặt

VOLTA_LATEST_VERSION

Buộc trình cài đặt Volta sử dụng một phiên bản cụ thể thay vì phiên bản mới nhất.

  • Ví dụ: VOLTA_LATEST_VERSION=1.0.5 bash -c "$(curl https://get.volta.sh)"

VOLTA_TARGET_PROFILE

Chỉ định file hồ sơ shell nào mà trình cài đặt nên sửa đổi.

  • Mặc định: Được phát hiện dựa trên shell hiện tại
  • Ví dụ: VOLTA_TARGET_PROFILE=$HOME/.bashrc

Biến Cụ thể Nền tảng

VOLTA_MIN_COMPATIBLE_VERSION_UPDATE_CHECK

Phiên bản Volta tối thiểu để kiểm tra tương thích trong thông báo cập nhật.

  • Ví dụ: VOLTA_MIN_COMPATIBLE_VERSION_UPDATE_CHECK=1.0.5

Biến Cụ thể Windows

Các biến này chỉ được sử dụng trên hệ thống Windows:

VOLTA_REDIRECT_STDERR

Khi được đặt thành 1, chuyển hướng đầu ra stderr sang stdout trên Windows.

  • Giá trị hợp lệ: 0, 1
  • Mặc định: 0

Sử dụng Nâng cao

VOLTA_UNSAFE_DIAGNOSTIC

Được sử dụng để gỡ lỗi; bật chẩn đoán nâng cao có thể không ổn định.

  • Giá trị hợp lệ: Bất kỳ chuỗi nào
  • Ví dụ: VOLTA_UNSAFE_DIAGNOSTIC=timing volta install node

VOLTA_STDIN_FILE_PASSTHROUGH

Khi được đặt, Volta sẽ sử dụng đường dẫn file này thay vì stdin để thực thi script.

  • Ví dụ: VOLTA_STDIN_FILE_PASSTHROUGH=/tmp/script.js volta run node

Ví dụ Cấu hình

Môi trường Phát triển

Cho thiết lập phát triển với nhật ký chi tiết:

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

Pipeline CI/CD

Cho môi trường tích hợp liên tục:

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

Mạng Doanh nghiệp

Cho môi trường có máy chủ proxy:

bash
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

Released under the BSD 2-Clause License.