Base de Conhecimento

Node-RED na VPS: como instalar e proteger o painel

  • node-red, vps, docker, adminauth, settings.js, systemd
  • Usuários acharam útil: 0

Aprenda a instalar o Node-RED 5 na VPS com o script oficial ou Docker, proteger o editor com adminAuth e hash de senha e configurar HTTPS com proxy reverso.

Por Redação Eleven Host · @robson.direitodigital · 3 de novembro de 2026 · 10 min de leitura

Arte da Eleven Host: janela de terminal com o título: Node-RED na VPS: como instalar e proteger o painel

Capa da Redação Eleven Host para o guia: Node-RED na VPS: como instalar e proteger o painel Arte: Eleven Host

Para colocar o Node-RED na VPS, instale-o com o script oficial para Debian e Ubuntu ou com Docker, ative a senha do editor com o adminAuth e só depois abra a porta 1880. Por padrão, o editor do Node-RED vem sem senha.

A documentação oficial diz que o editor não é protegido por padrão e que isso só serve numa rede confiável. O arquivo de configuração padrão aceita conexões em todas as interfaces IPv4. Na internet, quem chegar ao editor pode alterar e executar fluxos. Por isso a proteção do editor vem junto da instalação, antes de abrir a porta.

Se você ainda não conhece o servidor virtual, comece pelo guia O que é servidor VPS: guia simples para iniciantes. Os comandos abaixo são de terminal e os nomes de exemplo, como o do contêiner, são livres para você trocar.

O que é o Node-RED e qual versão usar

No site e no GitHub do projeto, o Node-RED se apresenta como “Low-code programming for event-driven applications”, ou seja, programação low-code para aplicações orientadas a eventos. A licença do repositório é a Apache 2.0.

A versão atual é a 5.x. A 5.0 saiu em 9 de junho de 2026, e a release mais nova no GitHub em 3 de novembro de 2026 é a 5.0.9, publicada em 21 de outubro. O plano de releases do projeto mostra que a 4.x está em manutenção desde 9 de junho de 2026 e chega ao fim de vida em 31 de dezembro de 2026. A 5.x é a série ativa do projeto.

O Node-RED 5 exige no mínimo o Node.js 22.9.0, e o projeto recomenda o Node.js 24.

A página de versões do Node-RED informa que o projeto não recomenda as versões ímpares do Node.js, porque não testa contra elas de forma rotineira. O blog do lançamento da 5.0 também avisa que o npm agora é uma dependência explícita.

Instalar com o script oficial

A documentação oferece um script para Debian e Ubuntu. Ele instala o Node.js, o npm e o Node-RED, remove um Node-RED já existente, garante uma versão mínima do Node.js e configura o Node-RED como serviço. Segundo a documentação, os comandos usam acesso root com sudo para instalar o Node-RED de forma global.

Se o npm precisar compilar módulos binários, a documentação indica instalar antes estas ferramentas:

sudo apt install build-essential git curl

Depois, o comando de instalação, copiado da página oficial:

bash <(curl -sL https://github.com/node-red/linux-installers/releases/latest/download/install-update-nodered-deb)

Para ler o conteúdo do script antes de rodar, ele está no repositório node-red/linux-installers, no GitHub. Para ver as opções, acrescente --help ao final do comando. O mesmo comando, rodado de novo, atualiza uma instalação existente quando sai uma versão nova.

Como o script instala uma versão de Node.js compatível, confira o resultado depois. Um exemplo de verificação:

node -v

node-red --version

Se você prefere o npm direto, a página “Running Node-RED locally” usa sudo npm install -g node-red. Esse caminho instala o Node-RED como módulo global. Para manter o Node-RED ativo como serviço num servidor, use o script ou o Docker.

Rodar como serviço e subir com o servidor

Com o script, o Node-RED vira um serviço do systemd. A página oficial traz estes comandos:

node-red-start

node-red-stop

sudo systemctl enable nodered.service

sudo systemctl disable nodered.service

O node-red-start inicia o serviço e mostra o log, e fechar a janela do terminal não para o serviço. O enable faz o Node-RED subir quando o servidor liga, e o disable desfaz isso. Para entender melhor esses comandos, veja systemctl: como iniciar, parar e ver serviços na VPS. Um exemplo para consultar o estado e o log:

systemctl status nodered

journalctl -u nodered -f

A documentação avisa que, fora do Raspberry Pi OS, pode ser preciso editar o arquivo de serviço para o usuário e o ambiente da sua máquina. Confira com que usuário o serviço está rodando antes de seguir.

A alternativa com Docker

A imagem oficial é a nodered/node-red. O comando da página oficial para rodar em segundo plano é este:

docker run -d -p 1880:1880 -v node_red_data:/data --name mynodered nodered/node-red

O -p 1880:1880 publica a porta do editor. O -v node_red_data:/data monta um volume chamado node_red_data na pasta /data do contêiner, e é isso que mantém os seus fluxos quando o contêiner é recriado. No Docker, o arquivo de configuração fica em /data/settings.js.

Outros comandos da mesma página:

docker attach mynodered

docker start mynodered

docker stop mynodered

docker cp mynodered:/data /your/backup/directory

Para atualizar, a página manda baixar a imagem nova, parar e remover o contêiner e criá-lo de novo com o mesmo volume (a página usa a forma com -it; aqui o último comando está em segundo plano, com -d):

docker pull nodered/node-red

docker stop mynodered

docker rm mynodered

docker run -d -p 1880:1880 -v node_red_data:/data --name mynodered nodered/node-red

Num servidor na internet, um exemplo de variação é publicar a porta só no endereço local e reiniciar o contêiner com o servidor, deixando um proxy na frente:

docker run -d -p 127.0.0.1:1880:1880 --restart unless-stopped -v node_red_data:/data --name mynodered nodered/node-red

Está escolhendo uma VPS? VPS a partir de R$ 17,00/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver os planos de VPS

A porta 1880 e o arquivo settings.js

A porta padrão do editor é a 1880, definida no settings.js pela linha uiPort: process.env.PORT || 1880,. Para abrir o editor, aponte o navegador para o endereço do servidor com :1880 no final.

Ao iniciar, o Node-RED procura o settings.js na pasta de usuário, ~/.node-red. Se não houver, copia um padrão. O argumento --settings aponta para outro arquivo. Um erro de sintaxe no arquivo impede o Node-RED de iniciar, então edite com cuidado. O arquivo é lido na partida, então reinicie depois de editar. Um exemplo com o serviço do systemd:

sudo systemctl restart nodered

O settings.js padrão traz esta linha comentada, para limitar o endereço em que o editor escuta:

//uiHost: "127.0.0.1",

Recomendamos descomentar essa linha quando houver um proxy reverso na mesma máquina. Assim, o editor só responde ao próprio servidor, e quem chega pela internet passa pelo proxy. Para ver o que está escutando em cada porta, use o guia Portas abertas no Linux: como ver com ss e lsof na VPS.

Proteger o editor com adminAuth

Esta é a etapa mais importante. No settings.js, descomente a propriedade adminAuth. O bloco da documentação tem este formato, e a senha é um hash bcrypt:

adminAuth: {

type: "credentials",

users: [

{

username: "admin",

password: "COLE_AQUI_O_HASH_GERADO",

permissions: "*"

}

]

}

Na documentação, a permissão * dá acesso total e read dá acesso só de leitura. Os hashes que aparecem na documentação são exemplos públicos: gere o seu e não copie o de lá. A partir do Node-RED 1.1.0, o comando é:

node-red admin hash-pw

O comando devolve o hash da senha que você digitar, para colar no settings.js. No Docker, um exemplo de como rodá-lo:

docker exec -it mynodered node-red admin hash-pw

Depois de salvar o arquivo, reinicie o Node-RED e abra o editor. Ele deve pedir usuário e senha. A sessão expira em um tempo que você ajusta com sessionExpiryTime, em segundos; a documentação usa sessionExpiryTime: 86400, como exemplo, que equivale a um dia.

Checklist de segurança do Node-RED

  • Ative o adminAuth com um hash gerado por você.
  • Defina o credentialSecret: por padrão, o arquivo de credenciais dos fluxos é cifrado com uma chave gerada pelo sistema, e a documentação sugere definir a sua.
  • Se os seus fluxos criam rotas HTTP, a opção httpNodeAuth usa o mesmo formato de hash para proteger essas rotas.
  • Com proxy na frente, escute só no endereço local com uiHost e não deixe a porta 1880 aberta para a internet.
  • Mantenha o Node-RED na versão 5.x atualizada.

HTTPS e proxy reverso

A documentação oficial trata do HTTPS pela opção https do settings.js, que vem comentada no arquivo padrão:

//https: {

// key: require("fs").readFileSync('privkey.pem'),

// cert: require("fs").readFileSync('cert.pem')

//},

O key é a chave privada em formato PEM e o cert é a cadeia do certificado em PEM. A opção httpsRefreshInterval recarrega o certificado de tempos em tempos. A versão 5.0 também aceita certificados em arquivo PFX/P12 ou em variáveis de ambiente, segundo o blog do lançamento.

Outra forma é terminar o HTTPS num proxy reverso, deixando o Node-RED só no endereço local. Um exemplo de configuração do Nginx para esse caso, montado por nós e que não vem da documentação do Node-RED (o editor usa WebSocket, por isso as linhas Upgrade e Connection):

location / {

proxy_pass http://127.0.0.1:1880;

proxy_http_version 1.1;

proxy_set_header Upgrade $http_upgrade;

proxy_set_header Connection "upgrade";

proxy_set_header Host $host;

}

O certificado desse domínio pode ser emitido com o Certbot. Se você prefere não deixar o editor exposto de jeito nenhum, uma alternativa é acessá-lo por VPN, como no guia WireGuard na VPS: como criar sua própria VPN.

Atualizar o Node-RED

A forma de atualizar depende de como você instalou. Com o script, rode o mesmo comando de novo. Com o npm global, rode sudo npm install -g node-red. Com Docker, siga os passos da seção anterior. No anúncio de 30 de julho de 2026, o projeto informou que as versões 5.0.2 e 4.1.12 traziam uma correção de segurança importante, além da atualização de dependências.

Recomendamos copiar a pasta ~/.node-red (fluxos, credenciais e settings.js) antes de atualizar. Se você sai da 4.x para a 5.x, confira antes se o Node.js é o 22.9.0 ou mais novo.

Comandos do dia a dia em resumo

Uma lista rápida do que você vai usar com mais frequência no Node-RED instalado pelo script:

  • node-red-start e node-red-stop: iniciam e param o serviço.
  • sudo systemctl enable nodered.service: liga o Node-RED junto com o servidor.
  • node-red admin hash-pw: gera o hash da senha do editor.
  • sudo systemctl restart nodered: reinicia depois de editar o settings.js.

Quer comparar os planos de VPS? VPS a partir de R$ 17,00/mês no Plano Bronze; confira na loja o que cada plano inclui. Comparar planos

Perguntas frequentes

O Node-RED na VPS vem com senha?

Não. Por padrão, o editor não é protegido. Ative o adminAuth no settings.js antes de deixá-lo acessível pela internet.

Qual porta o Node-RED usa?

A 1880 por padrão, definida pela linha uiPort do settings.js.

Qual versão do Node.js o Node-RED 5 exige?

No mínimo o Node.js 22.9.0. O projeto recomenda o Node.js 24.

Como gerar a senha do adminAuth?

Rode node-red admin hash-pw, digite a senha e cole o hash no campo password do usuário no settings.js.

Dá para usar o Node-RED com Docker?

Dá. A imagem oficial é a nodered/node-red, com um volume em /data para guardar os fluxos.

Esta resposta lhe foi útil?

Artigos Relacionados