Skip to content

Instalar fnm no Linux

fnm tem múltiplos métodos de instalação no Linux. Este guia ajudará você a instalar fnm em várias distribuições Linux.

Métodos de Instalação

Usando Script curl (Recomendado)

O método de instalação mais simples:

bash
curl -fsSL https://fnm.vercel.app/install | bash

Após a instalação, siga as instruções para recarregar o Shell ou adicione manualmente ao PATH:

bash
export PATH="$HOME/.fnm:$PATH"
eval "$(fnm env --use-on-cd)"

Usando Homebrew

Se você tem Homebrew instalado no Linux:

bash
brew install fnm

Download Manual

  1. Visite a página de Releases do fnm
  2. Baixe o arquivo para sua arquitetura:
bash
# x86_64
wget https://github.com/Schniz/fnm/releases/latest/download/fnm-linux.zip

# ARM64
wget https://github.com/Schniz/fnm/releases/latest/download/fnm-arm64.zip
  1. Extraia e instale:
bash
unzip fnm-linux.zip -d ~/.local/bin
chmod +x ~/.local/bin/fnm

Guia de Instalação Específico da Distribuição

Ubuntu / Debian

bash
# Método 1: Usando script curl
curl -fsSL https://fnm.vercel.app/install | bash

# Método 2: Instalação manual
sudo apt update
sudo apt install -y unzip
wget https://github.com/Schniz/fnm/releases/latest/download/fnm-linux.zip
sudo unzip fnm-linux.zip -d /usr/local/bin
sudo chmod +x /usr/local/bin/fnm

CentOS / RHEL / Fedora

bash
# Instalar dependências
sudo dnf install -y unzip  # Fedora
# ou
sudo yum install -y unzip  # CentOS/RHEL

# Usando script curl
curl -fsSL https://fnm.vercel.app/install | bash

# Ou instalação manual
wget https://github.com/Schniz/fnm/releases/latest/download/fnm-linux.zip
sudo unzip fnm-linux.zip -d /usr/local/bin
sudo chmod +x /usr/local/bin/fnm

Arch Linux

bash
# Usando helper AUR
yay -S fnm-bin

# Ou compilar do AUR
git clone https://aur.archlinux.org/fnm-bin.git
cd fnm-bin
makepkg -si

Alpine Linux

bash
# Instalar dependências
apk add bash curl unzip

# Usando script curl
curl -fsSL https://fnm.vercel.app/install | bash

# Ou instalação manual
wget https://github.com/Schniz/fnm/releases/latest/download/fnm-linux.zip
unzip fnm-linux.zip -d ~/.local/bin
chmod +x ~/.local/bin/fnm

Configurar Shell

Bash

Editar ~/.bashrc:

bash
echo 'eval "$(fnm env --use-on-cd)"' >> ~/.bashrc
source ~/.bashrc

Zsh

Editar ~/.zshrc:

bash
echo 'eval "$(fnm env --use-on-cd)"' >> ~/.zshrc
source ~/.zshrc

Fish

Editar ~/.config/fish/config.fish:

fish
echo 'fnm env --use-on-c | source' >> ~/.config/fish/config.fish
source ~/.config/fish/config.fish

Conclusão do Shell

Conclusão Bash

bash
# Instalar bash-completion (se não estiver instalado)
sudo apt install bash-completion  # Debian/Ubuntu
sudo dnf install bash-completion  # Fedora

# Adicionar script de conclusão
fnm completions --shell bash >> ~/.bashrc
source ~/.bashrc

Conclusão Zsh

bash
# Criar diretório de conclusão
mkdir -p ~/.zsh/completions

# Gerar script de conclusão
fnm completions --shell zsh > ~/.zsh/completions/_fnm

# Adicionar ao ~/.zshrc
fpath=(~/.zsh/completions $fpath)
autoload -U compinit && compinit

Conclusão Fish

bash
fnm completions --shell fish > ~/.config/fish/completions/fnm.fish

Usando Mirror na China

Na China continental, é recomendado configurar um mirror para acelerar downloads:

bash
# Adicionar ao arquivo de configuração do Shell
export FNM_NODE_DIST_MIRROR=https://npmmirror.com/mirrors/node

# Ou especificar durante eval
eval "$(fnm env --use-on-cd --node-dist-mirror=https://npmmirror.com/mirrors/node)"

Mirrors comuns:

Fonte do MirrorURL
npmmirrorhttps://npmmirror.com/mirrors/node
Universidade de Tsinghuahttps://mirrors.tuna.tsinghua.edu.cn/nodejs-release
Huawei Cloudhttps://mirrors.huaweicloud.com/nodejs

Verificar Instalação

bash
# Verificar versão fnm
fnm --version

# Instalar Node.js
fnm install --lts

# Verificar Node.js
node --version
npm --version

Problemas Comuns

Comando Não Encontrado

bash
# Verificar se fnm está no PATH
which fnm

# Adicionar manualmente ao PATH
export PATH="$HOME/.fnm:$PATH"

# Adicionar permanentemente ao PATH
echo 'export PATH="$HOME/.fnm:$PATH"' >> ~/.bashrc

Problemas de Permissão

bash
# Garantir que fnm tenha permissão de execução
chmod +x ~/.fnm/fnm
# ou
chmod +x /usr/local/bin/fnm

Download Falhou

bash
# Usar mirror
export FNM_NODE_DIST_MIRROR=https://npmmirror.com/mirrors/node
fnm install --lts

Próximos Passos

Após a instalação, você pode: