Como instalar o Node.js no Debian 10

Introdução

O Node.js é um tempo de execução JavaScript para programação do lado do servidor. Ele permite que os desenvolvedores criem funcionalidades de backend escaláveis usando JavaScript, uma linguagem com a qual muitos já estão familiarizados no desenvolvimento web baseado em navegador.

Neste guia, você aprenderá como instalar o Node.js em um servidor Debian 10 de três maneiras diferentes:

• Usando o repositório padrão do Debian
• Usando um repositório de software PPA
• Usando o NVM (Node Version Manager) para instalar e ativar diferentes versões do Node.

Para muitos usuários, usar o apt com o repositório padrão será suficiente. Se você precisar de versões específicas mais recentes (ou antigas) do Node, você deve usar o repositório PPA. Se você está desenvolvendo ativamente aplicações Node e precisa alternar entre versões com frequência, escolha o método NVM.

Pré-requisitos

Antes de começar, você deve ter um usuário não-root com privilégios de sudo configurado em seu sistema. Você pode aprender como configurar isso seguindo o tutorial de configuração inicial do servidor Debian 10.

Instalando o Node.js com Apt a partir dos Repositórios Padrão

O Debian contém uma versão do Node.js em seus repositórios padrão que pode ser usada para fornecer uma experiência consistente em vários sistemas. No momento da escrita, a versão nos repositórios é 10.24.0. Esta pode não ser a versão mais recente, mas deve ser estável e suficiente para experimentações rápidas com a linguagem.

Para obter o Node.js do repositório de software padrão do Debian, você pode usar o gerenciador de pacotes apt. Primeiro, atualize o índice local de pacotes:

sudo apt update

Em seguida, instale o pacote Node.js:

sudo apt install nodejs

Para verificar se a instalação foi bem-sucedida, execute o comando node com a flag -v para obter a versão:

node -v

Output
v10.24.0

Se o pacote nos repositórios atender às suas necessidades, isso é tudo o que você precisa fazer para configurar o Node.js. Na maioria dos casos, você também vai querer instalar o npm, o gerenciador de pacotes do Node.js. Você pode fazer isso instalando o pacote npm com o apt:

sudo apt install npm

Isso permitirá que você instale módulos e pacotes para usar com o Node.js.

Neste ponto, você instalou com sucesso o Node.js e npm usando apt e os repositórios de software padrão do Ubuntu. A próxima seção mostrará como usar um repositório alternativo para instalar diferentes versões do Node.js.

Instalando o Node.js com Apt Usando um PPA do NodeSource

Para trabalhar com uma versão mais recente do Node.js, você pode instalar a partir de um PPA (arquivo de pacote pessoal) mantido pela NodeSource. Este é um repositório alternativo que ainda funciona com apt, e terá versões mais atualizadas do Node.js do que os repositórios oficiais do Debian. A NodeSource tem PPAs disponíveis para várias versões do Node. Consulte a documentação da NodeSource para obter mais informações sobre as versões disponíveis.

A partir do seu diretório home, use curl para recuperar o script de instalação para a sua versão preferida do Node.js. Se você não tiver o curl instalado, pode instalá-lo antes de prosseguir para o próximo passo com este comando:

sudo apt install curl

Com o curl instalado, você pode iniciar sua instalação do Node.js. Este exemplo instala a versão 16.x. Você pode substituir 16.x pela sua versão preferida.

curl -fsSL https://deb.nodesource.com/setup_16.x | sudo -E bash -
sudo apt install nodejs

Não é necessário instalar um pacote separado para npm neste caso, pois ele está incluído no pacote nodejs.

Verifique a instalação executando node com a opção de versão -v:

node -v

Output
v16.14.2

npm usa um arquivo de configuração em seu diretório home para acompanhar as atualizações. Ele será criado na primeira vez que você executar npm. Execute este comando para verificar se npm está instalado:

npm -v

Output
8.5.0

Instalando o Node Usando o Gerenciador de Versões do Node

Uma alternativa para instalar o Node.js através do apt é usar uma ferramenta chamada nvm, que significa “Node Version Manager”. Em vez de trabalhar no nível do sistema operacional, o nvm funciona no nível de um diretório independente dentro do diretório home do seu usuário. Isso significa que você pode instalar várias versões autocontidas do Node.js sem afetar todo o sistema.

Controlar seu ambiente com o nvm permite que você acesse as versões mais recentes do Node.js, ao mesmo tempo em que mantém e gerencia versões anteriores. No entanto, é uma utilidade diferente do apt, e as versões do Node.js que você gerencia com ela são distintas daquelas que você gerencia com o apt.

Para instalar o nvm no Debian 10, siga as instruções de instalação no arquivo README do repositório NVM no Github.

A URL pode mudar dependendo da última versão do nvm, mas até o momento desta escrita, o script pode ser baixado e executado digitando:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash

Isso irá instalar o script nvm na sua conta de usuário. Para usá-lo, você deve primeiro carregar o seu arquivo .bashrc. Isso permite que você execute o código:

source ~/.bashrc

Agora, você pode listar as versões disponíveis do Node usando o nvm:

nvm list-remote

Este comando irá produzir uma saída longa:

Output
...
       v15.11.0
       v15.12.0
       v15.13.0
       v15.14.0
        v16.0.0
        v16.1.0
        v16.2.0
        v16.3.0
        v16.4.0
        v16.4.1
        v16.4.2
        v16.5.0
        v16.6.0
        v16.6.1
        v16.6.2
        v16.7.0
        v16.8.0
        v16.9.0
        v16.9.1
       v16.10.0
       v16.11.0
       v16.11.1
       v16.12.0
       v16.13.0   (LTS: Gallium)
       v16.13.1   (LTS: Gallium)
       v16.13.2   (LTS: Gallium)
       v16.14.0   (LTS: Gallium)
       v16.14.1   (LTS: Gallium)
       v16.14.2   (Latest LTS: Gallium)
        v17.0.0
        v17.0.1
...

Você pode instalar uma versão do Node digitando qualquer uma das versões de lançamento que você vê. Por exemplo, para instalar a versão v14.10.0, você pode digitar:

nvm install v14.10.0

Você pode visualizar as diferentes versões que você instalou digitando:

nvm ls

Output
->     v14.10.0
         system
default -> v14.10.0
iojs -> N/A (default)
unstable -> N/A (default)
node -> stable (-> v14.10.0) (default)
stable -> 14.10 (-> v14.10.0) (default)
...

Isto mostra a versão atualmente ativa na primeira linha (-> v14.10.0), seguida por alguns aliases nomeados e as versões para as quais esses aliases apontam.

Além disso, esta saída lista aliases para as várias versões de suporte de longo prazo (LTS) do Node:

Output
. . .
lts/* -> lts/fermium (-> N/A)
lts/argon -> v4.9.1 (-> N/A)
lts/boron -> v6.17.1 (-> N/A)
lts/carbon -> v8.17.0 (-> N/A)
lts/dubnium -> v10.24.1 (-> N/A)
lts/erbium -> v12.22.11 (-> N/A)
lts/fermium -> v14.19.1 (-> N/A)
lts/gallium -> v16.14.2 (-> N/A)

Nós podemos instalar um lançamento baseado nesses aliases também. Por exemplo, para instalar a versão de suporte de longo prazo mais recente, gallium, execute o seguinte:

nvm install lts/gallium

Output
Downloading and installing node v16.14.2...
...
Now using node v16.14.2 (npm v8.5.0)

Você pode verificar se a instalação foi bem-sucedida digitando:

node -v

Output
v16.14.2

Se desejar usar uma versão específica do Node como padrão, digite o seguinte com a versão de sua escolha:

nvm alias default 14.10.0

Esta versão será automaticamente selecionada quando você iniciar uma nova sessão no Node. Você também pode referenciá-la pelo alias assim:

nvm use default

Output
Now using node v14.10.0 (npm v6.14.8)

Cada versão do Node.js manterá o controle de seus próprios pacotes e tem o npm disponível para gerenciá-los.

Removendo o Node.js

Você pode desinstalar o Node.js usando o apt ou o nvm, dependendo da versão que deseja direcionar. Para remover versões instaladas do repositório Debian ou do PPA, você precisará trabalhar com a utilidade apt no nível do sistema.

Para remover qualquer uma dessas versões, digite o seguinte:

sudo apt remove nodejs

Este comando removerá o pacote e os arquivos de configuração.

Para desinstalar uma versão do Node.js que você habilitou usando o nvm, primeiro determine se a versão que você deseja remover é a versão ativa atual:

nvm current

Output
v16.14.2

Se a versão que você está direcionando não é a versão ativa atual, você pode executar este comando com a versão que deseja remover:

nvm uninstall node_version_to_remove

Este comando desinstalará a versão selecionada do Node.js.

Se a versão que você gostaria de remover é a versão ativa atual, você deve primeiro desativar nvm para permitir suas alterações:

nvm deactivate

Agora você pode desinstalar a versão atual usando o comando nvm uninstall com sua versão atual do Node.js.

nvm uninstall current_node_version

Isso removerá todos os arquivos associados à versão específica do Node.js, exceto os arquivos em cache que podem ser usados para reinstalação.

Conclusão

Há várias maneiras de começar a usar o Node.js em seu servidor Debian 10. Suas circunstâncias irão ditar qual dos métodos acima é melhor para suas necessidades. Enquanto usar a versão empacotada no repositório do Debian é uma opção para experimentação, instalar a partir de um PPA e trabalhar com um PPA da NodeSource ou nvm oferece flexibilidade adicional.

Para mais informações sobre programação com Node.js, consulte nossa série de tutoriais Como Programar em Node.js.