Pular para o conteúdo
Documentação

Apps Node.js

Como publicar e operar uma aplicação Node.js num domínio: start, porta, variáveis de ambiente, logs, reinício e conversão de/para PHP.

R Regis Manze 20/11/2026 4 min de leitura

Um domínio do tipo Node.js encaminha as requisições para uma aplicação que roda no próprio servidor. O painel cria o proxy (com suporte a WebSocket) e um serviço que inicia a app no boot e a reinicia se ela cair.

Como a app precisa funcionar

  • Escutar na porta da variável PORT.
  • Escutar no endereço da variável HOST (127.0.0.1).
  • Ficar na pasta do document root do domínio.

O painel define PORT, HOST e NODE_ENV sozinho. A app roda com o usuário dono do domínio.

Exemplo mínimo:

const http = require('http');
http.createServer((req, res) => res.end('ok'))
    .listen(process.env.PORT, process.env.HOST);

Criar uma app Node.js

  1. Acesse Hospedagem > Dominios e clique em Novo Dominio.
  2. Em Tipo de aplicacao, escolha Node.js.
  3. Preencha Dominio, Usuario e Document Root.
  4. Preencha os campos da app (tabela abaixo) e clique em Criar.
  5. Envie o código para o document root.
  6. Instale as dependências e reinicie a app (pelo Deploy ou pelo terminal do cliente).
Campo O que informar
Comando de start Ex.: npm start, node dist/main.js, npx next start.
Porta De 3000 a 3999, livre. Vazio = próxima livre.
NODE_ENV Padrão production.
Binario do Node Opcional. Caminho absoluto de outra versão do Node. O npm da mesma pasta entra no PATH.

Dica: para usar uma versão específica, instale o Node com nvm na conta do cliente e informe o caminho, ex.: /home/cliente/.nvm/versions/node/v20.18.0/bin/node.

Painel da app

Clique no botão Node :porta na coluna PHP, ou no ícone JS da linha. A janela App Node.js mostra:

  • Status: rodando, rodando mas porta sem resposta, ou parada. Também PID, porta, memória, quantidade de reinícios e horário de início.
  • Botões Iniciar, Reiniciar e Parar.
  • Logs em duas abas: Saida e Erros (últimas 120 linhas). Clique na seta circular para atualizar.

Os logs ficam na pasta de logs da conta, fora da home:

/var/log/minicp/users/cliente/node-exemplo.com.br.log
/var/log/minicp/users/cliente/node-exemplo.com.br-error.log

O cliente lê os mesmos arquivos pelos atalhos /home/cliente/logs/node-exemplo.com.br.log e node-exemplo.com.br-error.log, mas não consegue apagá-los nem gravar neles.

Dica: o status "rodando, mas porta sem resposta" quase sempre indica que a app escuta em outra porta. Confira se o código usa process.env.PORT.

Alterar a configuração

  1. Abra o painel da app.
  2. Ajuste Comando de start, Porta, NODE_ENV ou Binario do Node.
  3. Em Variaveis de ambiente, informe uma por linha no formato CHAVE=valor. Linhas iniciadas por # são ignoradas.
  4. Clique em Salvar e reiniciar.
DATABASE_URL=mysql://usuario:senha@localhost/banco
REDIS_URL=redis://127.0.0.1:6379

PORT, HOST e NODE_ENV informadas aqui são ignoradas: valem os campos próprios. As variáveis ficam num arquivo protegido que outros usuários do servidor não leem.

Se o binário do Node configurado não existir no servidor, o painel avisa em vermelho abaixo do campo.

Converter entre PHP e Node.js

De PHP para Node.js:

  1. Na linha do domínio PHP, clique em Converter para app Node.js.
  2. Preencha os campos e clique em Salvar e reiniciar.

O vhost deixa de servir PHP e passa a fazer proxy para a app, usando o document root atual.

De Node.js para PHP:

  1. Abra o painel da app.
  2. Clique em Voltar para PHP e confirme.

A app é parada, o serviço é removido e o site volta a usar o PHP-FPM da conta.

Desativar e remover

  • Desativar o domínio para a app e a mantém parada até reativar.
  • Remover o domínio para a app e apaga o serviço. O código continua na home do cliente.

Atenção: o staging ainda não funciona com apps Node.js, porque a cópia disputaria a mesma porta.

Copiar para usar com IA

Este artigo foi útil?

Que bom! O que ajudou mais? O que faltou nesta página?

Opcional — seu voto já foi registrado.

Obrigado pelo seu feedback!