Gestión de Descargas de fnm

fnm proporciona opciones flexibles de configuración de descargas para ayudarte a obtener rápidamente las versiones de Node.js.

Descarga Básica

Comando de Instalación

# Instalar última LTS
fnm install --lts

# Instalar versión específica
fnm install 20

# Instalar última versión
fnm install --latest

Progreso de Descarga

fnm muestra la barra de progreso de descarga por defecto:

# Mostrar automáticamente (predeterminado)
fnm install 20 --progress=auto

# Mostrar siempre
fnm install 20 --progress=always

# Nunca mostrar
fnm install 20 --progress=never

Configuración de Mirror

Por Qué Necesitas un Mirror

La fuente oficial de descargas de Node.js está ubicada en el extranjero, y las descargas pueden ser lentas en China continental. Configurar un mirror puede mejorar significativamente la velocidad de descarga.

Métodos de Configuración

Método 1: Variable de Entorno

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

Método 2: Parámetro de Línea de Comandos

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

Método 3: Configuración del Shell

# Añadir al archivo de configuración del Shell
eval "$(fnm env --use-on-cd --node-dist-mirror=https://npmmirror.com/mirrors/node)"

Fuentes de Mirror Comunes

Fuente de Mirror	URL	Descripción
Node.js Oficial	https://nodejs.org/dist	Predeterminado
npmmirror	https://npmmirror.com/mirrors/node	Recomendado
Universidad de Tsinghua	https://mirrors.tuna.tsinghua.edu.cn/nodejs-release	Optimizado para red educativa
Huawei Cloud	https://mirrors.huaweicloud.com/nodejs	Grado empresarial

Configuración Específica por Plataforma

Linux / macOS

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

Windows PowerShell

# Establecer variable de entorno de usuario
[Environment]::SetEnvironmentVariable("FNM_NODE_DIST_MIRROR", "https://npmmirror.com/mirrors/node", "User")

Windows CMD

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

Directorio de Descarga

Directorio Predeterminado

fnm descarga e instala Node.js en:

~/.fnm/
├── fnm                 # Binario de fnm
├── node-versions/      # Directorio de versiones de Node.js
│   ├── v20.10.0/
│   │   └── installation/
│   └── v18.19.0/
│       └── installation/
└── aliases/            # Configuración de alias

Directorio Personalizado

Personalizar mediante la variable de entorno FNM_DIR:

export FNM_DIR=/custom/path/.fnm

Instalación sin Conexión

Pre-descargar Versiones

Pre-descargar en un entorno con red:

fnm install 20
fnm install 18
fnm install 16

Copiar a Entorno sin Conexión

Copiar el directorio ~/.fnm al entorno sin conexión:

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

# Extraer en entorno sin conexión
tar -xzvf fnm-backup.tar.gz -C ~/

Instalación Manual

1. Descargar archivo de Node.js desde mirror
2. Extraer al directorio de fnm:

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

# Extraer al directorio de 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

Selección de Arquitectura

Ver Arquitectura Actual

fnm current
# La salida incluye información de arquitectura

Instalar Arquitectura Diferente

# Instalar versión x64
fnm install 20 --arch=x64

# Instalar versión ARM64
fnm install 20 --arch=arm64

Configuración de Variable de Entorno

export FNM_ARCH=x64
fnm install 20

Solución de Problemas de Descarga

Descarga Fallida

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

# Verificar conexión de red
curl -I https://nodejs.org/dist/

# Ver registros detallados
fnm install 20 --log-level=info

Descarga Lenta

1. Configurar mirror nacional
2. Verificar configuración de proxy de red
3. Usar método de instalación sin conexión

Checksum Fallido

# Limpiar caché y volver a descargar
rm -rf ~/.fnm/node-versions/v20.10.0
fnm install 20

Enlaces Relacionados

• Instalar Node.js - Guía de instalación
• Gestión de Versiones - Gestión de versiones
• Referencia de Comandos - Todos los detalles de comandos