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
- Acesse Hospedagem > Dominios e clique em Novo Dominio.
- Em Tipo de aplicacao, escolha Node.js.
- Preencha Dominio, Usuario e Document Root.
- Preencha os campos da app (tabela abaixo) e clique em Criar.
- Envie o código para o document root.
- 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
- Abra o painel da app.
- Ajuste Comando de start, Porta, NODE_ENV ou Binario do Node.
- Em Variaveis de ambiente, informe uma por linha no formato
CHAVE=valor. Linhas iniciadas por#são ignoradas. - 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:
- Na linha do domínio PHP, clique em Converter para app Node.js.
- 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:
- Abra o painel da app.
- 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.