Gestione Download fnm

fnm fornisce opzioni di configurazione download flessibili per aiutarti a ottenere rapidamente le versioni di Node.js.

Download Base

Comando Install

# Installa ultima LTS
fnm install --lts

# Installa versione specifica
fnm install 20

# Installa ultima versione
fnm install --latest

Progresso Download

fnm mostra barra avanzamento download per impostazione predefinita:

# Visualizzazione automatica (predefinito)
fnm install 20 --progress=auto

# Mostra sempre
fnm install 20 --progress=always

# Non mostrare mai
fnm install 20 --progress=never

Configurazione Mirror

Perché Hai Bisogno di un Mirror

La sorgente download ufficiale di Node.js si trova all'estero e i download potrebbero essere lenti nella Cina continentale. Configurare un mirror può migliorare significativamente la velocità di download.

Metodi Configurazione

Metodo 1: Variabile Ambiente

export FNM_NODE_DIST_MIRROR=https://npmmirror.com/mirrors/node

Metodo 2: Parametro Riga di Comando

fnm install 20 --node-dist-mirror=https://npmmirror.com/mirrors/node

Metodo 3: Configurazione Shell

# Aggiungi al file configurazione Shell
eval "$(fnm env --use-on-cd --node-dist-mirror=https://npmmirror.com/mirrors/node)"

Sorgenti Mirror Comuni

Sorgente Mirror	URL	Descrizione
Node.js Ufficiale	https://nodejs.org/dist	Predefinito
npmmirror	https://npmmirror.com/mirrors/node	Consigliato
Tsinghua University	https://mirrors.tuna.tsinghua.edu.cn/nodejs-release	Ottimizzato per rete educativa
Huawei Cloud	https://mirrors.huaweicloud.com/nodejs	Livello enterprise

Configurazione per Piattaforma

Linux / macOS

# Aggiungi a ~/.bashrc o ~/.zshrc
export FNM_NODE_DIST_MIRROR=https://npmmirror.com/mirrors/node

Windows PowerShell

# Imposta variabile ambiente utente
[Environment]::SetEnvironmentVariable("FNM_NODE_DIST_MIRROR", "https://npmmirror.com/mirrors/node", "User")

Windows CMD

setx FNM_NODE_DIST_MIRROR "https://npmmirror.com/mirrors/node"

Directory Download

Directory Predefinita

fnm scarica e installa Node.js in:

~/.fnm/
├── fnm                 # Binario fnm
├── node-versions/      # Directory versioni Node.js
│   ├── v20.10.0/
│   │   └── installation/
│   └── v18.19.0/
│       └── installation/
└── aliases/            # Configurazione alias

Directory Personalizzata

Personalizza tramite variabile ambiente FNM_DIR:

export FNM_DIR=/custom/path/.fnm

Installazione Offline

Pre-scarica Versioni

Pre-scarica in ambiente con rete:

fnm install 20
fnm install 18
fnm install 16

Copia in Ambiente Offline

Copia directory ~/.fnm in ambiente offline:

# Pacchetto
tar -czvf fnm-backup.tar.gz ~/.fnm

# Estrai in ambiente offline
tar -xzvf fnm-backup.tar.gz -C ~/

Installazione Manuale

1. Scarica archivio Node.js da mirror
2. Estrai in directory fnm:

# Scarica
wget https://npmmirror.com/mirrors/node/v20.10.0/node-v20.10.0-linux-x64.tar.gz

# Estrai in directory fnm
mkdir -p ~/.fnm/node-versions/v20.10.0/installation
tar -xzf node-v20.10.0-linux-x64.tar.gz -C ~/.fnm/node-versions/v20.10.0/installation --strip-components=1

Selezione Architettura

Visualizza Architettura Corrente

fnm current
# Output include informazioni architettura

Installa Architettura Diversa

# Installa versione x64
fnm install 20 --arch=x64

# Installa versione ARM64
fnm install 20 --arch=arm64

Impostazione Variabile Ambiente

export FNM_ARCH=x64
fnm install 20

Risoluzione Problemi Download

Download Fallito

# Prova usando mirror
fnm install 20 --node-dist-mirror=https://npmmirror.com/mirrors/node

# Controlla connessione di rete
curl -I https://nodejs.org/dist/

# Visualizza log dettagliati
fnm install 20 --log-level=info

Download Lento

1. Configura mirror nazionale
2. Controlla impostazioni proxy di rete
3. Usa metodo installazione offline

Checksum Fallito

# Pulisci cache e scarica di nuovo
rm -rf ~/.fnm/node-versions/v20.10.0
fnm install 20

Link Correlati

• Installa Node.js - Guida installazione
• Gestione Versioni - Gestione versioni
• Riferimento Comandi - Tutti dettagli comandi