Gerenciamento de Download fnm

fnm fornece opções de configuração de download flexíveis para ajudá-lo a obter versões do Node.js rapidamente.

Download Básico

Comando Install

# Instalar último LTS
fnm install --lts

# Instalar versão específica
fnm install 20

# Instalar versão mais recente
fnm install --latest

Progresso do Download

fnm exibe barra de progresso do download por padrão:

# Exibição automática (padrão)
fnm install 20 --progress=auto

# Sempre exibir
fnm install 20 --progress=always

# Nunca exibir
fnm install 20 --progress=never

Configuração de Mirror

Por Que Você Precisa de um Mirror

A fonte oficial de download do Node.js está localizada no exterior e os downloads podem ser lentos. Configurar um mirror pode melhorar significativamente a velocidade de download.

Métodos de Configuração

Método 1: Variável de Ambiente

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

Método 2: Parâmetro de Linha de Comando

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

Método 3: Configuração do Shell

# Adicionar ao arquivo de configuração do Shell
eval "$(fnm env --use-on-cd --node-dist-mirror=https://npmmirror.com/mirrors/node)"

Fontes de Mirror Comuns

Fonte do Mirror	URL	Descrição
Node.js Oficial	https://nodejs.org/dist	Padrão
npmmirror	https://npmmirror.com/mirrors/node	Recomendado
Universidade de Tsinghua	https://mirrors.tuna.tsinghua.edu.cn/nodejs-release	Otimizado para rede educacional
Huawei Cloud	https://mirrors.huaweicloud.com/nodejs	Nível empresarial

Configuração Específica da Plataforma

Linux / macOS

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

Windows PowerShell

# Definir variável de ambiente do usuário
[Environment]::SetEnvironmentVariable("FNM_NODE_DIST_MIRROR", "https://npmmirror.com/mirrors/node", "User")

Windows CMD

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

Diretório de Download

Diretório Padrão

fnm baixa e instala o Node.js em:

~/.fnm/
├── fnm                 # binário fnm
├── node-versions/      # diretório de versões do Node.js
│   ├── v20.10.0/
│   │   └── installation/
│   └── v18.19.0/
│       └── installation/
└── aliases/            # configuração de alias

Diretório Personalizado

Personalize via variável de ambiente FNM_DIR:

export FNM_DIR=/custom/path/.fnm

Instalação Offline

Versões de Pré-download

Pré-baixar em ambiente com rede:

fnm install 20
fnm install 18
fnm install 16

Copiar para Ambiente Offline

Copie o diretório ~/.fnm para o ambiente offline:

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

# Extrair em ambiente offline
tar -xzvf fnm-backup.tar.gz -C ~/

Instalação Manual

1. Baixe o arquivo do Node.js do mirror
2. Extraia para o diretório fnm:

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

# Extrair para diretório 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

Seleção de Arquitetura

Visualizar Arquitetura Atual

fnm current
# A saída inclui informações de arquitetura

Instalar Arquitetura Diferente

# Instalar versão x64
fnm install 20 --arch=x64

# Instalar versão ARM64
fnm install 20 --arch=arm64

Configuração de Variável de Ambiente

export FNM_ARCH=x64
fnm install 20

Solução de Problemas de Download

Download Falhou

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

# Verificar conexão de rede
curl -I https://nodejs.org/dist/

# Ver logs detalhados
fnm install 20 --log-level=info

Download Lento

1. Configurar mirror nacional
2. Verificar configurações de proxy de rede
3. Usar método de instalação offline

Checksum Falhou

# Limpar cache e baixar novamente
rm -rf ~/.fnm/node-versions/v20.10.0
fnm install 20

Links Relacionados

• Instalar Node.js - Guia de instalação
• Gerenciamento de Versão - Gerenciamento de versão
• Referência de Comandos - Todas as informações de comandos