Hospedar uma aplicação Node.js no cPanel pode parecer um desafio à primeira vista, mas com as ferramentas e conhecimentos certos, o processo é simples e eficiente. Neste guia, você aprenderá o passo a passo de como configurar sua aplicação Node.js no cPanel de maneira profissional, permitindo que ela fique online e acessível para o mundo.
Pré-requisitos
Antes de começarmos, verifique se você possui:
- Acesso ao cPanel do seu servidor.
- Sua aplicação Node.js pronta para ser hospedada (certifique-se de que funciona localmente).
- Uma versão recente do Node.js instalada no servidor (veremos como configurar isso no cPanel).
Esses requisitos são essenciais para que a hospedagem seja efetuada.
Passo 1: Configurando o Ambiente Node.js no cPanel
1.1: Acessando o Gerenciador de Aplicações Node.js
- Faça login no cPanel.
- Procure pela seção Software e clique em Setup Node.js App (ou algo semelhante, dependendo do tema do cPanel).
1.2: Criando um Novo Ambiente
- Clique no botão Create Application.
- Preencha as informações solicitadas:
- Application Mode: Selecione
Production(para um ambiente de produção). - Node.js Version: Escolha a versão do Node.js que sua aplicação suporta.
- Application Root: Indique o diretório onde sua aplicação está armazenada. Por exemplo:
myapp. - Application URL: Defina a URL pela qual sua aplicação será acessada.
- Application Startup File: Insira o nome do arquivo de entrada da sua aplicação, geralmente
app.jsouserver.js.
- Application Mode: Selecione
- Clique em Create para criar o ambiente.
Passo 2: Subindo os Arquivos da Aplicação
2.1: Upload via Gerenciador de Arquivos
- No cPanel, vá até Gerenciador de Arquivos.
- Navegue até o diretório definido como Application Root.
- Faça o upload dos arquivos da sua aplicação (pode ser um arquivo
.zipcom tudo compactado). - Extraia os arquivos diretamente no servidor.
2.2: Upload via FTP
- Use um cliente FTP, como FileZilla, para se conectar ao servidor.
- Envie os arquivos para o diretório correspondente ao Application Root.
Passo 3: Instalando Dependências
- Volte ao Setup Node.js App no cPanel.
- Clique em Edit ao lado da sua aplicação.
- Role até a seção Actions e clique em Run NPM Install.
- Isso instalará todas as dependências listadas no seu arquivo
package.json.
- Isso instalará todas as dependências listadas no seu arquivo
Passo 4: Configurando Variáveis de Ambiente
- Ainda na tela de edição da aplicação, localize a seção de Environment Variables.
- Adicione as variáveis necessárias para o funcionamento da sua aplicação, como:
PORT: Porta que sua aplicação usará (ex.: 3000).- Outras variáveis como
DATABASE_URL,API_KEY, etc.
- Clique em Apply para salvar as alterações.
Passo 5: Testando e Iniciando a Aplicação
- No Setup Node.js App, clique no botão Run Application.
- Verifique se a URL definida na configuração está funcionando.
- Caso encontre erros, revise os logs:
- Os logs estão disponíveis no mesmo painel, na seção Application Logs.
Passo 6: Configurando o Proxy (opcional, mas recomendado)
Para acessar sua aplicação sem especificar uma porta, configure um proxy HTTP:
- Vá até a configuração do Gerenciador de Domínios no cPanel.
- Crie uma entrada que direcione o tráfego da URL principal (ex.:
https://meusite.com) para o endereço da aplicação Node.js.
Parabéns! Sua aplicação Node.js está configurada e funcionando no cPanel. Hospedar no cPanel pode ser um pouco diferente de ambientes como Docker ou VPS, mas com essas etapas você tem uma maneira prática de gerenciar sua aplicação em servidores compartilhados.
Se você está procurando uma solução para realizar suas hospedagens de forma prática e de confiança, a master da web oferece planos para hospedagem com suporte para cPanel, e um ambiente otimizado para node.JS. Experimente e descubra como é fácil obter uma hospedagem segura e eficiente.
Deseja ter acesso à mais tutoriais como esse? Confira nosso blog ou canal do youtube para mais informações e dicas como essa!
