Base de Conhecimento

Como executar um aplicativo Node.js no cPanel

O recurso Setup Node.js App permite criar e executar uma aplicação Node.js diretamente pelo cPanel, sem necessidade de publicar apenas arquivos estáticos.

Se esse ícone não aparecer no seu cPanel, isso normalmente indica que o recurso não está habilitado no ambiente ou que o servidor não está utilizando a configuração necessária para esse tipo de aplicação.

Antes de começar

Antes de criar a aplicação, recomendamos ter já preparado:

Os arquivos da aplicação Node.js
O arquivo inicial da aplicação
O caminho em que a aplicação será instalada
O domínio, subdomínio ou URL que será usada para acesso

O ideal é já saber em qual pasta a aplicação ficará e qual será o arquivo principal de inicialização.

Passo 1 – Acesse o cPanel

Entre normalmente no cPanel da hospedagem com seu usuário e senha.

Passo 2 – Abra o menu Setup Node.js App

Dentro do cPanel, localize o ícone:

Setup Node.js App

Clique nessa opção para abrir a área de gerenciamento das aplicações Node.js.

Nessa tela, você poderá criar uma nova aplicação, visualizar aplicações existentes e administrar o funcionamento delas.

Passo 3 – Clique para criar uma nova aplicação

Dentro da interface, clique na opção para criar uma nova aplicação.

O sistema exibirá um formulário com os principais dados necessários para configurar o ambiente da aplicação.

Passo 4 – Escolha a versão do Node.js

Selecione a versão do Node.js desejada entre as opções disponíveis no servidor.

Sempre que possível, escolha uma versão compatível com a aplicação que será publicada. Se o projeto exigir uma versão específica, use exatamente a versão recomendada pelo desenvolvedor.

Passo 5 – Defina o modo da aplicação

Em seguida, escolha o ambiente de execução da aplicação.

Normalmente, as opções costumam seguir a lógica de:

Development para desenvolvimento e testes
Production para ambiente de produção

Para sites e sistemas já em uso real, normalmente o mais adequado é utilizar o modo de produção.

Passo 6 – Informe o caminho da aplicação

Defina a pasta em que a aplicação ficará hospedada dentro da sua conta.

Esse caminho representa o local onde estarão os arquivos do projeto Node.js.

Escolha esse diretório com atenção e mantenha a estrutura da aplicação organizada, especialmente se houver mais de um projeto na conta.

Passo 7 – Defina a URL de acesso

Depois disso, selecione o domínio, subdomínio ou caminho de URL que será usado para acessar a aplicação.

Dependendo da estrutura da conta, você poderá publicar a aplicação em:

Um domínio principal
Um subdomínio
Uma subpasta específica

Essa configuração define onde a aplicação responderá publicamente.

Passo 8 – Informe o arquivo de inicialização

No campo referente ao arquivo de startup, informe o nome do arquivo principal da aplicação.

Esse é o arquivo que será usado para iniciar o aplicativo Node.js.

Exemplos comuns

app.js
server.js
index.js

O nome deve corresponder exatamente ao arquivo real existente dentro da pasta da aplicação.

Passo 9 – Crie a aplicação

Após preencher os campos, clique no botão para criar a aplicação.

Com isso, o cPanel montará o ambiente inicial necessário para a execução do aplicativo Node.js.

Passo 10 – Envie os arquivos da aplicação

Depois da criação, envie os arquivos do projeto para a pasta definida anteriormente.

Isso pode ser feito por:

Gerenciador de Arquivos do cPanel
FTP
SFTP
Git, quando aplicável

Verifique se todos os arquivos necessários do projeto foram enviados corretamente, incluindo os arquivos de configuração e dependências exigidas pela aplicação.

Passo 11 – Instale as dependências

Após publicar os arquivos, normalmente será necessário instalar as dependências da aplicação.

Em muitos casos, isso envolve a execução do processo equivalente ao:

npm install

Dependendo da interface disponível no ambiente, isso pode ser feito pela própria área da aplicação ou por terminal, quando o plano disponibiliza esse recurso.

Passo 12 – Inicie ou reinicie a aplicação

Depois de instalar os arquivos e dependências, utilize a interface da aplicação no cPanel para iniciar, parar ou reiniciar o projeto.

Sempre que houver alteração importante no código ou nas dependências, pode ser necessário reiniciar a aplicação para carregar as mudanças.

Como testar se a aplicação está funcionando

Após concluir a configuração, acesse a URL definida na criação da aplicação e verifique se ela responde corretamente.

Também vale conferir:

Se a rota principal abre normalmente
Se não há erro interno na aplicação
Se os arquivos foram enviados para o diretório correto
Se o arquivo inicial informado está certo

Caso a aplicação não abra, revise principalmente a versão do Node.js, o caminho configurado, o arquivo de startup e a instalação das dependências.

Importante

Em ambientes cPanel, dependendo da configuração do servidor, o gerenciamento de aplicações pode usar recursos ligados ao Passenger e ao Application Manager, o que influencia a forma como a aplicação é publicada e executada.

Além disso, aplicações novas costumam usar a versão mais recente do Node.js instalada no servidor, a menos que o ambiente permita seleção específica na interface disponível.

Resumo

Para executar um aplicativo Node.js no cPanel:

1. Acesse Setup Node.js App
2. Crie uma nova aplicação
3. Escolha a versão do Node.js
4. Defina modo, pasta, URL e arquivo de inicialização
5. Envie os arquivos do projeto
6. Instale as dependências
7. Inicie ou reinicie a aplicação

Caso tenha dúvidas sobre a configuração da aplicação, dependências ou arquivo de inicialização, abra um ticket de suporte para que possamos orientar.

Atenciosamente,
MyWay Hosting
www.myway.com.br

0 Usuários acharam útil